Seu primeiro agente numa plataforma de chat

Nesta aula

O primeiro agente cabe na conta que você já tem. Ele vai responder sobre os documentos da sua empresa em meia hora.

Chega de conceito por enquanto. Nesta aula você monta um agente de verdade, sem código, dentro do assistente que já usa. Ele não vai mandar mensagem nem mexer em sistema ainda: vai ler os documentos da empresa e responder perguntas com base neles, citando a fonte. Parece pouco, mas é a base de quase todo agente de atendimento e operação que existe. E é onde você aprende, na prática, o que acontece quando instruções e arquivos se encontram.

• Ao final, você vai saber criar um projeto com instruções fixas e arquivos de referência na sua plataforma.
• Vai entender como escolher e preparar os documentos que entram, e quais ficam de fora.
• Vai sair com um entregável: um agente que responde perguntas sobre a empresa citando o documento de origem.

O que é um projeto e por que ele é o esqueleto do agente

As três grandes plataformas oferecem um recurso parecido, com nomes diferentes: um espaço onde você fixa instruções e anexa arquivos, e toda conversa aberta ali dentro já nasce com esse contexto. No Claude e no ChatGPT esse recurso se chama projeto; no Gemini, o equivalente mais próximo são os Gems. Os detalhes de tela mudam com frequência, então eu descrevo o conceito e você localiza na sua plataforma; a página de ajuda de cada uma mostra onde está no momento.

Volte à anatomia da aula 2. Um projeto te dá, de uma vez, três das seis peças: o modelo (o da plataforma), as instruções (o campo de instruções do projeto) e uma ferramenta de leitura (os arquivos anexados, que o modelo consulta ao responder). Memória de longo prazo, limites e aprovação humana ficam por sua conta, e nas aulas seguintes vamos adicionar mais ferramentas. Mas com essas três peças você já tem algo que se comporta como agente: recebe uma pergunta, percebe (consulta os arquivos), decide (o que responder e de onde) e age (responde citando a fonte).

Escolhendo e preparando os documentos

O agente vai ser tão bom quanto os documentos que ele lê. Vou usar como exemplo uma clínica de estética pequena, com três profissionais, que quer um agente para responder dúvidas da equipe e, no futuro, dos clientes.

O que entra

• Ficha da empresa: nome, endereço, horário, telefone, formas de pagamento, estacionamento, como chegar. Uma página.
• Catálogo de serviços: nome do procedimento, o que é em uma frase, duração, faixa de preço, o que a pessoa precisa fazer antes e depois.
• Políticas: cancelamento, remarcação, atraso, pacote, garantia. Escritas do jeito que a empresa realmente aplica, não do jeito ideal.
• Perguntas frequentes que a equipe já responde de cabeça, com a resposta oficial.

O que fica de fora

• Qualquer arquivo com dado pessoal de cliente: cadastro, histórico, prontuário, comprovante. Não é o que o agente precisa para responder sobre a empresa, e é o tipo de dado que exige base legal e controle de onde fica guardado.
• Senhas, chaves de acesso, dados bancários da empresa.
• Documentos desatualizados. Um catálogo de preços antigo dentro do projeto é pior do que nenhum: o agente vai citar com confiança um preço errado.
• Contratos com terceiros e informação sob sigilo.

Como preparar

Formato simples vence. Um documento de texto ou PDF com títulos claros funciona melhor do que uma apresentação cheia de imagens. Coloque um título no topo de cada arquivo com o que ele é e a data da última atualização, por exemplo "Políticas de cancelamento e remarcação, atualizado em setembro de 2026". Isso ajuda o agente a citar e ajuda você a saber o que está velho.

As instruções do projeto

Com os documentos prontos, é hora do combinado. As instruções do projeto seguem a estrutura que você já conhece: quem é, o que faz, regras, o que fazer quando não sabe, formato. A diferença é que agora o agente tem arquivos, então a instrução mais importante é como usar esses arquivos. Aqui vai a instrução que eu usaria para a clínica de estética, e que você adapta na prática:

Repare em três coisas. A regra 1 obriga a consulta e a citação: sem isso, o modelo responde de cabeça e você não sabe de onde veio. A regra 2 é a defesa contra invenção. A regra 4 é um limite de escopo, que protege a clínica de o agente virar consultora de saúde. Essa instrução é a versão 1; na aula 6 vamos escrever a versão 2 com mais regras e recusas.

Testando como quem quer achar erro

Agente pronto é agente testado. E testar não é fazer três perguntas fáceis e comemorar. É fazer perguntas de quatro tipos:

Anote cada resposta errada com a pergunta, o que ele disse e o que deveria ter dito. Essa lista é o insumo da aula 6. Um agente que passa nos quatro tipos de teste na primeira tentativa é raro; o normal é ajustar a instrução duas ou três vezes.