Materiais e base de conhecimento
Cadastre textos, documentos, imagens, vídeos e links que o agente consulta para responder e envia ao contato.
Nesta página
O Material de Conhecimento é a biblioteca do agente. Nela você guarda textos de apoio (perguntas frequentes, políticas, roteiros) e arquivos que o agente pode enviar na conversa (catálogo, imagem do produto, vídeo de demonstração). Cada agente só usa os materiais que você marcar para ele.
#Onde colocar cada informação
O agente tem três lugares para aprender sobre o seu negócio. Cada um se comporta de um jeito:
| Lugar | Quanto cabe | Como o agente usa |
|---|---|---|
| Instruções base | 16.000 caracteres | Lê inteiro, em toda resposta. |
| Descrições de Produtos / Serviços | 12.000 caracteres | Lê inteiro, em toda resposta. |
| Material de Conhecimento | Vários materiais | Lê um trecho de cada material e pode enviar o arquivo. |
#Criar um material
- Abra Agentes IA e entre na aba Material de Conhecimento.
- Clique em Novo material.
- Preencha o Título. Use um nome claro: é por ele que o agente reconhece o material.
- Escolha o Tipo de material.
- Preencha o conteúdo, conforme o tipo (veja a tabela abaixo).
- Se quiser, adicione Tags separadas por vírgula.
- Clique em Salvar material.
#Tipos de material
| Tipo | O que você preenche | O agente envia como arquivo? |
|---|---|---|
| Texto / Conhecimento | Conteúdo de texto / Conhecimento: informações, políticas, perguntas frequentes | Não. É só para consulta. |
| Documento | O arquivo e as Instruções para a IA (quando usar este material) | Sim |
| Imagem | O arquivo e as instruções para a IA | Sim |
| Vídeo | O arquivo, ou o endereço do vídeo, e as instruções para a IA | Sim, quando é um arquivo. Vídeo do YouTube, do Vimeo ou do Google Drive vai como endereço, escrito no texto. |
| Link externo | URL do link e Descrição do conteúdo | Não. O agente passa o endereço no texto. |
#Arquivos aceitos
- Tamanho máximo: 50 MB por arquivo.
- Imagem: JPG, PNG, WebP e GIF.
- Vídeo: MP4, 3GP, MOV e WebM.
- Documento: PDF, TXT, CSV, Word e Excel.
Em vez de enviar o arquivo, você pode colar o endereço dele em Ou cole a URL diretamente.
#Instruções para a IA
Nos materiais com arquivo, o campo Instruções para a IA (quando usar este material) diz ao agente quando enviar. Seja direto:
- «Envie este catálogo quando o contato perguntar os preços.»
- «Envie este vídeo quando o contato pedir para ver o produto funcionando.»
#Ligar o material ao agente
Um material novo não é usado por nenhum agente até você marcar.
- Na aba Agentes, clique em Editar no cartão do agente.
- Vá ao passo Conhecimento.
- Marque os materiais que este agente pode usar. A busca filtra por título, descrição ou tag.
- Clique em Salvar agente.
Só aparecem na lista os materiais com estado Ativo.
#Como o agente usa os materiais
#O que entra em cada resposta
A cada resposta, o agente recebe os materiais marcados para ele, dentro destes limites:
- No máximo 8 materiais, os mais recentes primeiro (pela data de criação).
- De cada material: o título, os primeiros 500 caracteres do texto e as tags.
- No conjunto, até 12.000 caracteres.
Na prática:
- Um texto longo num único material não é lido inteiro. Divida em materiais menores, um por assunto, com o mais importante no começo.
- Se o agente tem mais de 8 materiais marcados, os mais antigos ficam de fora.
#Envio de arquivos
O agente envia o arquivo do material nestes canais: WhatsApp (API oficial e não oficial), Instagram, Messenger e Chatbot do site. O arquivo chega logo depois da mensagem de texto.
Para o envio funcionar bem, diga nas instruções quando enviar, e peça o envio na hora:
- Certo: «Quando o contato pedir o conteúdo do curso, mande o material «Ementa do curso» junto com a resposta.»
- Errado: «Diga que vai enviar a ementa depois.»
O agente só envia materiais cadastrados e marcados para ele. Ele não envia arquivo de fora.
#Quando o texto colado é cortado
Os campos de instruções do agente têm limite de tamanho. Se você colar um texto maior, o Leadz mantém o que cabe e avisa: «O texto colado não coube inteiro: ficaram de fora os últimos X de Y caracteres. O campo aceita até Z.»
O que ficou de fora não é salvo. Você tem três saídas:
- resumir o texto;
- passar os produtos para Descrições de Produtos / Serviços, que aceita 12.000 caracteres;
- levar o conteúdo de apoio para materiais do tipo Texto / Conhecimento, um por assunto.
#Problemas comuns
«Arquivo máximo 50 MB.»
O arquivo passa do limite. Reduza o tamanho ou cole o endereço do arquivo em Ou cole a URL diretamente.
O agente não usa a informação que está no material
Três causas comuns. O material não está marcado no passo Conhecimento do agente. A informação está depois dos primeiros 500 caracteres do texto. O agente tem mais de 8 materiais marcados e este é um dos mais antigos. Para informação que não pode faltar, use as instruções do agente.
O agente disse que ia enviar o arquivo, mas ele não chegou
Confira se o material tem arquivo (e não só o endereço de uma página, como YouTube), se está marcado para o agente e se está entre os 8 mais recentes. Depois, ajuste as instruções para pedir o envio «junto com a resposta», usando o título exato do material. Confirme em Testar o agente, escolhendo o canal.
O material não aparece no passo Conhecimento do agente
Só materiais com estado Ativo aparecem. Confira o estado na aba Material de Conhecimento.
#Veja também
Que bom! Obrigado pelo retorno.
Poxa. Tente a solução de problemas ou fale com o suporte.
Mais em Agentes IA
Ver os 9 artigos