Quando usar
- Você está construindo a primeira base de conteúdo da ClaudIA para o seu projeto
- Você precisa de um modelo de planilha e boas práticas para evitar erros comuns
- Você quer entender a relação entre IDS, tags e tipos de conteúdo (N1/N2/Interactive)
Pré-requisitos
- Acesso ao Hub do projeto
- Acesso ao helpdesk para extração de tickets (se aplicável)
- (Opcional) FAQ, treinamentos e documentação interna para alimentar a base
Sobre este artigo
Este guia explica como a ClaudIA usa conteúdo, como o time Cloud Humans constrói a base inicial e as boas práticas para criar conteúdo que minimiza erros e melhora retenção.
O que é a ClaudIA?
A ClaudIA é a agente de atendimento com IA generativa da Cloud Humans. Foi criada para responder dúvidas com mais agilidade e empatia, usando uma base de conteúdo da sua empresa.
É alimentada por modelos de linguagem (LLMs) e treinada com conteúdos extraídos de tickets, FAQs e documentos da sua equipe.
Como a ClaudIA responde solicitações?
A ClaudIA funciona com pares de pergunta/título e resposta — o que chamamos de IDS (Inteligência de Dados Semânticos).
-
O cliente envia uma solicitação
-
ClaudIA faz busca semântica na base IDS
-
Identifica o conteúdo mais relevante e responde
Estrutura de cada IDS
-
Pergunta/título — como o cliente aciona aquele conteúdo
-
Resposta — texto enviado quando a pergunta é feita
-
Tipo de conteúdo:
-
N1— ClaudIA responde sozinha -
N2— encaminhada para humano -
Interactive— ativa um fluxo Eddie (planilha, API)
-
-
Tag — categoriza o atendimento

O que é uma TAG?
Cada IDS recebe uma tag. O Tagger é o mecanismo que define a tag final do ticket.
Como o Tagger decide
-
Identifica qual conteúdo IDS foi usado com mais relevância
-
Aplica a tag correspondente:
-
Se N2 → tag da seção que transbordou
-
Se Interactive → tag da seção que chamou o Eddie
-
Se N1 → tag do conteúdo mais relevante
-
Se nenhum conteúdo for usado → tag =
NO_TAG
-
-
A tag é usada para gerar relatórios e métricas
A tag deve ser escrita em minúsculas, sem acento, sem "ç" e separada por underline (ex: certificado_incompleto).

Como criamos a base de conteúdo
Etapa 1 — Extração
Extraímos os tickets do seu helpdesk (~25% do volume médio).
Etapa 2 — Limpeza
Removemos duplicações.
Etapa 3 — Clusterização
Agrupamos perguntas semelhantes para evitar duplicações e identificar as perguntas mais comuns.
Etapa 4 — Construção das respostas
Baseadas em:
-
Respostas reais dos agentes nos tickets
-
Conteúdos extras fornecidos (FAQs, treinamentos)
Etapa 5 — Geração da planilha
Geramos um Google Sheets com sugestões de perguntas e respostas.
Etapa 6 — Validação pelo cliente
Você revisa:
-
A pergunta está clara e específica?
-
A resposta está correta e atualizada?
-
O conteúdo é útil ou irrelevante?
-
Qual a tag correta?
-
É N1 ou N2?
Boas práticas para criar/validar conteúdo
-
Evite perguntas amplas demais. ❌ "Posso alterar o pedido?" ✅ "Posso alterar o pedido de compra após emissão?"
-
Não use saudações nas respostas — a ClaudIA já faz isso automaticamente
-
Evite seções duplicadas — confunde o modelo e prejudica performance
-
Use perguntas/títulos claros e bem escritos — corrija ortografia
-
Direcione instruções longas para links externos: "Você consegue renovar seu certificado seguindo o passo a passo no link a seguir: [link]."
-
Inclua instruções específicas dentro do título da IDS:
[Caso decida utilizar a resposta abaixo, sempre envie ela completa sem mudar absolutamente nada] Como solicitar reembolso? -
Faça variações da pergunta na mesma seção: "Estou sem identidade no momento, ainda assim poderei participar? / Estarei sem RG no dia, tudo bem ir assim mesmo? / Em caso de estar sem identidade, ainda é permitida a entrada?"
Template para criação/validação
🔗 Template de Validação de Conteúdo
Observações
-
Para boas práticas detalhadas: Boas práticas na criação e manutenção de conteúdos
-
Para usar a tela de conteúdos: Como usar a tela de conteúdos (unitário e em massa)
-
Para entender tags: Como funciona o sistema de Tags (Tagger)
-
Para a categoria completa: Conteúdos | Gerindo o conhecimento da ClaudIA