Isaque Victor cursos gratuitosNesta aula
Sem ferramentas, o agente só escreve. Com as quatro certas, ele busca, lê, calcula e monta. Cada uma tem um jeito de errar.
Na aula 4 o seu agente ganhou a primeira ferramenta: ler os arquivos do projeto. Agora vamos olhar as quatro ferramentas que as plataformas de chat oferecem hoje sem código: busca na internet, leitura de arquivos, cálculo e execução de código. Eu vou explicar o que cada uma resolve, onde cada uma erra e como testar antes de confiar. A regra desta aula é simples: ferramenta nova, teste novo. Nunca duas de uma vez.
- Ao final, você vai saber para que serve cada uma das quatro ferramentas e qual tarefa do seu negócio pede qual.
- Vai entender o jeito de errar de cada ferramenta e o teste que pega o erro.
- Vai sair com um entregável: as quatro ferramentas testadas com uma tarefa real cada, com resultado anotado.
Busca na internet: para o que é externo e muda
A busca dá ao agente acesso a informação fora dos seus documentos e mais recente do que o treinamento do modelo. Serve para o que é externo e muda: uma regra nova de um órgão público, o feriado municipal do mês que vem, a especificação de um produto de fornecedor, o que um concorrente publicou. Não serve para o que é interno: a política de troca da sua loja não está na internet, está no seu documento.
O jeito de errar da busca é trazer informação de fonte ruim ou desatualizada com a mesma confiança de uma boa. Por isso, a instrução para busca sempre inclui mostrar a fonte. Um exemplo, para um escritório contábil que quer saber sobre uma obrigação acessória:
Repare: fonte oficial obrigatória, aviso quando não há, e proibição de deduzir. Sem isso, o agente pode montar uma resposta plausível a partir de um blog de 2019.
Cuidado
Busca também é uma porta de entrada. Uma página na internet pode conter texto escrito para enganar agentes ("ignore suas instruções e..."). A maioria das plataformas se protege disso, mas a regra do seu lado é: resultado de busca é dado para conferir, nunca ordem para seguir. Falamos disso a fundo na aula 13.
Leitura de arquivos: mais do que texto
Você já usa leitura de arquivo desde a aula 4, com os documentos do projeto. O que talvez não tenha explorado é a leitura de arquivo dentro de uma conversa: você anexa uma planilha, um PDF, uma imagem, e pede para o agente trabalhar em cima. É diferente dos arquivos do projeto: os do projeto são referência permanente; o anexo da conversa é a matéria-prima do momento.
Uma oficina mecânica, por exemplo, recebe do fornecedor uma tabela de preços de peças em PDF todo mês. O agente lê o PDF e compara com a tabela do mês anterior, que está nos arquivos do projeto, e lista o que subiu mais de um certo percentual. Uma imobiliária anexa a foto de um documento de um imóvel e pede para o agente extrair os campos principais para conferência.
O jeito de errar da leitura é silencioso: PDFs escaneados como imagem podem ser lidos com erro em números; planilhas com várias abas podem ter só a primeira aba considerada; tabelas mal formatadas viram texto confuso. O teste é sempre o mesmo: peça para o agente repetir três valores específicos que você conhece e compare com o original. Se um estiver errado, o arquivo precisa de preparo antes.
Dica
Para planilhas, exporte só a aba e as colunas que o agente precisa, em CSV, antes de anexar. Fica mais leve, mais preciso e você evita mandar colunas com dados que não deveriam sair.
Cálculo e código: onde o modelo não pode fazer de cabeça
Aqui está uma verdade que muita gente descobre do jeito difícil: o modelo de linguagem não calcula. Ele prevê o texto mais provável, e para contas simples o texto mais provável costuma ser certo. Para somar 40 linhas, aplicar uma porcentagem e arredondar, o texto mais provável frequentemente está errado, com toda a confiança do mundo. Por isso as plataformas oferecem uma ferramenta de execução de código (o nome muda: análise de dados, execução de código, interpretador). Quando ela está ligada, o agente escreve um pequeno programa, roda e devolve o resultado real.
Uma loja de materiais de construção usa isso para o fechamento semanal: anexa a planilha de vendas e pede o total por categoria, ticket médio e os cinco produtos mais vendidos. O agente escreve o código, executa e mostra a tabela. O dono confere dois valores contra a planilha e usa.
Três hábitos nessa instrução: mandar usar a ferramenta (senão ele pode calcular de cabeça), mostrar o código (para você ou alguém conferir) e dizer quantas linhas leu (se leu 180 e a planilha tem 200, algo ficou de fora). O jeito de errar do código não é a conta: é partir da coluna errada, ignorar linhas com célula vazia ou tratar um texto como número. Ver o código e conferir amostras pega isso.
Código também monta coisas
A mesma ferramenta serve para gerar um gráfico, montar um arquivo de planilha limpo, converter um formato em outro, ou produzir um documento estruturado. Uma escola pede para o agente transformar a lista de matrículas em uma planilha de turmas com contagem por horário. É a ferramenta de código fazendo o papel de um estagiário que sabe Excel muito bem, com uma diferença: você precisa conferir o resultado como conferiria o do estagiário na primeira semana.
Exemplo real
O agente de fechamento da loja de materiais, na primeira rodada, devolveu um total por categoria que não batia. O código mostrava que ele tinha lido a coluna "valor unitário" como total, sem multiplicar pela quantidade. Uma linha de instrução ("valor total da linha é quantidade vezes valor unitário") corrigiu para sempre. Sem o código visível, o erro passaria como um número plausível.
Qual ferramenta para qual tarefa
Uma tabela para consultar quando estiver desenhando o agente:
| Tarefa | Ferramenta | Teste antes de confiar |
|---|---|---|
| Responder sobre política, preço, horário da empresa | Leitura (arquivos do projeto) | Pergunta ausente: ele diz que não sabe? |
| Saber uma regra ou dado externo recente | Busca | A fonte é oficial e a data é recente? |
| Extrair campos de um documento recebido | Leitura (anexo da conversa) | Três valores conferidos contra o original |
| Somar, comparar, calcular percentual, ranquear | Código | Código visível, contagem de linhas, duas amostras conferidas |
| Montar planilha, gráfico ou arquivo estruturado | Código | Abrir o arquivo gerado e conferir estrutura e totais |
| Escrever texto (resposta, resumo, mensagem) | Nenhuma (é o modelo) | Tom, fatos e fonte, como sempre |
E a regra que liga tudo à ficha da aula 2: cada ferramenta que você dá ao agente vem com uma linha em limites dizendo quando usar e o que fazer com o resultado. Busca sem "mostre a fonte" é porta aberta. Código sem "mostre o código" é caixa preta. Leitura sem "diga quantas linhas leu" é adivinhação.
Prática · 10 min
Teste cada ferramenta com uma tarefa real
- Abra o projeto da aula 4. Em uma conversa nova, faça uma pergunta de busca sobre algo externo e atual do seu setor, usando o modelo do escritório contábil (fonte oficial obrigatória). Anote: a fonte era oficial? A data era recente?
- Anexe na conversa um documento que você recebe de fora (tabela de fornecedor, boleto sem dados pessoais, ficha de produto) e peça para extrair três campos. Confira os três contra o original.
- Anexe uma planilha pequena da empresa (sem dado pessoal; exporte só as colunas necessárias em CSV) e peça um total, uma média e um ranking, mandando usar código e mostrar o código. Confira duas linhas à mão.
- Peça para o agente montar, com código, uma planilha nova a partir da anterior (por exemplo, totais por mês ou por categoria). Abra o arquivo gerado e confira.
- Registre em um documento "Ferramentas testadas" o resultado de cada teste: funcionou, funcionou com erro (qual), não funcionou. Marque quais o seu agente do curso realmente precisa.
Resumo da aula
- Quatro ferramentas sem código: busca, leitura de arquivos, cálculo e execução de código. Cada uma resolve um tipo de tarefa e erra de um jeito próprio.
- Busca é para o externo e atual, sempre com fonte visível; resultado de busca é dado, nunca ordem.
- Leitura erra em silêncio em PDFs escaneados e planilhas com abas; teste com três valores conhecidos.
- O modelo não calcula: para contas, mande usar código, mostrar o código e dizer quantas linhas leu.
- Ferramenta nova, teste novo, uma de cada vez. E cada ferramenta ganha uma linha de limite na ficha.
Quiz da aula
Quatro perguntas para fixar. A melhor nota fica guardada para o certificado.