# 문제가 있는 상태에서 아티팩트 사용

지원하는 이슈와 함께 계획, 연구, 링크 및 대화형 HTML을 유지합니다.

이 기능은 공개 미리 보기에 있으며 변경될 수 있습니다.

이슈 아티팩트는 이슈에 연결된 콘텐츠 조각의 이름입니다. 계획, 연구, 의사 결정, 프로토타입 및 참조 자료를 작업과 함께 맥락 자료로 보관할 수 있는 오랫동안 보관할 수 있는 공간을 제공합니다.

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에서 아티팩트 만들기

1. 아티팩트를 만들려는 이슈로 이동합니다.
2. **아티팩트** 섹션에서 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="Add artifact" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg>을 클릭합니다.
3. 아티팩트 유형을 선택하세요:
   * 명명된 URL을 추가하려면 **링크 추가**를 클릭합니다.
   * Markdown 문서를 만들려면 **아티팩트 만들기**를 클릭합니다.
   * HTML 문서를 만들려면 **HTML 아티팩트 만들기**를 클릭합니다.
4. 프롬프트에 따라 아티팩트 이름을 지정하고 만듭니다.

## 아티팩트 보기 및 공유

1. 아티팩트가 포함된 이슈로 이동합니다.
2. **아티팩트** 섹션에서 아티팩트 이름을 클릭합니다.
3. 아티팩트가 열리고 이슈의 측면 패널에 표시됩니다.
4. 다른 사용자와 아티팩트를 공유할 URL을 복사하려면 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link" aria-label="the link" role="img"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg>을 클릭합니다.

## 아티팩트 편집

1. 아티팩트를 여세요
2. 아티팩트 패널에서 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit artifact" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>을 클릭합니다.
3. 아티팩트 이름 또는 콘텐츠를 업데이트합니다.
4. 변경 사항을 저장합니다.

아티팩트를 편집하면 버전 기록에 버전이 만들어집니다.

## 아티팩트의 버전 기록 보기

1. 아티팩트를 여세요
2. 아티팩트 패널에서 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-history" aria-label="Edit history" role="img"><path d="m.427 1.927 1.215 1.215a8.002 8.002 0 1 1-1.6 5.685.75.75 0 1 1 1.493-.154 6.5 6.5 0 1 0 1.18-4.458l1.358 1.358A.25.25 0 0 1 3.896 6H.25A.25.25 0 0 1 0 5.75V2.104a.25.25 0 0 1 .427-.177ZM7.75 4a.75.75 0 0 1 .75.75v2.992l2.028.812a.75.75 0 0 1-.557 1.392l-2.5-1A.751.751 0 0 1 7 8.25v-3.5A.75.75 0 0 1 7.75 4Z"></path></svg>을 클릭합니다.
3. 버전을 선택하여 이름, 콘텐츠, 작성자 및 생성 시간을 봅니다.

웹 인터페이스에서 버전을 복원할 수 없습니다. 이전 버전을 복원하려면 `gh issue artifact edit --restore-version`을 사용합니다. 복원하면 이전 이름과 콘텐츠가 새 버전으로 저장되고 전체 기록이 유지됩니다.

## 아티팩트 재정렬

**아티팩트** 섹션 내에서 아티팩트 항목을 끌어서 아티팩트 순서를 변경할 수 있습니다. 아티팩트 옆에 있는 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Artifact actions" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>를 클릭하고 **이동**을 클릭한 다음 위치를 선택할 수도 있습니다.

## 아티팩트 삭제

> [!WARNING]
> 아티팩트를 삭제하는 것은 영구적이며 해당 버전 기록도 삭제합니다.

1. 문제의 **아티팩트** 섹션에서 아티팩트 옆에 있는 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Artifact actions" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>을 클릭합니다.
2. **삭제**를 클릭합니다.

## 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`참조](https://cli.github.com/manual/gh_issue_artifact)를 참조하세요.

## 추가 읽기

* REST API 설명서의 [이슈 아티팩트용 REST API 엔드포인트](/ko/rest/issues/artifacts)
* [문제 개요](/ko/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)