Padrão de Agente que Usa Ferramentas

What It Is

Neste padrão, os agentes não “fazem coisas” de forma implícita. Atuam apenas através de ferramentas explícitas com entradas/saídas definidas.

As ferramentas são capacidades sujeitas a permissões: chamadas a APIs, ações sobre bases de dados, operações com ficheiros, gatilhos de fluxos de trabalho, notificações e aprovações.

Isto transforma as ações do agente em operações observáveis, testáveis e auditáveis.

Why It Matters in Enterprise

As ferramentas explícitas fazem a diferença entre autonomia de demonstração e autonomia de produção.

Permitem o privilégio mínimo, registos de auditoria e modos de falha seguros (repetições, reversões, aprovações) por ferramenta.

Também melhoram a avaliação: é possível medir taxas de sucesso, latência, categorias de erro e conformidade com a política por ferramenta.

Common Mistakes

  • Permitir ações “livres” (por exemplo, o agente escrever diretamente nos sistemas sem limites de ferramenta).
  • Ferramentas demasiado poderosas (“atualizarQualquerCoisa(id, payload)”) em vez de operações restritas e bem delimitadas.
  • Não validar as entradas/saídas das ferramentas nem aplicar verificações de política antes da execução.
  • Ausência de observabilidade: sem registos, sem identificadores de correlação, sem atribuição a utilizador ou agente.

How Copyl Supports This Pattern

  • A abordagem de plataforma do Copyl incentiva as ações dos agentes através de ferramentas e fluxos de trabalho integrados, em vez de efeitos colaterais ocultos.
  • As permissões, os registos de auditoria e a aplicação de políticas atuam na fronteira da ferramenta para manter as ações governáveis.
  • Isto cria um envelope operacional mais seguro para integrações e automação empresariais.

Related Patterns