Quando Usar Esta Habilidade

Crie ferramentas que os agentes possam usar de forma eficaz, incluindo padrões de redução arquitetural

Use esta habilidade ao trabalhar com ferramentas de criação que os agentes possam usar de forma eficaz, incluindo padrões de redução arquitetural.

Design de Ferramentas para Agentes

Ferramentas são o principal mecanismo pelo qual os agentes interagem com o mundo. Elas definem o contrato entre sistemas determinísticos e agentes não determinísticos. Ao contrário das APIs de software tradicionais projetadas para desenvolvedores, as APIs de ferramentas devem ser projetadas para modelos de linguagem que raciocinam sobre intenção, inferem valores de parâmetros e geram chamadas a partir de solicitações em linguagem natural. Um design de ferramenta ruim cria modos de falha que nenhuma quantidade de engenharia de prompt pode corrigir. O design eficaz de ferramentas segue princípios específicos que levam em conta como os agentes percebem e usam as ferramentas.

Quando Usar

Ative esta habilidade quando:

• Criando novas ferramentas para sistemas de agentes
• Depurando falhas ou uso indevido relacionados a ferramentas
• Otimizando conjuntos de ferramentas existentes para melhor desempenho do agente
• Projetando APIs de ferramentas do zero
• Avaliando ferramentas de terceiros para integração com agentes
• Padronizando convenções de ferramentas em uma base de código

Conceitos Principais

Ferramentas são contratos entre sistemas determinísticos e agentes não determinísticos. O princípio de consolidação afirma que, se um engenheiro humano não puder dizer definitivamente qual ferramenta deve ser usada em uma determinada situação, um agente não pode ser esperado para fazer melhor. Descrições eficazes de ferramentas são engenharia de prompt que molda o comportamento do agente.

Os princípios-chave incluem: descrições claras que respondem o quê, quando e o que retorna; formatos de resposta que equilibram completude e eficiência de tokens; mensagens de erro que permitem a recuperação; e convenções consistentes que reduzem a carga cognitiva.

Tópicos Detalhados

A Interface Ferramenta-Agente

Ferramentas como Contratos Ferramentas são contratos entre sistemas determinísticos e agentes não determinísticos. Quando humanos chamam APIs, eles entendem o contrato e fazem solicitações apropriadas. Os agentes devem inferir o contrato a partir das descrições e gerar chamadas que correspondam aos formatos esperados.

Essa diferença fundamental exige a reformulação do design da API. O contrato deve ser inequívoco, os exemplos devem ilustrar os padrões esperados e as mensagens de erro devem orientar a correção. Cada ambiguidade nas definições de ferramentas se torna um modo de falha potencial.

Descrição da Ferramenta como Prompt As descrições das ferramentas são carregadas no contexto do agente e, coletivamente, direcionam o comportamento. As descrições não são apenas documentação — são engenharia de prompt que molda como os agentes raciocinam sobre o uso de ferramentas.

Descrições ruins como "Pesquisar no banco de dados" com nomes de parâmetros crípticos forçam os agentes a adivinhar. Descrições otimizadas incluem contexto de uso, exemplos e padrões. A descrição responde: o que a ferramenta faz, quando usá-la e o que ela produz.

Namespacing e Organização À medida que as coleções de ferramentas crescem, a organização se torna crítica. O namespacing agrupa ferramentas relacionadas sob prefixos comuns, ajudando os agentes a selecionar ferramentas apropriadas no momento certo.

O namespacing cria limites claros entre as funcionalidades. Quando um agente precisa de informações do banco de dados, ele é direcionado para o namespace do banco de dados. Quando ele precisa de pesquisa na web, ele é direcionado para o namespace da web.

O Princípio de Consolidação

Ferramentas Únicas e Abrangentes O princípio de consolidação afirma que, se um engenheiro humano não puder dizer definitivamente qual ferramenta deve ser usada em uma determinada situação, um agente não pode ser esperado para fazer melhor. Isso leva a uma preferência por ferramentas únicas e abrangentes em vez de múltiplas ferramentas estreitas.

Em vez de implementar list_users, list_events e create_event, implemente schedule_event que encontra disponibilidade e agenda. A ferramenta abrangente lida com todo o fluxo de trabalho internamente, em vez de exigir que os agentes encadeiem várias chamadas.

Por Que a Consolidação Funciona Agentes têm contexto e atenção limitados. Cada ferramenta na coleção compete pela atenção na fase de seleção de ferramentas. Cada ferramenta adiciona tokens de descrição que consomem o orçamento de contexto. Funcionalidades sobrepostas criam ambiguidade sobre qual ferramenta usar.

A consolidação reduz o consumo de tokens eliminando descrições redundantes. Ela elimina a ambiguidade ao ter uma ferramenta cobrindo cada fluxo de trabalho. Ela reduz a complexidade da seleção de ferramentas ao diminuir o conjunto de ferramentas eficaz.

Quando Não Consolidar

…