Criar e manter a base de conhecimento do Agente de IA
Comece por um artigo revisado, confira uma prévia de FAQ e teste as respostas. Amplie a base sem perder o controle das fontes compartilhadas.
Neste artigo
Antes de começar
- Perfil com permissão para editar Agentes de IA
- Agente criado e salvo ao menos uma vez
- Fontes oficiais da empresa identificadas
- Responsável pela revisão e atualização do conteúdo definido
- Canal e contato controlados para testar as respostas
Planejar a base antes de adicionar conteúdo

Escolha primeiro uma dúvida frequente e uma resposta aprovada. Um artigo pequeno é mais fácil de testar do que vários arquivos importados de uma vez.
- 1
Defina o assunto, a fonte oficial e o responsável pela revisão. Separe o que exige atendimento humano.
- 2
Retire informações vencidas, contraditórias, duplicadas ou internas que o cliente não deve receber.
- 3
Prepare três perguntas: uma direta, outra com uma condição diferente e uma fora do que a fonte permite afirmar.
Escolher o tipo de fonte adequado
- Artigo manual: uma pergunta, regra ou procedimento que precisa de edição direta.
- Documento: conteúdo já organizado, com texto selecionável e estrutura simples.
- FAQ em CSV ou JSON: perguntas e respostas em lote, no formato explicado abaixo.
- Link: página autorizada e acessível, cuja atualização precisa ser acompanhada na origem.
Criar um artigo de conhecimento

- 1
Em Automação > Agentes de IA, abra Editar > Conhecimento. O agente precisa ter sido salvo ao menos uma vez.
- 2
Confira Usar base de conhecimento e selecione Adicionar artigo.
- 3
Use a pergunta principal como título. Em Conteúdo, obrigatório, escreva a resposta aprovada, as condições e o que fazer nas exceções.
- 4
Revise nomes, valores e prazos. Salve o artigo e confira seu status; deixe ativos apenas os itens revisados na base de teste.
- 5
Teste pelo caminho descrito em Configurar a busca e validar as respostas, abaixo. Só amplie o uso depois de comparar as respostas com a fonte.
Exemplo completo: prazo de um orçamento
Exemplo fictício, não uma política do Atendeu Rápido nem um prazo legal. Substitua a regra pela condição aprovada da sua empresa antes de usar com clientes.
- Pergunta 1: A vistoria terminou e enviei tudo. Qual é o prazo? Resultado esperado: informar até dois dias úteis após a conclusão dos dois requisitos, sem inventar data de envio ou afirmar que o orçamento já está pronto.
- Pergunta 2: Já mandei meus dados, mas a vistoria ainda não aconteceu. O prazo começou? Resultado esperado: explicar que o início depende também da vistoria concluída.
- Pergunta 3: Preciso receber hoje. Vocês garantem? Resultado esperado: explicar que a urgência depende de avaliação da equipe, sem prometer aprovação; usar a orientação de continuidade humana configurada para esse pedido.
Adicionar arquivos, dados estruturados e links
- 1
Em Conhecimento > Fontes importadas, escolha Adicionar documento, Adicionar link ou Importar FAQ (CSV ou JSON).
- 2
Para documento ou link, use conteúdo autorizado com texto legível. Confira o estado de processamento antes de testar respostas.
- 3
Para FAQ, use Escolher arquivo ou cole o conteúdo no campo indicado. Dê um nome reconhecível ao conjunto e confira a prévia: cada pergunta precisa estar associada à resposta correta.
- 4
Importe apenas depois de revisar os itens. Em seguida, confira conteúdo e status na base e teste as respostas; uma prévia reconhecida não comprova a importação nem a qualidade do atendimento.
- CSV: a primeira coluna contém a pergunta e a segunda, a resposta. Marque a opção de cabeçalho somente se a primeira linha for um cabeçalho, não uma pergunta.
- JSON: use uma lista de objetos com pergunta e resposta, ou com question e answer. Não basta colar um texto sem essa estrutura.

Usar também a base de outros agentes

