Playbook BCR.CX · Artigos de Guide para Agentes de IA
Playbook · Knowledge Base para IA

Artigos do Guide que o Agente de IA realmente lê.

Um guia prático para transformar sua base de conhecimento do Zendesk Guide em conteúdo que o Agente de IA entende, sem alucinar — e um prompt pronto para reescrever os artigos que você já tem.

Ver os 4 módulos
Otimizado para RAG Zendesk Guide Ultimate · Zendesk AI
Sem alucinação ✦
Artigo de hoje "Veja como cancelar na imagem abaixo 👇 e leia mais nas políticas aqui."
Artigo pronto p/ IA Cancelamento, estorno e reembolso. Prazo: até 7 dias úteis. 1. Clique em Configurações…
O bot lê texto, não imagens nem links. O prompt cuida da tradução.
O ponto de partida

O Agente de IA não enxerga o que você publica — ele lê.

Ferramentas como Zendesk AI e Ultimate usam RAG: o bot recupera trechos dos seus artigos e gera a resposta a partir do texto. Print de tela, GIF, vídeo e link externo costumam ser ignorados. Se a informação crítica está só na imagem, ela some.

Mídia não é lida

O bot não "assiste" GIFs nem faz OCR confiável. O passo a passo precisa existir em texto.

Links viram labirinto

"Leia mais aqui" não resolve. O bot raramente segue o link — o dado precisa estar dentro do artigo.

Estrutura é contexto

Título, sinônimos de intenção e regras condicionais explícitas dizem ao bot quando usar cada artigo.

O método · 4 módulos

De "dicas de redação" para arquitetura de soluções.

Quatro frentes que elevam a maturidade da base: o que o bot não vê, como dar contexto, como manter a base viva e como validar antes de publicar.

1

O ponto cego da IA: multimídia e links

Muita base é feita de prints. O bot não assiste GIF, não faz OCR e não segue links na hora de responder. Ensine o cliente a preparar a mídia para a IA.

Alt-textA regra da descrição oculta

Toda imagem de passo a passo precisa de uma descrição textual completa — no atributo alt ou logo abaixo da imagem — dizendo exatamente a ação.

Se a tela mostra o ícone de engrenagem, o texto deve dizer: "Clique no ícone de engrenagem no canto superior direito."

VídeoVídeo exige transcrição

Um vídeo de 5 minutos explicando a devolução será ignorado pela IA. Sempre coloque um resumo dos passos em bullet points de texto para a ingestão do bot.

LinksO labirinto circular

Evite o artigo que só aponta "leia mais nas políticas gerais". A informação crucial — como prazos e valores — precisa estar escrita dentro do próprio artigo.

2

Metadados e tags de contexto

Não é SEO do Google — é dar à IA "dicas" estruturais para saber quando usar um artigo e quando descartá-lo.

LabelsRótulos de escopo limitador

Use labels no Guide para definir exclusividade. Assim o Ultimate cria gatilhos: se a variável indica Android, o bot descarta o artigo rotulado app_ios.

Exemplos: somente_plano_enterprise · app_ios · app_android

SinônimosO título alternativo de intenção

O bot cruza a intenção do usuário com o conteúdo. Coloque no primeiro parágrafo as variações daquela dor.

"Este artigo explica o cancelamento, estorno, devolução de dinheiro e reembolso."
3

Governança e refinamento contínuo

A base é viva. Este é o ciclo de vida do artigo para medir e garantir que a IA está lendo certo — um framework de manutenção no modelo KCS.

FaseAção do gestor / adminObjetivo para a IA
IngestãoAtualizar o artigo e forçar a ressincronização no painel do agente de IA.Garantir que o bot está com a última versão das regras de negócio.
Auditoria de respostaRevisar logs de conversas onde a IA deu resposta parcial ou alucinou.Identificar o trecho que causou confusão — pronomes soltos ou texto prolixo.
Correção (loop KCS)Ajustar a frase que causou a alucinação e adicionar a variável ausente.Melhorar a precisão do RAG e aumentar a taxa de resolução.
ArquivamentoTirar artigos antigos do ar, em vez de só criar novos.Evitar bases conflitantes que misturem informações.
4

