이 기능은 공개 미리 보기에 있으며 변경될 수 있습니다.
이슈 아티팩트는 이슈에 연결된 콘텐츠 조각의 이름입니다. 계획, 연구, 의사 결정, 프로토타입 및 참조 자료를 작업과 함께 맥락 자료로 보관할 수 있는 오랫동안 보관할 수 있는 공간을 제공합니다.
URL을 통해 아티팩트를 다른 사용자와 공유할 수 있으며, 아티팩트를 업데이트하는 경우 GitHub에서 변경 사항을 기록하므로 다시 돌아가서 프로젝트 과정에서 아티팩트가 어떻게 발전했는지 확인할 수 있습니다.
지원되는 아티팩트 형식
이슈 아티팩트에서는 다음 형식을 지원합니다.
- Markdown 문서(
generic): 연구, 조사 노트 또는 디자인 문서와 같은 범용 콘텐츠입니다. - 계획(
plan): Markdown 구현 계획입니다. - 링크(
link): 토론, 프로토타입 또는 Slack 또는 Teams 스레드와 같은 다른 콘텐츠에 대한 명명된 링크입니다. - HTML 파일(
embedded_html): 대화형 프로토타입, 시각화, 순서도 또는 다이어그램과 같은 자체 포함 HTML 문서입니다.
아티팩트 만들기
GitHub.com에서 아티팩트를 만들거나 에이전트 또는 개발자 도구에 기본 제공 GitHub MCP 서버, GitHub CLI 또는 문제 아티팩트 REST API를 사용하여 아티팩트를 만들도록 요청할 수 있습니다. 예를 들어 Copilot app에 구현 계획, 근본 원인 분석 또는 연구 요약을 만들고 이슈에 첨부하도록 요청할 수 있습니다.
GitHub.com에서 아티팩트 만들기
- 아티팩트를 만들려는 이슈로 이동합니다.
- 아티팩트 섹션에서 을 클릭합니다.
- 아티팩트 유형을 선택하세요:
- 명명된 URL을 추가하려면 링크 추가를 클릭합니다.
- Markdown 문서를 만들려면 아티팩트 만들기를 클릭합니다.
- HTML 문서를 만들려면 HTML 아티팩트 만들기를 클릭합니다.
- 프롬프트에 따라 아티팩트 이름을 지정하고 만듭니다.
아티팩트 보기 및 공유
- 아티팩트가 포함된 이슈로 이동합니다.
- 아티팩트 섹션에서 아티팩트 이름을 클릭합니다.
- 아티팩트가 열리고 이슈의 측면 패널에 표시됩니다.
- 다른 사용자와 아티팩트를 공유할 URL을 복사하려면 을 클릭합니다.
아티팩트 편집
- 아티팩트를 여세요
- 아티팩트 패널에서 을 클릭합니다.
- 아티팩트 이름 또는 콘텐츠를 업데이트합니다.
- 변경 사항을 저장합니다.
아티팩트를 편집하면 버전 기록에 버전이 만들어집니다.
아티팩트의 버전 기록 보기
- 아티팩트를 여세요
- 아티팩트 패널에서 을 클릭합니다.
- 버전을 선택하여 이름, 콘텐츠, 작성자 및 생성 시간을 봅니다.
웹 인터페이스에서 버전을 복원할 수 없습니다. 이전 버전을 복원하려면 gh issue artifact edit --restore-version을 사용합니다. 복원하면 이전 이름과 콘텐츠가 새 버전으로 저장되고 전체 기록이 유지됩니다.
아티팩트 재정렬
아티팩트 섹션 내에서 아티팩트 항목을 끌어서 아티팩트 순서를 변경할 수 있습니다. 아티팩트 옆에 있는 를 클릭하고 이동을 클릭한 다음 위치를 선택할 수도 있습니다.
아티팩트 삭제
경고
아티팩트를 삭제하는 것은 영구적이며 해당 버전 기록도 삭제합니다.
- 문제의 아티팩트 섹션에서 아티팩트 옆에 있는 을 클릭합니다.
- 삭제를 클릭합니다.
HTML 아티팩트 안전하게 미리 보기
원본 GitHub.com보기에서 HTML 아티팩트가 열리므로 실행하기 전에 코드를 검사할 수 있습니다. HTML을 렌더링하려면 미리 보기를 선택하세요. GitHub 는 제한된 샌드박스에서 미리 보기를 렌더링합니다. 인터페이스는 미리 보기에서 자체 내용을 외부 사이트로 보낼 수 있는 사용자 제공 코드를 실행한다고 경고합니다. 원본을 검토하고 신뢰할 수 있는 원본의 HTML만 미리 봅니다. 원본으로 돌아가려면 원본을 선택합니다.
에이전트에서 아티팩트 사용
Copilot app를 사용하여 문제를 작업할 때 세션 중에 생성된 아티팩트가 문제에 자동으로 연결됩니다. 또한 Copilot에 구현 계획, 근본 원인 분석 또는 기록 컨텍스트 요약과 같은 특정 아티팩트를 만들도록 요청할 수 있습니다.
에이전트 및 개발자 도구는 기본 제공 GitHub MCP 서버, REST API를 사용하거나 GitHub CLI 기타 수단을 통해 아티팩트를 읽고 관리할 수도 있습니다.
GitHub CLI를 사용하여 아티팩트 관리
Issue artifact 명령은 GitHub CLI 2.103.0 이상이 필요합니다.
문제 아티팩트 명령에 대한 자세한 내용은 gh issue artifact참조를 참조하세요.
추가 읽기
- REST API 설명서의 이슈 아티팩트용 REST API 엔드포인트
- 문제 개요