agent-tool-builder
Crie esquemas de ferramentas de agente confiáveis
Esquemas de ferramentas mal projetados causam alucinações nos agentes, falhas silenciosas ou desperdício de tokens. Esta habilidade ensina padrões comprovados para interfaces de chamada de função claras e inequívocas que funcionam de forma confiável.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "agent-tool-builder". Uma ferramenta que pesquisa um banco de dados com descrição vaga: 'Pesquisa por coisas'
النتيجة المتوقعة:
Melhorado: 'Pesquisa o banco de dados de produtos por categoria, faixa de preço ou palavra-chave. Retorna registros de produtos correspondentes com id, nome, preço e disponibilidade. Use quando usuários perguntarem sobre produtos específicos ou navegarem por categorias.'
استخدام "agent-tool-builder". Ferramenta que falha silenciosamente com entrada inválida
النتيجة المتوقعة:
Tratamento de erro aprimorado: Retorna erro estruturado com 'error_type': 'invalid_parameter', 'field': 'price_max', 'message': 'O valor deve ser um número positivo', 'suggestion': 'Verifique a entrada do usuário e tente novamente com preço válido'
التدقيق الأمني
آمنThis skill is purely documentation providing guidance on agent tool design. Static analyzer flagged false positives: line 54 contains skill names (not shell commands), and cryptographic warnings matched keywords in prose (no actual code present). No executable code exists in this markdown file - it is instructional content only.
درجة الجودة
ماذا يمكنك بناءه
Criar Ferramentas de Agente Personalizadas
Projetar esquemas de ferramentas para operações específicas do domínio como consultas de banco de dados, integrações de API ou operações de arquivo que seu agente precisa executar.
Melhorar Chamada de Função Existente
Refinar ferramentas com desempenho ruim que causam alucinações ou comportamento inconsistente aplicando princípios claros de design de esquema.
Implementar Integração de Ferramentas MCP
Criar ferramentas compatíveis com Model Context Protocol que permitem aos agentes interagir com sistemas externos de forma segura e previsível.
جرّب هذه الموجهات
Revise este esquema de ferramenta e identifique descrições ambíguas ou parâmetros que possam causar comportamento inconsistente do LLM: [cole seu esquema]
Projetar formatos de resposta de erro para uma [nome da ferramenta] que ajudem o LLM a entender o que deu errado e como recuperar ou tentar novamente com parâmetros corrigidos.
Reescreva esta descrição de ferramenta para ser mais específica sobre o que a ferramenta faz, quando usá-la e quais saídas esperar: [cole a descrição atual]
Preciso de um agente para [descrever objetivo]. Projete um conjunto mínimo de 3-5 ferramentas com esquemas claros, descrições e exemplos de entrada que realizem isso sem sobreposição ou ambiguidade.
أفضل الممارسات
- Escreva descrições que especifiquem exatamente quando usar a ferramenta e o que ela retorna
- Inclua exemplos concretos de entrada mostrando valores típicos de parâmetros
- Projete respostas de erro que ajudem o LLM a entender e recuperar de falhas
- Limite conjuntos de ferramentas ao mínimo necessário - muitas opções causam confusão
- Use nomes e tipos de parâmetros específicos que correspondam ao vocabulário do domínio
تجنب
- Descrições vagas como 'processa dados' ou 'lida com solicitações' sem especificidades
- Falhas silenciosas que retornam resultados vazios em vez de mensagens de erro explícitas
- Fornecer 20+ ferramentas quando 5-7 ferramentas focadas seriam mais eficazes
- Esquemas que aceitam qualquer valor sem restrições de validação
- Descrições que explicam implementação em vez de propósito e comportamento