아티팩트의 어느 판을 검토했나요? 버전과 보관 파일 연결하기

같은 문서를 두고 두 사람이 “최신 판”이라고 말해도 서로 다른 내용을 읽었을 수 있습니다. 이 글은 ClawPod Cloud의 Room에서 Agent가 만든 문서를 검토하고 팀에 전달하는 실무자를 위한 안내입니다. 접근 가능한 Room과 아티팩트 형태의 응답이 있어야 하며, 읽고 나면 검토한 버전과 내려받은 파일을 구분해 기록할 수 있습니다. 여기서 아티팩트는 대화에서 생성된 버전이 있는 결과물이고, 버전은 그 결과물의 특정 판을 뜻합니다.

핵심은 “최신” 대신 검토한 판을 남기는 것입니다

• 공식 Guide는 아티팩트 카드에서 해당 버전을 열고, 여러 버전이 있으면 원하는 판을 선택할 수 있다고 설명합니다.
• 내려받기 형식은 HTML 아티팩트의 .html, 그 밖의 아티팩트의 .md입니다. PDF나 Office 파일로 자동 변환된다는 뜻은 아닙니다.
• 검토한 판, 내려받은 파일, 승인 여부는 팀의 기록으로 연결하세요. 아티팩트는 Agent 작업 공간의 파일과 자동 동기화되지 않습니다.

이 글의 조작 설명은 공식 Guide에 적힌 범위입니다. 현재 사용 중인 화면의 버튼 위치나 편집 메뉴를 전제로 하지 않습니다.

카드를 열고 내용까지 확인하세요

Room은 사용자와 Agent가 같은 대화 맥락에서 협업하는 공간입니다. 메시지를 보냈다는 사실만으로 작업이 끝난 것은 아닙니다. 의도한 Agent의 응답이나 처리 상태를 먼저 확인하세요.

Guide에 따르면 메시지에 아티팩트 카드가 보일 때 카드를 선택하면 결과물을 따로 보는 Artifact 패널이 열립니다. 패널은 해당 아티팩트의 정확한 버전을 불러옵니다. 여러 버전이 있을 때는 원하는 버전을 선택할 수 있고, Markdown과 HTML 내용을 미리 볼 수 있습니다. Markdown은 제목과 목록 등을 기호로 표현하는 문서 형식입니다.

카드는 Agent가 아티팩트 형태로 응답한 경우에만 제공됩니다. 일반 메시지로 답했다면 카드가 있다는 전제로 다음 단계를 진행하지 마세요. “이 결과를 아티팩트로 제공할 수 있는지 확인하고, 제공할 수 없다면 대안을 설명해 주세요”라고 요청할 수 있습니다. 요청 자체가 카드 생성의 보장은 아닙니다.

버전 선택은 내용 검토를 대신하지 않습니다. 제목이 같아도 수정 요청이 반영됐는지 본문을 읽으세요. 또한 이 Guide는 직접 편집 메뉴, 편집 권한, 수정할 때마다 새 버전이 생기는 규칙, 이전 판 복원 기능을 설명하지 않습니다. 수정이 필요하면 바꿀 문장과 유지할 내용을 명시해 Agent에게 요청하고, 돌아온 결과를 새로 확인하세요. 동일 카드의 새 버전으로 돌아온다고 미리 단정하지 마세요.

예시: 회의 요약의 담당자를 바로잡아 전달하기

다음은 가상 예시입니다. 문서명과 버전 표기는 설명을 위한 것이며 실제 화면이나 실행 기록이 아닙니다. 제공한 메모에는 “자료 정리 담당: 민지, 마감: 금요일”이라고 적혀 있다고 가정합니다.

독자의 요청

제공한 회의 메모만 사용해 “주간 회의 요약”을 Markdown 아티팩트로 작성할 수 있는지 확인해 주세요. 결정 사항, 담당자, 마감일을 넣고 불명확한 내용은 질문해 주세요. 기존 파일을 덮어쓰거나 외부에 보내지 마세요. 완료하면 결과와 확인한 내용을 알려 주세요.

가상 결과와 수정 요청

첫 결과가 아티팩트로 제공됐고, 독자가 연 버전 1에는 “자료 정리 담당: 준호, 마감: 금요일”이라고 적혀 있습니다. 독자는 원본 메모와 대조해 오류를 찾고 이렇게 요청합니다.

자료 정리 담당자를 메모에 적힌 민지로 바로잡아 주세요. 금요일 마감과 나머지 결정 사항은 유지하세요. 수정 결과를 제공하고, 무엇을 바꿨는지 알려 주세요. 외부 공유는 하지 마세요.

이 예시에서는 수정 결과가 같은 아티팩트의 버전 2로 제공됐다고 가정합니다. 이는 모든 수정 요청의 동작을 보장하는 설명이 아닙니다. Agent의 가상 답변은 “담당자를 민지로 수정했고 금요일 마감은 유지했습니다. 외부 전송은 하지 않았습니다”입니다. 독자는 답변만 믿고 끝내지 않고 실제 결과를 엽니다.

확인 대상	가상으로 확인한 내용	판단
선택한 결과	주간 회의 요약, 버전 2	이번 검토 대상
원본과 본문	담당자 민지, 마감 금요일	메모와 일치
내려받은 파일	weekly-summary-v2.md에 같은 담당자와 마감	파일 내용도 일치
공유 상태	검토 완료, 외부 공유 미승인	승인 전 전송하지 않음

파일명은 독자가 보관하면서 붙인 예시 이름이지 자동 생성 규칙이 아닙니다. “검토 완료”와 “공유 미승인” 역시 팀의 기록이며 제품의 승인 상태 표시를 묘사한 것이 아닙니다.

