Como montar a base de conhecimento dos agentes de IA
A base de conhecimento guarda as informações que os agentes de IA consultam para responder seus clientes: políticas, preços, prazos, perguntas frequentes. Ela é organizada em fontes, como pastas, e cada fonte tem documentos. Por exemplo, a Bella Moda pode ter as fontes "Política de trocas", "Tabela de medidas" e "Entregas e frete".
Criar uma fonte
- Abra AI Studio e clique na aba Base de conhecimento.
- Clique em + (Nova fonte).
- Preencha o Nome (até 120 caracteres), por exemplo "Política de trocas".
- Preencha a Descrição (até 500 caracteres) dizendo quando usar a fonte. Por exemplo: "Dúvidas sobre trocas, prazos de devolução e reembolso".
- Deixe Disponível no Copilot ligado se quiser que o Copilot da Inbox use esta fonte para sugerir respostas aos atendentes.
- Clique em Criar fonte.
Os botões de otimizar ao lado do Nome e da Descrição reescrevem o texto com IA e consomem créditos de IA.
Por que a descrição da fonte importa
O agente recebe o nome e a descrição de cada fonte vinculada a ele e decide por elas quando consultar a base. Uma descrição clara ("perguntas sobre tamanhos, medidas e caimento das peças") ajuda o agente a buscar na hora certa. Uma descrição vazia ou genérica ("informações") ajuda pouco.
Adicionar documentos
- Clique no nome da fonte (ou em Abrir fonte) para ver os documentos dela.
- Clique em + (Novo documento).
- Dê um Título (até 160 caracteres) e escolha o Tipo:
- Texto: cole o conteúdo, até 50.000 caracteres.
- FAQ: uma Pergunta e a Resposta oficial, até 8.000 caracteres cada.
- Arquivo: PDF, DOCX, TXT, CSV, MD ou XLSX, até 20 MB. O título é opcional; sem ele, o aidesk usa o nome do arquivo.
- Clique em Salvar documento.
Cada fonte pode ter vários documentos, mas dois documentos da mesma fonte não podem ter o mesmo título.
Status dos documentos
Depois de salvo, o documento é dividido em trechos e preparado para a busca. A coluna Chunks mostra quantos trechos ele gerou. O Status pode ser:
- Processando: sendo preparado. Leva poucos instantes.
- Pronto: o agente já consegue usar.
- Erro: não foi possível ler o conteúdo.
- Aguardando créditos: os créditos de IA acabaram. Ele é preparado sozinho quando entrar saldo.
- Excluindo: sendo removido.
O agente só usa documentos Pronto.
Editar e excluir
- Em documentos de Texto e FAQ, você pode mudar o título e o conteúdo. Ao salvar, o documento é preparado de novo.
- Em documentos de Arquivo, só o título pode mudar. Para trocar o arquivo, exclua o documento e envie a versão nova.
- Excluir uma fonte apaga todos os documentos e arquivos dela. A ação não pode ser desfeita.
Ligar a base a um agente
Criar a fonte não basta: ela precisa estar vinculada ao agente.
- Abra AI Studio › Agentes de IA e entre no agente.
- Na aba Conhecimento, clique em Adicionar e escolha as fontes.
Quando o cliente pergunta algo, o agente busca nas fontes vinculadas e recebe até 8 trechos mais parecidos com a pergunta. Ele foi instruído a responder sobre políticas, preços e prazos só com base nesses trechos.
A chave Copilot na lista de fontes vale só para o Copilot da Inbox. Ela não muda o que os agentes de IA consultam.
Dicas para respostas melhores
- Um assunto por documento. "Trocas" e "Frete" em documentos separados funcionam melhor que um texto único com tudo.
- Use FAQ para as perguntas que os clientes mais fazem, com a resposta exatamente como você quer que seja dada.
- Mantenha os documentos atualizados. Se o prazo de troca mudou de 7 para 30 dias, edite o documento: o agente não sabe que a informação antiga ficou velha.
- Teste no playground do agente perguntando como um cliente perguntaria.
Créditos de IA
Preparar documentos consome 1 crédito a cada 100 mil caracteres, com mínimo de 1 crédito por documento. Cada resposta do agente consome créditos separadamente. Veja o saldo em Configurações › Créditos de IA.
O que a base não faz
- Não lê sites nem links. Copie o conteúdo da página para um documento de Texto.
- Não lê texto dentro de imagens. Um PDF escaneado, só com imagens, fica com status Erro.
- Não se atualiza sozinha: quando uma informação muda, edite o documento.
Quem pode mexer na base
Proprietários e Administradores com acesso ao AI Studio. O perfil Agente não acessa o AI Studio.
Problemas comuns
- "Arquivo muito grande (máx. 20 MB).": divida o arquivo ou envie só as páginas necessárias.
- "Tipo de arquivo não suportado. Use PDF, DOCX, TXT, CSV, MD ou XLSX.": converta o arquivo para um desses formatos.
- "Já existe um documento com este título nesta fonte": escolha outro título ou edite o documento existente.
- "Informe pergunta e resposta da FAQ.": os dois campos da FAQ são obrigatórios.
- "Texto excede o limite de 500 caracteres." ao otimizar a descrição: encurte o texto antes de clicar para otimizar.
- "Nenhuma fonte disponível." ao vincular conhecimento no agente: crie uma fonte primeiro.
- O agente não usa a informação: confira se o documento está Pronto, se a fonte está vinculada na aba Conhecimento do agente e se a descrição da fonte cobre o assunto.