> 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

Os Artefactos são os resultados persistentes produzidos por um Playbook. Use um Artefacto quando um resultado precisar de ser revisto, partilhado, reutilizado noutro processo ou publicado após o término da execução do Playbook.

## Como configurar um Artefacto

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

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b456c32778de62d99a1897b9851e221a9d6dde8f%2Fartifacts-01-artifacts-panel.png?alt=media" alt="Artifacts panel in the Playbook editor listing the Refresh Brief, Refreshed Article, Link Map, Citation Gaps, and Hero Image Artifacts, with Add Artifact"><figcaption><p>Adicione e nomeie Artefactos a partir da linha de chips do cabeçalho.</p></figcaption></figure>

Adicione um Artefacto separado para cada resultado que necessite da sua própria revisão ou utilização posterior.

## Artefactos e Sessões

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

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

Os tipos de Artifact suportados incluem:

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

Dê a cada Artefacto um nome claro e estável para que seja fácil de referenciar nas instruções do Playbook e nas etapas subsequentes. Cada Artefacto gerado também tem uma hiperligação profunda estável que pode usar para regressar a ele ou partilhá-lo com colegas que tenham acesso.

## Reveja e edite um Artefacto

Abra um Artefacto a partir da respetiva Sessão ou de uma célula de Artefacto ligada numa Grelha. Pode colaborar no resultado sem alterar o Playbook que o produziu:

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

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-05f85592649f83de33a37d3e7a7902fedda787da%2Fartifacts-02-review-comments.png?alt=media" alt="Playbook Artifact with a comment thread mentioning Maya Chen and a pending suggestion with Accept and Reject"><figcaption><p>Comente, sugira edições e reescreva partes de um Artefacto.</p></figcaption></figure>

Os comentários e sugestões permanecem associados ao Artefacto, mantendo a discussão de revisão junto do resultado a que se refere.

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

Para verificações automáticas de Descoberta por IA e Aderência à Marca, consulte [Revisão de Conteúdo e Pontuações de Qualidade](https://docs.airops.com/docs/pt/acoes/grids/review-content-in-the-grid/content-review.md).

## Adicione imagens a um Artefacto

Num Artefacto Markdown ou HTML editável, use o botão de imagem para carregar um ficheiro ou inserir um URL de imagem existente. Também pode colar um ficheiro de imagem, como uma captura de ecrã, no editor.

Os ficheiros carregados e colados usam URLs de imagem alojados pela AirOps. As imagens inseridas por URL mantêm o respetivo endereço original, por isso certifique-se de que a origem permanece acessível.

## Comparar ou recuperar versões

O histórico de versões do Artefacto preserva as versões anteriores à medida que o resultado 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.
* Voltar 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 o mesmo resultado.

## Use Artefactos em Grelhas

Uma coluna de Artefacto liga uma célula da Grelha ao Artefacto do Playbook na sua Sessão. A ligação é bidirecional:

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

Isto permite que as equipas pesquisem e ordenem resultados numa Grelha, usem um Artefacto como entrada para um Playbook ou Workflow subsequente e levem o resultado revisto para publicação no CMS sem o copiar para uma coluna de conteúdo separada.

Veja [Adicionar colunas na Grelha](https://docs.airops.com/docs/pt/acoes/grids/add-columns-in-the-grid.md#artifact-columns) para adicionar e usar uma coluna de Artefacto.


---

# 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.