O bônus de ouro: checklist de validação

A ferramenta de uso diário do analista. Antes de clicar em "Publicar", confira cada ponto. A versão interativa está logo abaixo — role até a seção Checklist.

Pronto para o RAG

Título, resumo, condicionais, passo a passo numerado, ausência de pronomes vagos e alt-text. Seis verificações que separam um artigo bom de um artigo legível pela IA.

Valor percebido

Entregar um checklist prático eleva o material a "arquitetura de soluções" e capacita o cliente a operar num nível de maturidade altíssimo.

Na prática · antes & depois

O mesmo artigo: como o bot se perde e como ele acerta.

Um caso real de "cancelamento de pedido". À esquerda, o artigo como costuma estar hoje. À direita, a versão reescrita com o método — exatamente o que o Prompt Mestre entrega.

Como NÃO escrever o bot ignora o essencial
Informações importantes1

Olá! Tudo bem? 😊 Que bom te ver por aqui!2

Se você quer mexer no seu pedido, é só fazer isso lá nas configurações3 da sua conta, é bem rápido! Veja na imagem abaixo como fazer:

imagem: print da tela de pedidos4

Depois é só clicar no botão e confirmar5. Pronto!

Para saber sobre prazos e regras, consulte nossas políticas gerais clicando aqui6.

  1. 1Título vago. Não revela a intenção de suporte — o bot não sabe cruzar com "cancelar".
  2. 2Saudação e emoji. Ruído que polui o trecho recuperado pelo RAG.
  3. 3Pronome vago. "isso lá" perde o sentido se lido isoladamente.
  4. 4Passo só na imagem. O bot não lê o print — a instrução desaparece.
  5. 5Botão sem nome. "clicar no botão" não diz qual nem onde.
  6. 6Link circular. O prazo fica fora do artigo; o bot não segue o link.
Pronto para a IA tudo o que importa está em texto
Como cancelar um pedido e solicitar reembolso1

Este artigo explica o cancelamento, estorno, devolução de dinheiro e reembolso2 de um pedido. O reembolso é processado em até 7 dias úteis3 após a confirmação do cancelamento.

SE o pedido já foi enviado, ENTÃO4 o cancelamento não está disponível — solicite a devolução após o recebimento. SE o pedido ainda não foi enviado, ENTÃO siga os passos abaixo.

  1. Acesse Minha conta → Meus pedidos.
  2. Selecione o pedido e clique em Cancelar pedido (botão vermelho no canto inferior direito)5.
  3. Escolha o motivo e clique em Confirmar cancelamento.
  4. O reembolso aparece como "Em processamento" na aba Pagamentos e conclui em até 7 dias úteis.

Labels: app_ios · app_android · plano_padrao6

  1. 1Título = intenção. Casa direto com a dúvida do cliente.
  2. 2Sinônimos de intenção. O bot reconhece estorno, devolução, reembolso.
  3. 3Prazo no texto. O dado crítico está escrito, não num link.
  4. 4Regra SE/ENTÃO antes. A condição vem antes do passo a passo.
  5. 5Botão nomeado + alt-text. A descrição da tela vira texto legível.
  6. 6Labels de escopo. Delimitam quando o artigo se aplica.
O Prompt Mestre faz essa transformação por você
O coração do playbook

O Prompt Mestre

Copie, cole em qualquer IA (ChatGPT, Claude, Gemini…) junto com um artigo atual do seu Guide. A IA devolve o artigo reescrito e pronto para o Agente de IA ler — aplicando todos os módulos automaticamente.

