O que é a Caixa de Ferramentas na Foundry?

À medida que as organizações adotam agentes de IA, o gerenciamento de ferramentas entre agentes pode se tornar cada vez mais complexo. Os agentes geralmente se conectam diretamente a ferramentas, APIs, servidores MCP e outros serviços, exigindo configuração, autenticação e governança separadas para cada implementação. Essa abordagem pode levar a esforços duplicados, comportamento inconsistente, implantações de produção frágeis e sobrecarga operacional adicional à medida que o número de agentes aumenta.

A Caixa de Ferramentas fornece uma maneira centralizada de gerenciar e compartilhar ferramentas no Microsoft Foundry. Com o Toolbox, você define uma única vez um conjunto selecionado de ferramentas e o expõe por meio de um único endpoint compatível com MCP, que os agentes podem consumir em diferentes frameworks e ambientes de execução. A caixa de ferramentas ajuda a simplificar a integração de ferramentas, ao mesmo tempo em que habilita o gerenciamento centralizado de credenciais, a governança, a observabilidade e o controle de acesso.   Em vez de configurar ferramentas de forma independente para cada agente, as equipes podem gerenciar ferramentas em um só lugar, reutilizá-las em vários agentes e atualizar implementações de ferramentas sem exigir alterações no código do agente. Essa abordagem ajuda as organizações a dimensionar o desenvolvimento de agentes, mantendo práticas operacionais e de segurança consistentes.

Este artigo explica como funciona a Caixa de Ferramentas, seus principais conceitos e arquitetura e como criar e gerenciar caixas de ferramentas no Microsoft Foundry.

Por que usar uma caixa de ferramentas?

Considere um agente que ajuda a integrar novos funcionários. Uma única solicitação 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.
• Provisione recursos de nuvem usando um agente de execução longa.
• Redigir um email de boas-vindas personalizado usando as habilidades do agente.
• Poste uma mensagem de boas-vindas em um canal de Microsoft Teams usando um servidor MCP.

São cinco tipos, cinco modelos de autenticação e cinco equipes proprietárias para um agente. Agora multiplique isso por todos os agentes que sua organização desenvolve:

• As equipes reimplementam as mesmas ferramentas de forma independente.
• As credenciais são duplicadas e cada agente gerencia seus próprios segredos e atualização de token.
• A governança é inconsistente ou ausente, com pouca visibilidade sobre quais ferramentas existem ou quem as está usando.

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

A Caixa de Ferramentas aborda esses desafios, permitindo que as equipes definam e gerenciem ferramentas centralmente e as exponham por meio de um único ponto de extremidade compatível com MCP. Os agentes podem consumir ferramentas aprovadas sem a necessidade de integrações personalizadas para cada agente, ajudando as organizações a melhorar a reutilização da ferramenta, simplificar o gerenciamento de credenciais e aplicar a governança de forma consistente entre implantações de agente.

O ciclo de vida da ferramenta – Criar, Descobrir, Consumir e Governar

A caixa de ferramentas aborda o ciclo de vida completo da ferramenta por meio de quatro pilares – Criar, Descobrir, Consumir e Governar:

Hospedado no Foundry, não limitado ao Foundry

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

Como uma caixa de ferramentas é um recurso gerenciado, você pode adicionar, remover ou atualizar ferramentas sem alterar o código do agente. Os agentes continuam a se conectar ao mesmo ponto de extremidade enquanto os administradores gerenciam a disponibilidade e a configuração da ferramenta centralmente. Com Controle de versão, você pode promover uma nova versão padrão de um conjunto de ferramentas e disponibilizá-la para agentes consumidores sem precisar reimplantar esses agentes.

Assista a estas demonstrações para ver as caixas de ferramentas em ação:

Principais funcionalidades

Microsoft Foundry Agent Toolbox adiciona recursos que mantêm coleções de ferramentas grandes e em rápido crescimento fáceis de gerenciar e seguras.

• Ponto de acesso único. Seu agente se conecta a um endpoint compatível com MCP e descobre todas as ferramentas em tempo de execução. Você pode adicionar, remover ou reconfigurar ferramentas sem alterar o código do agente ou reimplantar.
• Autenticação centralizada. A caixa de ferramentas lida com injeção de credencial, atualização de token e imposição de política no runtime usando Microsoft Entra ID e passagem de identidade OAuth, para que os agentes consumidores não gerenciem credenciais por ferramenta.
• Governança por padrão. Aplique proteções (políticas de IA Responsável) às entradas e saídas das ferramentas no nível do conjunto de ferramentas.
• Controle de versão.. Crie e teste uma nova versão da caixa de ferramentas e promova-a para o padrão quando estiver pronto. Cada agente que aponta para a caixa de ferramentas pega a versão promovida automaticamente, sem alterações de código.

Além desses principais recursos, a Caixa de Ferramentas habilita os seguintes novos recursos de visualização:

Pesquisa de ferramentas (versão prévia)

À medida que seu aplicativo aumenta, o número de ferramentas disponíveis também aumenta. Uma caixa de ferramentas que começa com algumas ferramentas pode se expandir rapidamente para dezenas ou até centenas. Enviar cada definição de ferramenta com cada solicitação de modelo cria desafios:

• O custo aumenta conforme a contagem de ferramentas é dimensionada: 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 conversas, o conhecimento do domínio e outro contexto para espaço na janela de contexto do modelo.
• Seleção de ferramentas menos precisa: Quando um modelo deve escolher entre centenas de ferramentas, é mais provável selecionar uma ferramenta semelhante, mas incorreta, ou ignorar a melhor opção.

A pesquisa de ferramentas aborda esses desafios ocultando ferramentas por padrão e expondo apenas duas meta-ferramentas:

• tool_search – descreva o que você precisa e obtenha de volta as ferramentas mais relevantes.
• call_tool: invoque qualquer ferramenta descoberta pelo nome.

Você controla como as ferramentas são exibidas.

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

Saiba mais: Pesquisa de ferramentas (versão prévia).

Habilidades (versão prévia)

As ferramentas definem o que um agente pode fazer. As habilidades definem como ela executa uma tarefa.

• Pacotes de habilidades reutilizáveis e fluxos de trabalhos de diversas etapas como recursos que os agentes podem invocar como qualquer outra ferramenta. Por exemplo, uma habilidade pode gerar um relatório formatado, executar um fluxo de trabalho de triagem ou orquestrar uma sequência de chamadas de ferramenta.

• As habilidades são versionadas e imutáveis. Você pode anexar uma versão de habilidade específica a uma caixa de ferramentas para garantir um comportamento consistente e previsível entre ambientes.

• As habilidades reduzem a configuração necessária para usar fluxos de trabalho compartilhados. Os agentes descobrem e carregam habilidades automaticamente por meio de recursos do MCP na inicialização.

Consulte Habilidades (versão prévia).

Ferramentas com suporte

Há suporte para as ferramentas a seguir.

Introdução

• Crie e gerencie uma caixa de ferramentas no Foundry – configure uma caixa de ferramentas e integre-a ao seu agente.
• Início rápido da caixa de ferramentas – crie uma caixa de ferramentas e use-a com um agente hospedado de ponta a ponta.