# Usando artefatos com problemas

Mantenha planos, pesquisas, links e HTML interativo junto com o item que eles dão suporte.

Esse recurso está em prévia pública e está sujeito a alterações.

Artefatos de issue são itens de conteúdo nomeados anexados a um issue. Eles fornecem um lugar durável para manter planos, pesquisas, decisões, protótipos e material de referência como contexto ao lado de seu trabalho.

Você pode compartilhar artefatos com outras pessoas por meio de uma URL e, se atualizar um artefato, GitHub manterá um registro de alterações para que você possa voltar e ver como um artefato evoluiu ao longo de um projeto.

## Tipos de artefato com suporte

Artefatos de item dão suporte aos seguintes tipos:

* **Documento markdown (`generic`)**: conteúdo de uso geral, como pesquisa, anotações de investigação ou um documento de design.
* **Plano (`plan`)**: um plano de implementação do Markdown.
* **Link (`link`)**: um link nomeado para conteúdo em outro lugar, como uma discussão, um protótipo ou um thread do Slack ou do Teams.
* **Arquivo HTML (`embedded_html`)**: um documento HTML autocontido, como um protótipo interativo, visualização, fluxograma ou diagrama.

## Criando um artefato

Você pode criar artefatos em GitHub.com
ou pedir a um agente ou a uma ferramenta de desenvolvedor que crie um usando o servidor MCP interno GitHub CLI, GitHub ou a API REST de artefatos de problema. Por exemplo, você pode pedir ao Copilot app que crie um plano de implementação, uma análise de causa raiz ou um resumo de pesquisa e o anexe ao problema.

### Criando um artefato em GitHub.com

1. Navegue até o item em que você deseja criar um artefato.
2. Na seção **Artefatos**, clique em <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. Selecione um tipo de artefato:
   * Para adicionar uma URL nomeada, clique em **Adicionar link**.
   * Para criar um documento markdown, clique em **Criar artefato**.
   * Para criar um documento HTML, clique **em Criar artefato HTML**.
4. Siga os prompts para nomear e criar o artefato.

## Exibindo e compartilhando um artefato

1. Navegue até o item que contém o artefato.
2. Na seção **Artefatos** , clique no nome do artefato.
3. O artefato será aberto e exibido em um painel lateral no issue.
4. Para copiar a URL para compartilhar o artefato com outras pessoas, clique em <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>.

## Editando um artefato

1. Abra o artefato.
2. No painel de artefatos, clique em <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. Atualize o nome do artefato ou o conteúdo do artefato.
4. Salve as alterações.

Ao editar um artefato, cria-se uma versão em seu histórico.

## Exibindo o histórico de versão de um artefato

1. Abra o artefato.
2. No painel de artefatos, clique em <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. Selecione uma versão para exibir seu nome, conteúdo, autor e hora de criação.

Não é possível restaurar uma versão na interface da Web. Para restaurar uma versão anterior, use `gh issue artifact edit --restore-version`. Restaurar salva o nome e o conteúdo anteriores como uma nova versão, preservando o histórico completo.

## Reordenação de artefatos

Você pode reordenar artefatos arrastando-os dentro da seção **Artefatos** . Você também pode clicar <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> ao lado de um artefato, clicar em **Mover** e escolher uma posição.

## Excluir um artefato

> [!WARNING]
> A exclusão de um artefato é permanente e também exclui seu histórico de versões.

1. Na seção **Artefatos** do item, clique <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> ao lado do artefato.
2. Clique em **Excluir**.

## Visualizar com segurança um artefato HTML

Com GitHub.com
ativado, artefatos HTML são abertos no modo de exibição **Source** para que você possa inspecionar o código antes de executá-lo. Para renderizar o HTML, selecione **Visualização**.
GitHub renderiza a visualização em uma área restrita restrita. A interface avisa que a pré-visualização executa o código fornecido pelo usuário, que pode enviar seu conteúdo para sites externos. Examine a origem e apenas visualize o HTML das fontes em que você confia. Para retornar à source, selecione **Source**.

## Usando artefatos com agentes

Quando você usa o Copilot app para trabalhar em um item, os artefatos criados durante a sessão são anexados automaticamente ao item. Você também pode solicitar Copilot a criação de um artefato específico, como um plano de implementação, análise de causa raiz ou resumo do contexto histórico.

Os agentes e as ferramentas de desenvolvedor também podem usar o servidor MCP interno GitHub, a API REST ou GitHub CLI para ler e gerenciar artefatos.

## Gerenciando artefatos com GitHub CLI

Os comandos de issue artifact exigem GitHub CLI 2.103.0 ou posterior.

Para obter mais informações sobre comandos de artefato de issue, consulte a [`gh issue artifact` referência](https://cli.github.com/manual/gh_issue_artifact).

## Leitura adicional

* [Endpoints da API REST para artefatos de item](/pt/rest/issues/artifacts) na documentação da API REST
* [Sobre problemas](/pt/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)