성공 확인은 카드에서 선택한 판, 본문, 내려받은 파일의 세 곳이 같은 수정 내용을 가리키는지 확인하는 것입니다. 이후 팀 기록에 “주간 회의 요약 / 검토한 버전 2 / 보관 파일 weekly-summary-v2.md / 담당자 수정 확인 / 공유 승인 대기”처럼 남깁니다. 파일을 조직 저장소에 넣으려면 허용된 위치와 접근 범위를 먼저 확인합니다.

실패하면 완료로 처리하지 않습니다. 버전 2를 열 수 없으면 아래 오류 구분에 따라 접근 권한 또는 대상 버전을 확인하세요. 파일에 여전히 준호가 적혀 있으면 선택한 판과 내려받은 내용을 다시 대조하고, 잘못된 파일의 공유를 보류합니다. 수정 결과가 별도 카드나 일반 메시지로 돌아오면 실제 받은 결과를 식별해 기록하고, 이전 카드의 버전 번호를 새 결과에 임의로 붙이지 않습니다.

내려받기는 보관의 시작이지 형식 변환이 아닙니다

Guide는 Markdown 또는 일반 텍스트를 클립보드에 복사할 수 있다고 설명합니다. 파일로 내려받을 때는 다음 경계를 적용하세요.

결과물	Guide의 내려받기 형식	전달 전에 할 일
HTML 아티팩트	.html	받는 쪽의 열람 방식과 보안 절차 확인
그 밖의 아티팩트	.md	문서 내용과 받는 쪽의 Markdown 사용 가능 여부 확인

HTML 아티팩트의 미리보기와 HTML 파일을 채팅에 첨부하는 경로는 다릅니다. Guide에 따르면 HTML 첨부는 다운로드 대상이며 채팅 안의 실행·미리보기는 제공하지 않습니다. 아티팩트를 내려받아 다시 첨부한다고 같은 열람 경험이 유지되는 것은 아닙니다.

PDF, DOCX 같은 다른 형식이 필요하면 해당 형식을 만드는 도구가 Agent 환경에 준비됐는지 먼저 확인해야 합니다. 업로드를 허용하는 형식이라는 사실은 Agent가 만들 수 있다는 보장이 아닙니다. 확장자만 바꾸는 것도 파일 변환이 아닙니다.

열리지 않을 때는 오류를 구분해 전달하세요

공식 Guide는 권한이 없을 때 forbidden, 해당 버전이 없을 때 not found가 표시된다고 설명합니다. 이 둘을 모두 “문서가 사라졌다”로 해석하지 마세요.

• forbidden: 사용 중인 계정, Room과 조직의 접근 범위를 담당자에게 확인합니다. Room 접근은 조직 권한의 영향을 받지만, 이 오류만으로 어느 권한 설정이 원인인지 단정할 수는 없습니다. 파일을 다른 경로로 보내 권한 제한을 우회하지 마세요.
• not found: 전달받은 아티팩트와 버전이 맞는지 작성자에게 확인합니다. 이 표시만으로 삭제 여부, 보관 기간 만료, 복구 가능성을 알 수는 없습니다. 이전에 보관한 사본이 있다면 별도 사본으로 식별하고 최신 결과인 것처럼 대신 제시하지 마세요.

오류 문구와 열려던 결과를 함께 전달하되, 민감한 본문이나 비밀값까지 복사할 필요는 없습니다. 링크를 다시 보내거나 권한을 바꾸는 일을 자동 해결책으로 삼지 말고 원인을 확인한 뒤 허용된 조치를 선택하세요.

읽기·편집·공유·장기 보관을 같은 권한으로 보지 마세요

결과물을 열 수 있다는 사실만으로 편집이나 외부 공유가 허용됐다고 해석하지 마세요. 공유 전에 누가 Room 또는 조직에서 파일을 읽을 수 있는지, 어떤 작업 공간이나 Task와 연결되는지, 보존·삭제·다운로드 정책은 무엇인지 확인하라는 것이 협업 Guide의 안내입니다. 개인정보, 고객 데이터, 비밀값도 점검하세요. 미리보기는 안전성 검사나 완전한 파일 검증이 아닙니다.

아티팩트와 Agent 작업 공간 파일은 자동 동기화되지 않습니다. 내려받은 사본을 고쳤다고 Room의 결과물이 바뀌거나, 작업 공간 파일을 바꿨다고 카드가 갱신된다고 기대하지 마세요. 중요한 파일은 조직의 승인된 저장소에 보관하고 어느 결과를 검토했는지 함께 남기는 편이 좋습니다. 이는 팀의 보관 절차이지 자동 내보내기 기능에 대한 설명이 아닙니다.

공식 문서에서 버전 보관 개수·기간, 나란히 비교하는 기능, 이전 버전 복원, 조직 저장소로의 자동 내보내기는 확인하지 못했습니다. 이런 기능이 업무의 필수 조건이면 사용 전에 별도로 확인하세요. Room 삭제는 기록 접근에 영향을 줄 수 있으므로, 정리 전에 필요한 결과물과 결정 사항을 보존하고 연결된 자동화도 확인해야 합니다.

다음 문서 하나부터 “최신” 대신 검토한 결과와 버전, 보관 파일, 공유 승인 여부를 함께 남겨 보세요. 다음 사람이 같은 내용을 읽고 있는지 확인할 기준이 생깁니다.

Sources

• ClawPod Guide — 파일 형식과 Agent artifact: 카드와 버전, 복사와 내려받기, 오류, 작업 공간 파일과의 분리.
• ClawPod Guide — Chat Room에서 Agent와 협업하기: 요청과 완료 확인, 결과 보관, Room 접근과 삭제 주의.
• ClawPod Guide — Chat과 협업: 공유 전 접근 범위, 보존·다운로드 정책, 민감정보 확인.