O que é a Toolbox na Foundry?

À medida que as organizações adotam agentes de IA, a gestão de ferramentas entre agentes pode tornar-se cada vez mais complexa. Os agentes frequentemente ligam-se diretamente a ferramentas, APIs, servidores MCP e outros serviços, exigindo configuração, autenticação e governação separadas para cada implementação. Esta abordagem pode levar a esforços duplicados, comportamentos inconsistentes, implantações de produção frágeis e sobrecarga operacional adicional à medida que o número de agentes cresce.

O Toolbox oferece uma forma centralizada de gerir e partilhar ferramentas no Microsoft Foundry. Com o Toolbox, defines um conjunto curado de ferramentas uma vez e expões-nas através de um único endpoint compatível com MCP que os agentes podem consumir em frameworks e runtimes. O Toolbox ajuda a simplificar a integração das ferramentas, permitindo a gestão centralizada de credenciais, governação, observabilidade e controlo de acessos.   Em vez de configurarem ferramentas de forma independente para cada agente, as equipas podem gerir ferramentas num só local, reutilizá-las entre múltiplos agentes e atualizar implementações sem necessidade de alterações ao código do agente. Esta abordagem ajuda as organizações a escalar o desenvolvimento de agentes, mantendo práticas consistentes de segurança e operacionais.

Este artigo explica como funciona o Toolbox, os seus conceitos centrais e arquitetura, e como criar e gerir toolboxes no Microsoft Foundry.

Porque usar uma toolbox?

Considere um agente que ajude a integrar novos colaboradores. Um único pedido pode exigir do agente:

• Obtenha orientações de integração usando uma base de conhecimento.
• Crie uma conta Microsoft Entra ID usando uma API REST.
• Provisionar recursos cloud usando um agente de longa duração.
• Rediga um email personalizado de boas-vindas usando as competências do agente.
• Publique uma mensagem de boas-vindas num canal do Microsoft Teams usando um servidor MCP.

São cinco tipos, cinco modelos de autenticação e cinco equipas proprietárias – para um agente . Agora multiplica isso por todos os agentes que a tua organização cria:

• As equipas reimplementam as mesmas ferramentas de forma independente.
• As credenciais são duplicadas e cada agente gere os seus próprios segredos e a atualização dos tokens.
• A governação é inconsistente ou está em falta, com pouca visibilidade sobre que ferramentas existem ou quem as utiliza.

Sem uma abordagem centralizada, cada agente deve ser configurado com as suas próprias definições de ferramentas, credenciais e lógica de integração. À medida que as organizações criam mais agentes, este modelo pode levar a implementações duplicadas de ferramentas, controlos de segurança inconsistentes e maior sobrecarga operacional.

O Toolbox aborda estes desafios ao permitir que as equipas definam e gerem ferramentas centralmente e as exponham através de um único endpoint compatível com MCP. Os agentes podem então consumir ferramentas aprovadas sem necessidade de integrações personalizadas para cada agente, ajudando as organizações a melhorar a reutilização de ferramentas, simplificar a gestão de credenciais e aplicar a governação de forma consistente entre as implementações dos agentes.

O ciclo de vida da ferramenta - Construir, Descobrir, Consumir e Gerir

Toolbox cobre todo o ciclo de vida da ferramenta através de quatro pilares - Construir, Descobrir, Consumir e Governar:

Integrado no Foundry, não limitado ao Foundry

As caixas de ferramentas são criadas e geridas no Microsoft Foundry, mas não se limitam a agentes baseados no Foundry. Qualquer runtime ou cliente compatível com MCP pode usar uma toolbox, incluindo agentes personalizados construídos com o Microsoft Agent Framework, LangGraph ou o seu próprio código.

Como uma caixa de ferramentas é um recurso gerido, pode adicionar, remover ou atualizar ferramentas sem alterar o código do agente. Os agentes continuam a ligar-se ao mesmo endpoint enquanto os administradores gerem a disponibilidade e configuração das ferramentas de forma centralizada. Com o Versioning, pode promover uma nova versão predefinida de uma toolbox e torná-la disponível para agentes consumidores sem ter de redistribuir esses agentes.

