> 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/quill.md).

# Quill

Use o Quill, o capitão agente do AirOps, para trabalhar em Insights, Brand Kits, Playbooks e contexto do espaço de trabalho.

O Quill é o capitão agente da AirOps. Use o Quill para passar da análise à ação em toda a AirOps: faça perguntas sobre a página que está a visualizar, consulte o contexto do espaço de trabalho e crie ou revise Playbooks.

O Quill funciona melhor quando lhe dá um objetivo claro, o contexto relevante e autorização para fazer a alteração que pretende. Quando o Quill altera um Playbook ou um Brand Kit, reveja o resultado antes de o publicar ou de o executar em grande escala.

## Com que o Quill pode ajudar

O Quill pode ajudá-lo a:

* Responder a perguntas sobre a página atual da AirOps.
* Analisar os dados de Insights e identificar onde agir a seguir.
* Usar o contexto do Brand Kit ao planear conteúdo ou atualizar instruções.
* Criar, editar e melhorar Playbooks a partir de prompts em linguagem natural.
* Gerir Inputs, Artifacts, Tools, referências e Triggers do Playbook.
* Pesquisar na documentação da AirOps quando fizer perguntas sobre a plataforma.
* Usar anexos de ficheiros, imagens, PDF e texto como parte de um pedido.

O Quill não substitui a revisão de alterações de grande impacto. Publique um Playbook apenas depois de rever o rascunho e confirmar a configuração.

## Como usar o Quill

1. Abra uma página na AirOps onde o Quill esteja disponível.
2. Clique em **Pergunte ao Quill** na parte inferior da página.
3. Faça uma pergunta ou descreva a alteração que pretende.
4. Adicione referências com `/` quando quiser que o Quill use um Brand Kit, Playbook, Prompt, Página ou Citação específicos.
5. Anexe ficheiros com o botão do clipe de papel quando o Quill deva usar material de origem.
6. Reveja a resposta do Quill ou as alterações preliminares que ele fez.
7. Publique, execute ou continue a editar apenas depois de o resultado corresponder ao seu objetivo.

Arraste **Pergunte ao Quill** para a esquerda ou para a direita para reposicioná-lo. Também pode focar o botão e usar as teclas de seta esquerda e direita. A AirOps memoriza a posição no seu navegador, e o painel de chat flutuante abre-se perto dela.

Num Playbook vazio, o Quill pode abrir-se automaticamente para que possa descrever o que quer construir.

O Quill está disponível na maioria das páginas do espaço de trabalho. Não aparece nas definições da conta, utilização, lixeira, editor de Workflow ou chat do agente.

## Contexto da página e referências

O Quill recebe contexto sobre a página de onde envia cada mensagem. Por exemplo, se enviar uma mensagem ao Quill a partir de um editor de Playbook, ele pode usar esse Playbook como alvo. Se enviar uma mensagem ao Quill a partir de uma página Brand Kit, Grid, Knowledge Base, Workflow, Folder, Inbox ou Insights, ele pode usar o contexto dessa página para responder com maior precisão.

Use `/` na caixa de chat para adicionar referências explícitas. As referências ajudam o Quill a focar-se no recurso exato a que se refere, especialmente quando um espaço de trabalho tem vários Brand Kits, Playbooks, Pages monitorizadas, Prompts ou Citações.

{% hint style="info" %}
O Quill usa o contexto da página no momento em que envia a mensagem. Se navegar para uma página diferente durante o mesmo chat, envie uma nova mensagem a partir dessa página para que o Quill receba o contexto atualizado.
{% endhint %}

## Anexos

Use anexos quando o Quill precisar de material de origem que ainda não esteja na AirOps. O Quill aceita até cinco ficheiros por mensagem. Cada ficheiro pode ter até 10 MB.

Os tipos de anexos suportados incluem:

* Imagens JPG, JPEG, PNG, GIF e WebP
* Ficheiros PDF
* Ficheiros TXT e Markdown
* Ficheiros JSON
* Ficheiros HTML
* Ficheiros CSV

O Quill também pode usar uma captura de ecrã da página atual quando a captura de ecrã estiver ativada para o seu espaço de trabalho.

## Controlos de chat

Use os controlos de cabeçalho do Quill para gerir a conversa:

| Controlo                   | Usar para                                                          |
| -------------------------- | ------------------------------------------------------------------ |
| **Histórico**              | Reabrir uma conversa anterior do Quill.                            |
| **Novo chat**              | Iniciar uma nova conversa sem contexto de chat anterior.           |
| **Entrar em ecrã inteiro** | Expandir o Quill quando precisar de mais espaço.                   |
| **Minimizar**              | Fechar o painel mantendo o Quill disponível a partir do iniciador. |
| **Parar geração**          | Parar o Quill enquanto está a responder.                           |

## Exemplos

Use instruções diretas como:

* "Criar um Playbook para atualizar páginas com citações em declínio."
* "Explicar o que este Playbook faz e sugerir melhorias."
* "Usar este Brand Kit e delinear uma estratégia de atualização de conteúdo."
* "Comparar estas citações e dizer-me que páginas precisam de atualizações."

Ao pedir ao Quill para alterar um Playbook, inclua o resultado, o contexto de origem e quaisquer restrições numa única mensagem. Por exemplo:

```
Revise este Playbook para que atualize publicações de blog com citações de IA em declínio. Mantenha o Input existente do Brand Kit, adicione uma secção de pesquisa que verifique os dados atuais de SERP e de citações, e adicione um ponto de verificação de Revisão Humana antes de qualquer atualização no CMS.
```


---

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