Descrever ferramentas

Um agente de analytics dispõe de duas ferramentas: get_data e query. A primeira lê uma tabela, a segunda executa SQL. As duas descrições têm quatro palavras. Em produção, o modelo chama query para ler uma tabela inteira, esbarra em um timeout de 30 segundos, chama query de novo com a mesma consulta e depois tenta get_data com um nome de tabela inventado. Nenhuma linha do loop está errada. O modelo fez o que se podia esperar dele: chutar, por falta de informação.

A descrição de uma ferramenta não é documentação, é a especificação que o modelo usa para decidir. Ela faz o papel de assinatura de função, docstring e contrato de erro, tudo ao mesmo tempo. Um schema impreciso produz chamadas inválidas; um nome ambíguo produz chamadas à ferramenta errada; um valor de retorno mal formado produz iterações inúteis do loop. Essas são as três causas dominantes de desvio em um agente, muito à frente da escolha do modelo, e todas se corrigem no arquivo onde você declara suas ferramentas.

O schema de uma ferramenta, por completo

Esta é a forma completa de uma declaração utilizável. Compare a densidade de informação com get_data.