Veja estas demonstrações para ver as barras de ferramentas em ação:

Capacidades chave

O Microsoft Foundry Agent Toolbox adiciona capacidades que mantêm coleções grandes e de rápido crescimento de ferramentas geríveis e seguras.

• Endpoint único. O seu agente liga-se a um endpoint compatível com MCP e descobre todas as ferramentas em tempo de execução. Podes adicionar, remover ou reconfigurar ferramentas sem mudar o código do agente ou redisponibilizar.
• Autenticação centralizada. A caixa de ferramentas gere a injeção de credenciais, atualização do token e aplicação de políticas em tempo de execução, utilizando o Microsoft Entra ID e o passthrough de identidade OAuth, pelo que os agentes consumidores não gerem credenciais por ferramenta.
• Governação por defeito. Aplicar barreiras de proteção (políticas de IA responsável) às entradas e saídas da ferramenta ao nível do conjunto de ferramentas.
• Versionamento. Cria e testa uma nova versão da toolbox, depois define-a como predefinida quando estiveres pronto. Cada agente que aponta para a caixa de ferramentas recolhe automaticamente a versão promovida, sem alterações no código.

Para além destas capacidades chave, o Toolbox permite as seguintes funcionalidades:

Pesquisa por ferramentas

À medida que a sua aplicação cresce, também aumenta o número de ferramentas disponíveis. Uma caixa de ferramentas que começa com algumas ferramentas pode rapidamente expandir-se para dezenas ou até centenas. Enviar todas as definições de ferramenta com cada pedido de modelo cria desafios:

• O custo aumenta à medida que o número de ferramentas aumenta: Cada definição de ferramenta adiciona tokens de entrada, quer o modelo use essa ferramenta ou não.
• Capacidade de contexto reduzida: As definições de ferramentas competem com o histórico de conversação, conhecimento do domínio e outro contexto por espaço na janela de contexto do modelo.
• Seleção de ferramentas menos precisa: Quando um modelo tem de escolher entre centenas de ferramentas, é mais provável que escolha uma ferramenta semelhante mas incorreta ou que ignore a melhor opção.

A pesquisa de ferramentas resolve estes desafios ao esconder ferramentas por defeito e expor apenas duas meta-ferramentas:

• tool_search - Descreve o que precisas e recupera as ferramentas mais relevantes.
• call_tool - invocar qualquer ferramenta descoberta pelo nome.

Controla como as ferramentas são apresentadas.

• Fixa ferramentas críticas para que estejam sempre disponíveis.
• Adicione contexto para melhorar a descoberta de ferramentas usando os termos que a sua organização utiliza.
• Afixar automaticamente ferramentas usadas com frequência.

Saiba mais: Pesquisa por ferramentas.

Competências (pré-visualização)

As ferramentas definem o que um agente pode fazer. As competências definem como esta executa uma tarefa.

• O pacote Skills apresenta fluxos de trabalho reutilizáveis e em vários passos como capacidades que os agentes podem invocar como qualquer outra ferramenta. Por exemplo, uma competência pode gerar um relatório formatado, realizar um fluxo de trabalho de triagem ou orquestrar uma sequência de chamadas de ferramentas.

• As habilidades são versionadas e imutáveis. Pode anexar uma versão específica de skill a uma toolbox para garantir um comportamento consistente e previsível entre os ambientes.

• As competências reduzem a configuração necessária para usar fluxos de trabalho partilhados. Os agentes descobrem e carregam competências automaticamente através dos recursos MCP no arranque.

Consulte Competências (pré-visualização).

Ferramentas suportadas

São suportadas as seguintes ferramentas.

Introdução

• Criar e gerir uma caixa de ferramentas no Foundry – configurar uma caixa de ferramentas e integrá-la no seu agente.
• Início rápido do Toolbox - constrói uma caixa de ferramentas e usa-a com um agente hospedado de ponta a ponta.