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

Quill é o capitão do agente da AirOps. Use o Quill para passar do insight à 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 reveja Playbooks.

O Quill funciona melhor quando lhe dá um objetivo claro, o contexto relevante e permissã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 executar em grande escala.

## Com o que o Quill pode ajudar

O Quill pode ajudar-lhe a:

* Responder a perguntas sobre a sua página atual da AirOps.
* Rever 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 entradas, artefactos, ferramentas, referências e gatilhos do Playbook.
* Pesquisar na documentação da AirOps quando faz 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 em alterações de alto 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, Page ou Citation específicos.
5. Anexe ficheiros com o botão de clipe quando o Quill deva usar material de origem.
6. Revise a resposta do Quill ou as alterações em rascunho que ele fez.
7. Publique, execute ou continue a editar apenas depois de o resultado corresponder ao seu objetivo.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-85967ee0e8f7e0ab7abe53f3004982fea30384d4%2Fquill-01-chat-panel.png?alt=media" alt="Quill chat panel open over the Analytics Overview page, answering which topics lost share of voice and which pages to refresh first"><figcaption><p>Pergunte ao Quill sobre a página que está a visualizar.</p></figcaption></figure>

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.

Também pode arrastar o painel de chat flutuante para a esquerda ou para a direita pela sua barra de título. Minimizar e reabrir mantém a mesma posição. Isto aplica-se ao painel flutuante, e não ao chat acoplado ou em ecrã completo.

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

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, lixo, no editor de Workflow ou no chat do agente.

## Contexto da página e referências

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

Utilize `/` 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 Citations.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-5b023a5f93643f87a3ac7e5ef37041813e29913a%2Fquill-02-references-and-attachments.png?alt=media" alt="Quill composer in a Playbook with the / reference menu open, listing Brand Kits, Playbooks, Prompts, Pages, and Citations above an attached PDF"><figcaption><p>Escreva / e escolha uma categoria para referenciar um recurso específico, ou anexe ficheiros de origem.</p></figcaption></figure>

{% hint style="info" %}
O Quill usa o contexto da página a partir do 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 anexo 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 sua página atual quando a captura de ecrã estiver ativada para o seu espaço de trabalho.

## Controlos do chat

Use os controlos do 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ã completo** | Expandir o Quill quando precisar de mais espaço.                  |
| **Minimizar**               | Fechar o painel mantendo o Quill disponível a partir do lançador. |
| **Parar a geração**         | Parar o Quill enquanto ele está a responder.                      |

## Exemplos

Use instruções diretas como:

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

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

```
Revê este Playbook para que atualize publicações de blogue com citações de IA em queda. Mantém a entrada existente do Brand Kit, adiciona uma secção de pesquisa que verifique os dados atuais de SERP e de citações, e adiciona um ponto de controlo de Revisão Humana antes de qualquer atualização do 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.
