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.

Por que usar uma caixa de ferramentas?

Considere um agente que ajude a integrar novos colaboradores. Um único pedido pode exigir que o 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 resolve estes desafios ao permitir que as equipas definam e geram ferramentas centralmente e as expõem 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 Governar

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

Baseado em fundição, não com destino à fundição

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 caixa de ferramentas, 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 versionamento, pode promover uma nova versão padrão de uma caixa de ferramentas e torná-la disponível para agentes consumidores sem ter de redistribuir esses agentes.

Veja estas demonstrações para ver as caixas 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.

• Ponto final ú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 reimplementar.
• 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 proteções (políticas de IA responsável) às entradas e saídas da ferramenta ao nível da caixa de ferramentas.
• Versionamento. Cria e testa uma nova versão da caixa de ferramentas, depois promove-a para o padrão 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 funcionalidades chave, o Toolbox permite as seguintes novas funcionalidades de pré-visualização:

Pesquisa de ferramentas (pré-visualização)

À medida que a sua candidatura 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.

Tu controlas como as ferramentas são apresentadas.

• Imobiliza 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.
• Auto-pino ferramentas frequentemente usadas.

Saiba mais: Pesquisa de ferramentas (pré-visualização).

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

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

• O 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 competência a uma caixa de ferramentas 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.

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

Ferramentas suportadas

São suportadas as seguintes ferramentas.

Introdução

• Cria e gere uma caixa de ferramentas no Foundry – configura uma caixa de ferramentas e integra-a no teu agente.
• Toolbox quickstart - constrói uma caixa de ferramentas e usa-a com um agente hospedado de ponta a ponta.