Use uma base compartilhada para reutilizar conteúdo revisado sem copiá-lo em cada agente. A origem pode estar inativa ou ser Só base de conhecimento; quem responde ao cliente é o principal.
- 1
No principal de teste, abra Conhecimento, confira Usar base de conhecimento e localize Usar também a base de outros agentes.
- 2
Selecione Adicionar base e escolha o cadastro com o conteúdo necessário. Confira origem, status dos artigos e possíveis conflitos com as fontes próprias.
- 3
Leia o aviso sobre conexões de IA, salve e teste pelo principal uma pergunta direta, uma variação e uma informação ausente da fonte.
- 4
Compare as respostas com a origem antes de ampliar o vínculo a outros agentes.
- Agregar base — em Conhecimento > Usar também a base de outros agentes: o principal utiliza conteúdo de outro cadastro na própria resposta.
- Consultar especialista — em Ferramentas > Consultar outros agentes: o principal pede apoio ao especialista e continua a conversa; essa consulta não executa as ações do especialista.
- Transferir atendimento — em Roteamento: o agente de destino assume a conversa e precisa estar preparado para atender. Um cadastro Só base de conhecimento não é usado para assumir o cliente.
Configurar a busca e validar as respostas
- 1
Confira fontes ativas, bases adicionadas e ausência de versões contraditórias no agente de teste.
- 2
Revise Busca inteligente para o uso de significado e sinônimos, considerando a restrição de conexões diferentes explicada acima.
- 3
Faça a pergunta direta, repita com outra formulação e altere uma condição. O exercício de orçamento desta página oferece três casos prontos.
- 4
Pergunte algo ausente da base. Confira se o agente admite o limite e usa a continuidade humana configurada quando necessária.
- 5
Registre aprovado ou precisa corrigir para cada resposta. Corrija a fonte responsável e repita o mesmo roteiro antes de ampliar o uso.
Atualizar e manter a base confiável
- Mantenha uma fonte oficial por regra e registre responsável, motivo e data de revisão.
- Revise preços, prazos e políticas quando mudarem. Use dúvidas transferidas à equipe para localizar lacunas, sem transformar exceções em regras.
- Evite versões contraditórias ativas. Uma base compartilhada reduz cópias, mas exige revisão dos agentes que a utilizam.
Antes de mudar uma fonte compartilhada, organize a atualização e seus consumidores:
- 1
Identifique os agentes que usam a fonte e preserve a versão aprovada para retorno. Uma alteração na origem pode alcançar todos os consumidores.
- 2
Prepare a mudança em conteúdo e agentes de teste independentes. Duplicar apenas o principal não isola a base compartilhada nem as integrações.
- 3
Teste a regra, duas formulações e uma exceção nos caminhos afetados. Se não conseguir isolar o teste, combine uma janela acompanhada e continuidade humana antes de alterar a origem.
- 4
Após aprovação, publique a revisão planejada, evitando versões contraditórias. Aguarde o processamento ou releitura aplicável e confira os agentes consumidores com uma nova conversa controlada.
- 5
Registre os resultados por agente. Se a informação antiga persistir, confira duplicidades, vínculo e processamento antes de criar outra cópia da fonte.
Resolver problemas da base de conhecimento
- O agente ignora um artigo: confirme base habilitada, artigo ativo, salvamento concluído e termos usados na pergunta.
- A resposta está desatualizada: procure versões duplicadas, links ainda não relidos e arquivos antigos mantidos ativos.
- O arquivo não é aproveitado: confira formato, limite exibido, texto selecionável, cabeçalhos e estado de processamento.
- O JSON ou CSV não funciona como esperado: valide sintaxe, codificação, nomes de campos e consistência entre linhas ou objetos.
- A resposta mistura políticas: separe os assuntos e elimine fontes contraditórias ou sobrepostas.
- A busca encontra o tema errado: torne títulos e conteúdo mais específicos e teste novamente com a Busca inteligente ligada e desligada em ambiente controlado. Em bases compartilhadas com conexão diferente, considere o aviso de busca somente por palavras.
- A correção não aparece: salve, aguarde o processamento aplicável e reinicie uma conversa de teste para não confundir o resultado com contexto anterior.
Se ainda houver dúvida, continue pelos artigos relacionados abaixo.
