Quase todo resultado de base de conhecimento para agente de IA te manda subir um Pinecone, um fluxo n8n de embeddings e um PDF fatiado em pedaços. Dá pra fazer. Também dá pra carregar o FAQ, o PDF e o catálogo numa Knowledge nativa e o agente consultar isso no WhatsApp, sem vector store à parte.
O que é uma base de conhecimento para agente de IA
Base de conhecimento para agente de IA é o repositório de FAQ, PDF e catálogo que o agente consulta antes de responder. Sem ela, ele improvisa com o que o modelo já sabe. Na Zaia a base se chama Knowledge: itens de texto ou PDF, busca via tool Knowledge Search, reutilizável entre agentes e squads.
O prompt guarda o comportamento (tom, quando abrir ticket, o que nunca inventar). A base guarda o fato (convênio, preço de referência interno, horário, política de retorno). Misturar os dois no mesmo bloco é o jeito mais rápido de o agente alucinar na quinta pergunta.
Prompt colado vs Knowledge vs n8n + Pinecone
O tema não falta conteúdo. Falta o caminho que não assume um banco vetorial que você mesmo sobe.
| Prompt gigante | n8n + Pinecone / Supabase | Knowledge nativa (Zaia) | |
|---|---|---|---|
| Onde mora o FAQ | Colado no system prompt | Chunks no vector store | Itens de texto ou PDF na base |
| Quem busca | Ninguém: o modelo “lembra” | Nó de retrieval no fluxo | Tool Knowledge Search ligada no agente |
| Atualizar o catálogo | Reeditar o prompt em produção | Reindexar o pipeline | Editar o item; a base treina de novo |
| Um PDF longo | Estoura o contexto | Chunks + embeddings à mão | Upload na base, ou PDF Reader se o documento inteiro importa |
| Dado tabular (preço, profissional, vaga) | Texto solto | Planilha + outro nó | Tables, busca semântica no banco nativo |
| Cliente novo | Copiar o prompt | Copiar o fluxo e o índice | A mesma base, ou uma base por cliente, ligada no agente |
n8n RAG funciona. O teto é o de criar agente de IA para WhatsApp com n8n: cada clínica nova é um pipeline, a chave do modelo mora solta, e não há versão pra voltar atrás quando o chunk errado entra no ar.
Knowledge, neste artigo, é o nome público da base no workspace. A Zaia indexa o item (texto até o limite da plataforma, ou PDF) e o agente busca o trecho certo na hora da pergunta. Você não sobe um servidor de embeddings no notebook.
O job concreto: a clínica para de responder convênio errado
Ninguém acorda pensando “preciso de RAG”. O pedido é este:
O paciente pergunta se aceita Unimed, quanto custa a avaliação e o que levar na primeira consulta. A recepção responde uma coisa de manhã e outra à tarde. O agente precisa da lista certa, sempre.
É o mesmo ofício do atendimento e do agendamento no Calendar. Sem a base, o Calendar marca horário e o agente inventa o convênio. Com a base e sem handoff, ele insiste num preço que a clínica não pratica.
Três camadas. Nenhuma delas é o Pinecone:
- Knowledge: FAQ, política, lista de convênios, roteiro de primeira consulta (texto ou PDF).
- Tables: o que muda em linha (profissional, duração, faixa de procedimento). Dado, não prosa.
- PDF Reader: um manual ou contrato que o agente precisa ler inteiro, não em fatias. Documento de autoridade, não catálogo de 200 páginas fatiado.
Sem a camada 1, o agente conversa genérico. Sem a 2, ele mistura preço de tabela com lenda de corredor. Sem handoff, a exceção (desconto, Procon, encaixe) vira improviso.
Como montar uma base de conhecimento para agente de IA sem programar
- Descreva o caso em português. “Atendimento da clínica: responde convênio, avaliação e preparo da consulta só com o que está na base; o que faltar abre ticket.” O Vibe Agent monta a configuração inicial.
- Crie a Knowledge. Nome claro: “FAQ clínica X”, não “base 1”. A base é reutilizável: o mesmo conteúdo pode servir o agente de WhatsApp e o de Instagram.
- Adicione itens. Texto pra FAQ curta. PDF pra manual ou tabela de convênios que você já tem. Evite um PDF de 80 páginas misturando financeiro, RH e cardápio: o agente recupera o trecho errado.
- Ligue a tool Knowledge Search no agente. Na description, diga quando buscar: dúvida de serviço, convênio, preço de catálogo, política. Sem a tool, a base existe e o agente não consulta.
- O que for linha e coluna (horários por profissional, SKU, turma) vai pra Tables, com as tools de busca e inserção. Knowledge não substitui tabela.
- Publique no canal real: WhatsApp (Official ou Waha), Instagram ou Widget. Teste três tipos de pergunta: o que está na base, o que não está, e o ambíguo. O que não está deve abrir ticket, não um chute educado.
- Ajuste no Agent Builder o role: “se a base não tiver a resposta, não invente; abra atendimento.” Versionar. O próximo PDF não vai pra produção no escuro.
O mesmo agente pode agendar no Google Calendar. A base diz o que pode marcar; o MCP escreve o evento.
O que não colocar na base
Regra de tom e de “nunca faça” fica no prompt, não num PDF de 40 páginas. Segredo de paciente, planilha financeira crua e conversa interna de WhatsApp não entram. Dado que muda toda semana (vaga de terça) é Table, não FAQ.
Se o documento precisa ser lido de ponta a ponta (um contrato padrão, um protocolo clínico curto), PDF Reader. Se é um catálogo pra busca por pergunta, Knowledge.
Quando isso vira oferta pra agência
Agência que já entrega o site da clínica sente o teto: o “chatbot” do concorrente responde bonito e erra o convênio. O cliente final reconhece valor quando a resposta bate com o que a recepção diria.
Empacotar “agente que sabe o negócio” pede a base no workspace, o canal no ar e o handoff pra exceção. Não pede um engenheiro de embeddings por cliente. O roteiro de como vender e precificar isso pra base que a agência já tem está no Programa de Aceleração. A infra é Knowledge + agente + CRM.
Perguntas frequentes
O que é uma base de conhecimento para agente de IA?
É o FAQ, PDF e catálogo que o agente consulta antes de responder. Na Zaia isso é Knowledge, com busca pela tool Knowledge Search.
Preciso de Pinecone, n8n ou um banco vetorial pra isso?
Não. Na Zaia a base é nativa no workspace. n8n com Pinecone continua válido pra um pipeline colado à mão. Não é requisito.
Posso subir um PDF?
Sim. Upload na Knowledge (a plataforma indexa o texto) ou PDF Reader quando o agente precisa do documento inteiro, não de um trecho.
O agente para de inventar resposta?
Ele passa a buscar o que você carregou. Se a base estiver vazia ou a pergunta não estiver lá, a regra certa é abrir ticket, não improvisar. Isso se escreve no role e se testa.
Como começar
Fato mora na base, comportamento no prompt: Vibe Agent pra criar em português, Knowledge com o FAQ da clínica, tool de busca ligada, canal no WhatsApp. Descreva o atendimento, carregue o que a recepção já responde, teste a pergunta de convênio.
Começar agora — a partir de R$150.