prompt-mestre · artigo-para-ia.txt 
# PAPEL
Você é um especialista em bases de conhecimento otimizadas para Agentes de IA (sistemas RAG) no Zendesk Guide, integrados a soluções como Zendesk AI e Ultimate. Sua tarefa é reescrever o artigo fornecido para que o Agente de IA consiga lê-lo, entendê-lo e gerar respostas precisas — sem alucinar e sem depender de imagens, vídeos ou links externos.

# PRINCÍPIOS A APLICAR
1. Autossuficiência textual: toda informação crítica (prazos, valores, regras, exceções) deve estar escrita em texto. Nunca deixe a resposta escondida em imagem, GIF, vídeo ou atrás de um link.
2. Descrição de mídia (alt-text): para cada imagem/print citado, escreva em texto exatamente a ação que ela mostra. Ex.: "clique no ícone de engrenagem no canto superior direito".
3. Sem links circulares: se o artigo diz "veja nas políticas gerais", traga a informação essencial para dentro do texto. Se ela não estiver no original, marque como [PREENCHER: ...].
4. Título orientado à intenção: o título deve refletir diretamente a dúvida/dor do cliente.
5. Sinônimos de intenção: no primeiro parágrafo, inclua as variações do problema (ex.: cancelamento, estorno, devolução, reembolso).
6. Resumo da resolução no início: o primeiro parágrafo resume a solução, SEM saudações ("Olá", "Tudo bem?") e SEM jargão interno.
7. Condicionais explícitas (SE/ENTÃO): qualquer pré-requisito ou regra condicional aparece ANTES do passo a passo.
8. Passo a passo numerado: instruções em lista numerada, com nomes de botões/menus em **negrito**.
9. Sem pronomes vagos: elimine "isso", "lá", "ele", "aqui" que percam o sentido se lidos isoladamente. Repita o substantivo.
10. Rótulos de escopo (labels): ao final, sugira labels do Guide que delimitam quando o artigo se aplica (ex.: somente_plano_enterprise, app_ios, app_android).

# REGRAS DE OURO
- NÃO invente prazos, valores ou regras. Se não estiver no artigo original, marque [PREENCHER: descrição] em vez de adivinhar.
- Você está reestruturando o conteúdo factual existente, não criando política nova.

# FORMATO DE SAÍDA (devolva exatamente nesta estrutura)
**Título sugerido:** ...
**Resumo (com sinônimos de intenção):** ...
**Pré-requisitos / Regras condicionais (SE/ENTÃO):** ...
**Passo a passo:** (lista numerada, botões em **negrito**, com o alt-text das imagens escrito em texto)
**Informações a preencher:** (liste cada [PREENCHER] encontrado)
**Labels de escopo sugeridas:** ...
**Observações de governança:** (o que arquivar/atualizar se notar conteúdo desatualizado ou conflitante)

# ARTIGO A REESCREVER
Cole o artigo atual do seu Guide abaixo desta linha:
--------------------------------------------------
[COLE AQUI O ARTIGO ATUAL]
--------------------------------------------------

Como usar em 3 passos

1

Copie o Prompt Mestre ao lado.

2

Cole na IA de sua preferência e substitua a última linha pelo artigo atual do seu Guide.

3

Revise e publique: preencha cada [PREENCHER] e valide no checklist antes de subir.

Antes de publicar

Checklist de validação do artigo

O analista deve conferir cada item antes de clicar em "Publicar". Marque conforme valida — o material só está pronto para a IA quando os seis estiverem completos.

Validação RAG-ready

Toque em cada item para marcar como verificado.

0 de 6
O título reflete diretamente uma intenção de suporte?
O parágrafo inicial resume a resolução sem jargões nem saudações?
Pré-requisitos e regras condicionais (SE/ENTÃO) estão explícitos antes do passo a passo?
Os passos estão em lista numerada, com botões e menus em negrito?
Não há pronomes vagos ("isso", "lá", "ele") que percam sentido se lidos isoladamente?
As imagens possuem descrição textual (alt-text) para o bot ler?
Marque os seis itens para liberar a publicação.