# 워크스페이스

> 에이전트가 파일을 두고 명령을 실행하는 전용 머신 — 필요할 때 준비되고, 쓰는 일은 전부 승인을 거칩니다.

**워크스페이스**는 에이전트 하나에 속한 샌드박스입니다. 읽고 쓸 수 있는 파일 시스템과 명령을 실행할 셸이죠. 무언가를 둘 자리가 필요한 일 — 코드를 받아오고, 데이터로 보고서를 만들고, 대화 사이에 작업 디렉토리를 유지하는 일 — 을 에이전트가 해내는 방식입니다.

## 언제 생기는가

미리 만들지 않습니다. 머신이 필요한 일을 시키면 에이전트가 준비하고, 그 과정을 대화에서 알려줍니다. 처음 한 번은 준비에 잠깐 걸리고, 그다음부터는 같은 워크스페이스가 다음 대화에도 그대로 있습니다.

채팅이 준비 과정을 별도 단계로 보여주므로, 첫 실행이 느린 것이 영문 모를 일이 아니라 읽히는 일이 됩니다.

## 에이전트가 그 안에서 할 수 있는 일

파일과 디렉토리를 읽고, 쓰고, 옮기고, 명령을 실행합니다.

<Aside type="caution" title="쓰기와 실행은 항상 묻습니다">
  읽기는 자유입니다. 워크스페이스를 바꾸는 모든 것 — 쓰기·이동·복사·삭제·명령 실행과 중지 —
  은 먼저 [승인](/ko/docs/work/approvals/)을 위해 멈추고 어떤 작업인지 그대로 보여줍니다. 이것을 끄는
  설정은 없고, 지켜보는 사람이 없는 실행은 그런 작업을 기다리는 대신 거절합니다.
</Aside>

## 안을 들여다보기

[에이전트 빌더](/ko/docs/build/agent-builder/)의 워크스페이스 섹션이 안에 무엇이 있는지 보여줍니다. 파일 트리, 파일 내용, 그리고 지금 돌고 있는 프로세스입니다.

이 화면은 **의도적으로 읽기 전용**입니다. 워크스페이스를 바꾸는 유일한 길은 에이전트에게 부탁하고 그 제안을 승인하는 것입니다 — 쓰기까지 되는 브라우저는 승인 관문을 우회하는 문이 됩니다.

화면은 스스로 새로고침하지 않습니다. 파일을 바꾸는 것이 사용자가 아니라 에이전트라서, 언제 바뀌는지는 화면이 알 수 없기 때문입니다. 현재 상태가 필요하면 새로고침하세요.

<Screenshot
  name="studio-workspace"
  alt="워크스페이스 섹션 — 연결된 워크스페이스 에이전트의 상태와, 그 아래 data 디렉토리가 펼쳐진 파일 트리."
  caption="트리는 읽기 전용이다. 쓰는 일은 전부 대화 안의 승인을 거친다."
/>

## 한계

- 에이전트당 워크스페이스 하나.
- 사용자 컴퓨터가 아니라 Endue 인프라의 머신입니다. 내 파일을 다루는 일은 [디바이스](/ko/docs/build/devices/)와 데스크톱 앱의 로컬 런타임을 보세요.
- 워크스페이스가 오프라인이면 패널이 그렇게 알려줍니다. 그것이 필요한 일을 시키면 다시 올라옵니다.
- 브라우저는 목록과 읽기만 합니다. 업로드·편집·삭제는 하지 않습니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="승인"
    href="/ko/docs/work/approvals/"
    description="모든 쓰기와 명령이 지나는 관문."
  />
  <LinkCard
    title="아티팩트"
    href="/ko/docs/capabilities/artifacts/"
    description="남길 만해진 결과물이 가야 할 곳."
  />
  <LinkCard
    title="디바이스"
    href="/ko/docs/build/devices/"
    description="또 다른 종류의 머신 — 내 컴퓨터."
  />
</CardGrid>