> 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 saída ruim, travar, encaminhar a revisão incorretamente ou usar a versão errada. | Sintoma | Causa provável | Solução | | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | A qualidade da saída é baixa | O Brand Kit está desatualizado ou usa o formato legado. | Migre para o novo formato do Brand Kit e revise voz, regras de escrita, públicos e regiões. | | Erro “Brand Kit obrigatório” após anexar um Brand Kit | O tipo de entrada é Texto em vez de Brand Kit. | Abra as configurações de Input e altere o tipo para **Brand Kit**. | | O Playbook perde oportunidades óbvias | A cobertura dos prompts está incompleta ou desatualizada. | Revise os prompts monitorados e amplie a cobertura com consultas do GSC, chamadas de vendas, tickets de suporte e lacunas da concorrência. | | A pesquisa da Base de Conhecimento retorna resultados irrelevantes | A Base de Conhecimento errada está selecionada, ou a seleção automática está pesquisando de forma ampla demais. | Selecione a Base de Conhecimento pelo nome no seletor de Base de Conhecimento da etapa. | | Uma Section posterior não consegue encontrar um Artifact | A Section está referenciando o Artifact pelo nome do arquivo. | Referencie o Artifact pelo nome. Use o menu de barra para inserir a referência. | | A execução disparada usa conteúdo antigo do Playbook | O Trigger está fixado em uma versão publicada mais antiga. | Abra o Trigger e selecione **Predefinido** ou a versão publicada que você quer executar. | | A execução disparada falha após alterar as Inputs | A versão ativa do Playbook tem Inputs obrigatórias que não estão configuradas no Trigger. | Abra as configurações do Trigger e atualize a configuração de Input. | | A execução da Grid falha após alterar as Inputs | A coluna da Grid está usando uma versão do Playbook com Inputs obrigatórias que não estão mapeadas. | Abra as configurações da coluna da Grid e atualize os mapeamentos de Input. | | Uma Session não pode começar porque um Artifact obrigatório não está disponível | Um Playbook anterior não produziu o Artifact mapeado. | Conclua a execução anterior e confirme que o Artifact obrigatório existe; depois tente novamente a Session posterior. | | As edições do chat da Session não atualizam o Playbook | A Session está executando uma versão publicada. As edições no chat se aplicam apenas aos Artifacts. | Abra o Playbook no editor e edite o Playbook com [Quill](/docs/pt/quill.md), ou faça edições diretas. | | O Playbook replicado está sem Tools | O conversor de Workflow não transferiu todas as referências de Tool para o Playbook. | Adicione as Tools ausentes com o menu de barra antes de publicar. | | O Playbook trava na Section 1 perguntando qual linha executar | A execução está usando a coluna interna `__id` como identificador da linha em uma Grid. | Passe ao Playbook uma coluna de identificador real, como URL ou slug, em vez de `__id`. | | Um Playbook não está disponível em uma Grid | O Playbook ainda está em rascunho. | Publique o Playbook e depois adicione-o na aba Playbooks da Grid. | | AEO Insight não está disponível como Trigger | Os triggers do AEO Insight não estão habilitados para o workspace. | Use Agendamento, Webhook ou Monitor, ou entre em contato com sua equipe de contas sobre os triggers do AEO Insight. | | A exportação do Webflow substituiu o conteúdo personalizado | A exportação nativa envia o campo completo de rich text. | Planeje a estrutura do campo para que a saída do Playbook seja proprietária do campo para o qual ele exporta. | | As mensagens do Slack não marcam indivíduos | Ainda não há suporte para @menções individuais nas etapas do Slack do Playbook. | Nomeie a pessoa no corpo da mensagem e peça que os revisores acompanhem o canal relevante. | ## Retomar após um limite de tempo de execução Se uma Session exceder o limite de duas horas de tempo de execução, a AirOps a cancela e exibe um erro explicando que você pode retomar. Abra a Session e retome-a para continuar o trabalho. O mesmo limite se aplica a uma Session continuada. ## Perguntas frequentes ### Posso manter Workflows existentes em execução enquanto crio Playbooks? Sim. Playbooks e Workflows podem ser executados em paralelo durante a migração. ### Os Playbooks oferecem suporte a BYOK? Os Playbooks não suportam BYOK neste momento. Contacte se tiver dúvidas sobre o acesso a modelos nos Playbooks. ### Posso encaminhar revisões para pessoas diferentes com base no tipo ou na complexidade do conteúdo? Ainda não nativamente. A solução atual é criar Sections separadas com lógica de pulo, como "Se a complexidade não for 3, pule esta Section." Cada Section pode ter 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 revise o conteúdo primeiro e, depois, publique a partir de uma coluna da Grid, de um Playbook separado de publicação ou de um CMS MCP. Se um Playbook ou um CMS MCP publicar ou atualizar uma página, chame a MCP da AirOps `track_aeo_page_content_update` com a URL da página e o tipo de atualização para que o AirOps Insights possa rastrear a atualização de conteúdo. ### Quais 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 faço para acionar um Playbook programaticamente? Use um **Webhook** Trigger. Os webhooks são a forma recomendada de iniciar um Playbook publicado a partir de um sistema externo. Envie uma `POST` requisição para a URL do webhook com um `inputs` objeto que usa os nomes das variáveis de Input do Playbook como chaves. Veja [Gatilhos de Playbook](/docs/pt/acoes/playbooks/triggers.md#webhook-payload-format) para o formato da carga útil. O Trigger executa sua versão selecionada: **Predefinido** segue a versão publicada atual, e um Trigger fixado continua usando a versão selecionada até você alterá-la. Se as Inputs do Playbook mudarem, atualize a configuração de Input do Trigger antes de enviar solicitações de produção. ### O Quill pode editar um Playbook a partir de uma Session em execução? Não. As edições em um chat da Session se aplicam aos Artifacts. Para modificar o Playbook, abra-o no editor e use [Quill](/docs/pt/quill.md) lá. ### Um Playbook pode se lembrar de coisas entre execuções? Sim. A memória persiste informações entre Sessions. Um padrão comum é um Playbook que monitora dados e evita recomendar o mesmo conteúdo para atualização dentro de uma janela móvel, como 60 dias. --- # 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=&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.