> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/playbooks/artifacts.md).

# Artifacts e Colaboração

Armazene, reveja e reutilize resultados persistentes do Playbook

Artefatos são as saídas persistentes que um Playbook produz. Use um Artefato quando um resultado precisar de ser revisto, partilhado, reutilizado noutro processo ou publicado após o fim da execução do Playbook.

## Como Configurar um Artefato

1. Abra o editor do Playbook.
2. Abrir **Artefatos** a partir da linha de chips do cabeçalho e adicione um Artefato.
3. Dê ao Artefato um nome claro e selecione o respetivo tipo.
4. Na Secção que deve criar a saída, escreva `/` e insira o Artefato nas instruções.
5. Descreva o que a Secção deve escrever no Artefato, incluindo a estrutura ou o formato esperados.

Adicione um Artefato separado para cada saída que precise da sua própria revisão ou utilização a jusante.

## Artefatos e Sessões

Cada execução de um Playbook cria uma Sessão. A Sessão regista as entradas, os detalhes de execução, o estado da Revisão Humana e os Artefatos criados durante essa execução.

O conteúdo que não é escrito num Artefato permanece no contexto da Sessão. Declare um Artefato quando precisar de uma saída duradoura, como um briefing, artigo, relatório, conjunto de dados estruturado ou imagem.

Os tipos de Artefacto suportados incluem:

* Markdown
* HTML
* JSON
* CSV
* PNG
* JPG
* GIF

Dê a cada Artefato um nome claro e estável para que seja fácil de referenciar nas instruções do Playbook e nas etapas posteriores. Cada Artefato gerado também tem um link profundo estável que pode usar para regressar a ele ou partilhá-lo com colegas de equipa que tenham acesso.

## Rever e editar um Artefato

Abra um Artefato a partir da respetiva Sessão ou de uma célula de Artefato ligada numa Grid. Pode colaborar na saída sem alterar o Playbook que a produziu:

* **Comentários:** Realce parte de um Artefato e deixe uma pergunta ou feedback.
* **Sugestões:** Proponha uma edição que um revisor possa aceitar ou rejeitar.
* **Menções:** Marque um colega de equipa num comentário ou num fio de sugestões quando a respetiva revisão for necessária.
* **Editar com IA:** Realce o conteúdo e descreva como pretende que essa seleção seja revista.

Os comentários e sugestões permanecem anexados ao Artefato, mantendo a discussão de revisão junto da saída a que se referem.

{% hint style="info" %}
Editar um Artefato altera essa saída da Sessão. Não atualiza as instruções do Playbook. Para alterar execuções futuras, edite e publique o Playbook.
{% endhint %}

Para verificações automatizadas de Descobribilidade de IA e Conformidade com a Marca, consulte [Revisão de Conteúdo e Pontuações de Qualidade](/docs/pt/acoes/grids/review-content-in-the-grid/content-review.md).

## Comparar ou recuperar versões

O histórico de versões do Artefato preserva as versões anteriores à medida que a saída muda.

Abra o histórico de versões para:

* Ver quando cada versão foi criada.
* Comparar uma versão anterior com o conteúdo atual.
* Regressar a uma versão anterior quando precisar de recuperar alterações substituídas ou indesejadas.

Use o histórico de versões antes de publicar quando várias pessoas ou edições assistidas por IA tiverem alterado a mesma saída.

## Usar Artefatos em Grids

Uma coluna de Artefato liga uma célula da Grid ao Artefato do Playbook na respetiva Sessão. A ligação é bidirecional:

* Uma edição feita a partir da Sessão aparece na célula da Grid.
* Uma edição aberta a partir da célula da Grid atualiza o mesmo Artefato da Sessão.

Isto permite às equipas pesquisar e ordenar saídas numa Grid, usar um Artefato como entrada para um Playbook ou Workflow a jusante e levar a saída revista para publicação no CMS sem a copiar para uma coluna de conteúdo separada.

Veja [Adicionar Colunas na Grid](/docs/pt/acoes/grids/add-columns-in-the-grid.md#artifact-columns) para adicionar e usar uma coluna de Artefato.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/playbooks/artifacts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.