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

# Resolução de problemas

Resolva problemas comuns de configuração e execução do Playbook

Use este guia quando um Playbook produzir resultados fracos, ficar bloqueado, encaminhar a revisão incorretamente ou usar a versão errada.

| Sintoma                                                                      | Causa provável                                                                                                          | Solução                                                                                                                                               |
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| A qualidade da saída é baixa                                                 | O Kit de Marca está desatualizado ou usa o formato antigo.                                                              | Migre para o novo formato de Kit de Marca e reveja voz, regras de escrita, públicos e regiões.                                                        |
| "Erro \\"Kit de Marca obrigatório\\" após associar um Kit de Marca"          | O tipo de Entrada é Texto em vez de Kit de Marca.                                                                       | Abra as definições de Entrada e altere o tipo para **Brand Kit**.                                                                                     |
| O Playbook deixa passar oportunidades óbvias                                 | A cobertura de prompts está incompleta ou desatualizada.                                                                | Audite os Prompts monitorizados e alargue a cobertura com base em consultas do GSC, chamadas de vendas, tickets de suporte e lacunas da concorrência. |
| A pesquisa na Base de Conhecimento devolve resultados irrelevantes           | A Base de Conhecimento errada está selecionada, ou a seleção automática está a pesquisar de forma demasiado abrangente. | Selecione a Base de Conhecimento pelo nome no seletor de Base de Conhecimento da etapa.                                                               |
| Uma Secção a jusante não consegue encontrar um Artefato                      | A Secção está a referenciar o Artefato pelo nome do ficheiro.                                                           | Referencie o Artefato pelo nome. Use o menu de barra oblíqua para inserir a referência.                                                               |
| A execução acionada usa conteúdo antigo do Playbook                          | O Acionador está fixado a uma versão publicada mais antiga.                                                             | Abra o Acionador e selecione **Predefinido** ou a versão publicada que pretende executar.                                                             |
| A execução acionada falha após alterar as Entradas                           | A versão ativa do Playbook tem Entradas obrigatórias que não estão configuradas no Acionador.                           | Abra as definições do Acionador e atualize a configuração das Entradas.                                                                               |
| A execução no Grid falha após alterar as Entradas                            | A coluna do Grid está a usar uma versão do Playbook com Entradas obrigatórias que não estão mapeadas.                   | Abra as definições da coluna do Grid e atualize os mapeamentos das Entradas.                                                                          |
| Uma Sessão não pode iniciar porque um Artefato obrigatório está indisponível | Um Playbook a montante ainda não produziu o Artefato mapeado.                                                           | Conclua a execução a montante e confirme que o Artefato obrigatório existe; depois tente novamente a Sessão a jusante.                                |
| As edições no chat da Sessão não atualizam o Playbook                        | A Sessão está a executar uma versão publicada. As edições no chat aplicam-se apenas aos Artefatos.                      | Abra o Playbook no editor e edite o Playbook com [Quill](https://docs.airops.com/docs/pt/quill.md), ou faça edições diretas.                          |
| Ao Playbook replicado faltam Ferramentas                                     | O conversor de Workflow não transferiu todas as referências de Ferramenta para o Playbook.                              | Adicione as Ferramentas em falta com o menu de barra oblíqua antes de publicar.                                                                       |
| O Playbook fica bloqueado na Secção 1 a perguntar que linha executar         | A execução está a usar a `__id` coluna interna como identificador de linha de um Grid.                                  | Passe uma coluna de identificador real, como URL ou slug, para o Playbook em vez de `__id`.                                                           |
| Um Playbook não está disponível num Grid                                     | O Playbook ainda é um rascunho.                                                                                         | Publique o Playbook e depois adicione-o a partir do separador Playbooks do Grid.                                                                      |
| O AEO Insight não está disponível como Acionador                             | Os acionadores do AEO Insight não estão ativados para o espaço de trabalho.                                             | Use Agendamento, Webhook ou Monitor, ou contacte a sua equipa de conta sobre os acionadores do AEO Insight.                                           |
| A exportação do Webflow substituiu conteúdo personalizado                    | A exportação nativa envia o campo completo de rich text.                                                                | Planeie a estrutura dos campos para que a saída do Playbook seja a proprietária do campo para o qual exporta.                                         |
| As mensagens do Slack não identificam pessoas individualmente                | As @menções individuais ainda não são suportadas nas etapas do Slack do Playbook.                                       | Indique a pessoa no corpo da mensagem e peça aos revisores que acompanhem o canal relevante.                                                          |

## Retomar após um limite de tempo de execução

Se uma Sessão exceder o limite de tempo de execução de duas horas, a AirOps cancela-a e apresenta um erro a explicar que pode retomar. Abra a Sessão e retome-a para continuar o trabalho. O mesmo limite aplica-se a uma Sessão retomada.

## Perguntas frequentes

### Posso manter os Workflows existentes em execução enquanto crio Playbooks?

Sim. Playbooks e Workflows podem ser executados em paralelo durante a migração.

### Os Playbooks suportam BYOK?

Os Playbooks não suportam atualmente BYOK. Contacte <support@airops.com> se tiver dúvidas sobre o acesso ao modelo nos Playbooks.

### Posso encaminhar revisões para pessoas diferentes com base no tipo de conteúdo ou na complexidade?

Ainda não nativamente. A solução atual é criar Secções separadas com lógica de salto, como "Se a complexidade não for 3, salte esta Secção." Cada Secção pode ter a sua própria atribuição de revisor.

### Os Playbooks podem enviar conteúdo diretamente para o meu CMS?

Sim, mas mantenha a publicação separada da criação de conteúdo sempre que possível. Crie e reveja o conteúdo primeiro e depois publique a partir de uma coluna do Grid, de um Playbook de publicação separado ou de um CMS MCP. Se um Playbook ou um CMS MCP publicar ou atualizar uma página, chame o AirOps MCP `track_aeo_page_content_update` ferramenta com o URL da página e o tipo de atualização para que o AirOps Insights possa acompanhar a atualização do conteúdo.

### Que ferramentas de SEO estão disponíveis nos Playbooks?

Os Playbooks podem usar AirOps SEO Research, DataForSEO, Moz, Google Search Console, Page 360 Report e Page Versus Report. Também podem usar ferramentas de pesquisa na web como Google Search, Parallel Web Systems, Firecrawl, Reddit e Web Page Scrape.

### Como aciono um Playbook programaticamente?

Use um **Webhook** Acionador. Os Webhooks são a forma recomendada de iniciar um Playbook publicado a partir de um sistema externo. Envie um `POST` pedido ao URL do webhook com um `entradas` objeto que usa os nomes das variáveis de Entrada do Playbook como chaves. Veja [Acionadores de Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/triggers.md#webhook-payload-format) para o formato do payload. O Acionador executa a sua versão selecionada: **Predefinido** segue a versão publicada atual, e um Acionador fixado continua a usar a versão selecionada até a alterar. Se as Entradas do Playbook mudarem, atualize a configuração de Entradas do Acionador antes de enviar pedidos de produção.

### O Quill pode editar um Playbook a partir de uma Sessão em execução?

Não. As edições no chat da Sessão aplicam-se aos Artefatos. Para modificar o Playbook, abra-o no editor e use [Quill](https://docs.airops.com/docs/pt/quill.md) aí.


---

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