# 아티팩트

> 에이전트가 만든 문서 · 보고서 · 파일 — 어디에 있고, 어떻게 읽고 내보내며, 링크 공유는 어떻게 동작하는가.

**아티팩트**는 에이전트가 만든 것 중 남겨둘 만한 것입니다. 보고서, 문서, 데이터셋, 다이어그램 같은 것들이죠. 대화 기록 속에 묻히는 대신 자기 페이지를 갖습니다.

## 언제 생기는가

에이전트가 판단합니다. 분량이 있는 것을 요청하면 — *"조사 결과를 정리해줘"*, *"주간 요약을 만들어줘"* — 결과를 아티팩트로 저장하고 대화에 링크합니다. 직접 시켜도 됩니다. *"그거 아티팩트로 저장해줘"* 처럼요.

짧은 답은 대화에 남습니다. 그게 맞는 기본값입니다. 아티팩트는 다시 찾아올 산출물을 위한 것입니다.

## 다루기

**대화 안에서는** 실을 떠나지 않고 열어볼 수 있는 카드로 나타납니다.

**자기 페이지에서는** 전체 내용, 지원되는 형식의 미리보기, 그리고 내보내기를 제공합니다. 에이전트는 나중에 자기 아티팩트를 다시 읽을 수 있습니다. 한 대화에서 초안을 쓰고 다음 대화에서 고치는 식의 이어지는 작업이 가능한 이유입니다.

**에이전트의 인벤토리에는** 그 에이전트가 만든 아티팩트가 모두 나열됩니다. 자주 돌아가는 것은 고정해 두면 위에 남습니다.

## 아티팩트에서 앱으로

에이전트가 함께 동작하는 파일 묶음을 만들었다면 — 페이지, 작은 도구, 대시보드 같은 것 — 그것들을 **앱**으로 승격할 수 있습니다. 앱은 자기 페이지를 갖고, 문서가 아니라 동작하는 것으로 열리며, 아티팩트와 똑같이 링크로 공유됩니다.

승격은 **이동**입니다. 아티팩트들이 앱의 첫 버전이 되고 원래 항목은 사라집니다. 진실이 한 벌만 남아 같은 결과물이 목록에 두 번 나오지 않습니다. 원본은 앱이 저장된 **뒤에만** 지워지므로, 저장이 실패하면 아무것도 잃지 않습니다.

앱은 두 가지 모드로 열립니다.

- **뷰어** — 결과물만, 둘레에 아무것도 없이. 링크를 받은 사람이 보는 화면입니다.
- **캔버스** — 대화 옆에 앱을 띄웁니다. 고쳐달라고 말하고 반영되는 것을 바로 볼 수 있습니다.

## 링크로 공유하기

아티팩트는 기본적으로 **사용자만 볼 수 있습니다**. 링크 공유를 켜면 그 아티팩트 하나를 여는 URL 이 만들어집니다.

링크가 주는 것과 주지 않는 것입니다.

| 주는 것 | 주지 않는 것 |
| --- | --- |
| 이 아티팩트에 대한 읽기 권한 | 다른 아티팩트에 대한 접근 |
| 그 밖에는 없음 | 그것이 나온 대화 |
| | 에이전트, 그 메모리, 계정 |

링크를 가진 사람은 누구나 열 수 있으니 공개된 것으로 취급하세요. 공유를 끄면 링크가 동작을 멈춥니다. 공유되지 않은 아티팩트는 누가 URL 을 맞혔든 아예 찾아지지 않습니다.

<Aside type="caution" title="공유 전에 내용을 확인하세요">
  메일이나 문서를 바탕으로 쓴 아티팩트는 그것들을 인용하고 있을 수 있습니다. 링크를 켜기 전에
  읽어보세요.
</Aside>

## 한계

- **버전 기록이 없습니다.** 아티팩트를 갱신하면 내용이 교체됩니다. 이전 상태가 필요하면 먼저 내보내거나, 별도 아티팩트로 저장하라고 하세요.
- 아티팩트는 그것을 만든 에이전트와 사용자의 것입니다. 다른 에이전트는 사용자가 가리켜 주지 않는 한 읽지 않습니다.
- 링크 공유는 읽기 전용이고 아티팩트당 링크 하나입니다. 사람별 접근 설정은 없습니다.
- 에이전트를 삭제해도 그 아티팩트는 삭제되지 않습니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="프로젝트"
    href="/ko/docs/capabilities/projects/"
    description="아티팩트가 속한 업무를 묶기."
  />
  <LinkCard
    title="루틴"
    href="/ko/docs/automate/routines/"
    description="산출물이 대개 아티팩트인 예약 작업."
  />
  <LinkCard
    title="보안과 권한"
    href="/ko/docs/account/security/"
    description="무엇이 비공개이고, 무엇이 공유되고, 에이전트가 무엇에 닿는지."
  />
</CardGrid>
