Dicas para criar uma base de conhecimento para o Agente IA
O processo detalhado de conexão e configuração básica do Agente IA está descrito no guia "Configurando um bot de IA para responder automaticamente os clientes".
Neste artigo, explicamos as boas práticas de formatação dos arquivos para o bot e compartilhamos recomendações para tornar a busca pelas informações mais eficiente.
Conteúdo:
- O que pode ser enviado
- Estrutura dos arquivos
- Exemplos de dados para envio
- Marcação adicional (tags) nos arquivos
- Função "Pergunta – Resposta"
O que pode ser enviado
No bloco de configurações "Arquivos", você pode enviar arquivos (até cinco) que ajudarão o Agente de IA a formular respostas.
Podem ser utilizados, por exemplo:
- Perguntas frequentes (FAQ): perguntas feitas pelos seus clientes e respectivas respostas.
- Base de conhecimento sobre produtos e serviços: descrições, características e instruções de uso.
- Tabelas de preços: valores atualizados de produtos ou serviços.
- Contatos e endereços de lojas: informações sobre a localização de filiais e pontos de venda.
- Recomendações de uso de produtos: dicas e guias para usuários.
- Informações jurídicas: política de privacidade, termos de uso, contratos.
- Materiais de marketing: informações sobre promoções, descontos e ofertas especiais.
O Agente de IA suporta os seguintes formatos de arquivo: .docx, .pptx, .csv, .html, .rtf, .xlsx, .xml, .md, .txt, .json, .pdf. Tamanho máximo do arquivo - 30 MB.
Estrutura dos arquivos
Para que o Agente de IA encontre as informações necessárias mais rapidamente — e para facilitar a organização e atualização dos arquivos — recomendamos:
- Estruture bem as informações: cada linha, registro ou parágrafo deve conter apenas uma ideia ou unidade de informação.
- Use títulos e seções, organizando os dados de forma lógica.
- Utilize nomes de arquivos descritivos, evitando títulos genéricos como "Documento" ou "Dados". O nome do arquivo deve refletir claramente o seu conteúdo.
- Revise os dados antes do envio, verificando erros de digitação e duplicidades.
- Atualize os arquivos regularmente, garantindo que o Agente de IA forneça informações atualizadas.
- Teste o Agente de IA após o envio, fazendo perguntas e conferindo se as respostas correspondem aos dados carregados.
- Ao usar tabelas, certifique-se de que todas as células estejam preenchidas e que não existam células mescladas, pois isso pode causar erros na análise das informações.
Exemplos de dados para envio
A seguir estão alguns exemplos de arquivos para a base de conhecimento do Agente de IA.
Essas estruturas não são obrigatórias e servem apenas como referência.
Formato JSON
Lista de endereços:
[
{
"País": "Brasil",
"Região": "Região de Brasília",
"Cidade": "Brasília",
"Tipo de loja": "Flagship",
"Shopping": "Brasilia Shopping",
"Endereço da loja": "SCN Quadra 05 BL A - Asa Norte, Brasília - DF, 70715-900",
"Horário de funcionamento": "Seg–Dom 10:00 – 22:00",
"Estação de metrô mais próxima": "",
"Como encontrar": "Subsolo (-1)"
},
{
"País": "Brasil",
"Região": "Região de Brasília",
"Cidade": "Brasília",
"Tipo de loja": "Flagship",
"Shopping": "Brasilia Shopping",
"Endereço da loja": "SCN Quadra 03 BL A - Asa Norte, Brasília - DF, 70715-900 ",
"Horário de funcionamento": "Seg–Dom 10:00 – 22:00",
"Estação de metrô mais próxima": "",
"Como encontrar": "1º andar"
}
]
Catálogo de produtos:
[
{
"SKU": "MA1465-10",
"Modelo": "MARK-II",
"Fabricante": "Mundo dos Donuts",
"Nome": "Máquina para preparo de donuts",
"Descrição": "A máquina para preparo de donuts MARK-II é um equipamento compacto e eficiente para produção rápida de donuts. Possui aquecimento uniforme da superfície com revestimento antiaderente. As alças térmicas evitam queimaduras, e o sistema de proteção contra superaquecimento garante maior segurança e durabilidade.",
"Preço": "R$150",
"Disponibilidade": "Em estoque"
}
]
Formato HTML:
<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8">
<title>Perguntas frequentes</title>
</head>
<body>
<h1>Perguntas frequentes (FAQ)</h1>
<section>
<h2>Perguntas gerais</h2>
<ul>
<li>
<strong>Pergunta:</strong> Quais formas de pagamento vocês aceitam?<br>
<strong>Resposta:</strong> Aceitamos Visa, Mastercard e PayPal.
</li>
<li>
<strong>Pergunta:</strong> Como posso acompanhar meu pedido?<br>
<strong>Resposta:</strong> Utilize o link de rastreamento enviado para o seu e-mail.
</li>
</ul>
</section>
</body>
</html>
Marcação adicional (tags) nos arquivos
Para melhorar a busca do Agente de IA nos documentos enviados, você pode destacar partes importantes das informações usando colchetes duplos. Isso ajuda o sistema a reconhecer dados críticos e a responder com mais precisão às perguntas dos clientes.
É possível aplicar tags em: [[palavra]], [[abreviação]], [[SKU]], [[expressão]].
Recomendamos utilizar essa marcação principalmente para entidades únicas, como códigos de produto, modelos, nomes de planos, números de contrato, restrições, nomes de funções, entre outros.
O Agente de IA reconhece essas marcações e passa a responder estritamente com base nos dados fornecidos, mesmo quando a base de conhecimento contém listas de preços extensas ou documentos complexos.
Exemplo (catálogo de produtos com tags):
[
{
"SKU": "[[MA1465-10]]",
"Modelo": "[[MARK-II]]",
"Fabricante": "Mundo dos Donuts",
"Nome": "Máquina para preparo de donuts MARK-II",
"Descrição": "A máquina para preparo de donuts MARK-II é um equipamento compacto e eficiente para produção rápida de donuts. Possui aquecimento uniforme da superfície com revestimento antiaderente. As alças térmicas evitam queimaduras, e o sistema de proteção contra superaquecimento garante maior segurança e durabilidade.",
"Preço": "R$150",
"Disponibilidade": "Em estoque"
}
]
Se um visitante escrever no chat do Agente de IA, por exemplo: "Qual é o preço da máquina de donuts MARK-II e ela está disponível?"
O Agente de IA encontrará a correspondência exata pela tag [[MARK-II]] e responderá com base nos dados do catálogo: "A máquina para preparo de donuts MARK-II custa R$150 e está em estoque."
As mesmas tags podem aparecer em diferentes documentos. Nesse caso, o Agente de IA combina as informações de todos os arquivos relevantes para gerar a resposta.
Observação importante: não é possível editar documentos já enviados. Para aplicar tags, será necessário excluir os arquivos antigos e enviar novas versões já marcadas. A inserção das tags deve ser feita manualmente por você, utilizando editores online, ferramentas de busca e substituição, scripts próprios ou planilhas do Excel.
Função "Pergunta – Resposta"
Agora, nas configurações do Agente de IA, você pode adicionar um bloco de perguntas frequentes, que será utilizado diretamente na formulação das respostas. É possível criar até 50 pares de pergunta e resposta.
Para isso, acesse: "Fontes" → "Base de conhecimento" → "Pergunta–Resposta" e clique em "Adicionar".
Na janela que será exibida, informe a pergunta do cliente e a resposta correspondente. Em seguida, clique em "Salvar".
As informações sobre as respostas adicionadas aparecerão nesta mesma seção. Você também verá a data da última alteração e poderá editar o texto ou desativar o par para uso pelo Agente de IA, clicando nos três pontos à direita.
