Gerenciar Gateway de Ferramentas

Conecte o Azure AI Gateway ou um gateway LiteLLM ao Microsoft Agent 365 para descobrir e governar os servidores Model Context Protocol (MCP) registrados no gateway. O Agent 365 traz os servidores MCP registrados para a experiência das ferramentas, onde os administradores podem revisá-los e governá-los, monitorar a atividade dos servidores MCP e configurar proteções de segurança suportadas para chamadas de ferramentas MCP.

O Agent 365 atualmente suporta o Azure AI Gateway e o LiteLLM. Cada gateway requer seu próprio processo de conexão e configuração.

Use a seção do seu gateway para concluir a configuração da conexão e da proteção. Depois, use as etapas compartilhadas de descoberta e governança:

Important

  • Este recurso está em versão preliminar.
  • As versões prévias do recurso não foram criadas para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos estão sujeitos a termos de uso complementares e estão disponíveis antes do lançamento oficial, de maneira que os clientes possam obter acesso antecipado e fazer comentários.

Conecte o Azure AI Gateway

Use esta seção para conectar o Azure AI Gateway e, se necessário, configurar a proteção contra chamadas de ferramentas.

Pré-requisitos do Azure AI Gateway

Antes de conectar o Azure AI Gateway, certifique-se de que o gateway está configurado, que você tem a função de Administrador Global no Microsoft 365 e que seus servidores MCP estão registrados. Para pré-requisitos detalhados, configuração e orientações de governança, veja Governar ferramentas com Microsoft Agent 365 e Gerenciamento de API do Azure (prévia).

Conecte o gateway do Azure ao Microsoft 365

Note

Você precisa ter o papel de Administrador Global para conectar o Azure AI Gateway. O papel de Administrador de IA não suporta essa operação.

  1. Entre no Centro de administração do Microsoft 365 como Administrador Global.
  2. Vá para Agentes>.
  3. Selecione Gateways.
  4. Ao lado do Microsoft Azure, ative o botão de alternância para conectar um serviço Gerenciamento de API do Azure ou Azure AI Gateway.
  5. Examine e aceite as permissões solicitadas.

Você precisa fornecer consentimento uma vez por inquilino, e isso se aplica a todos os servidores MCP no gateway conectado. Servidores individuais não exigem consentimento separado.

Note

Depois que você conecta o gateway, o Agent 365 descobre os servidores MCP registrados nele e os disponibiliza na página de Ferramentas. A descoberta pode levar alguns minutos. Vá para Agentes>Ferramentas e atualize a página para visualizar os servidores MCP descobertos. Para gerenciar os servidores MCP descobertos, veja Descobrir e governar servidores MCP.

Proteja chamadas de ferramentas Azure AI Gateway com Microsoft Defender

Para proteger chamadas de ferramentas através do Azure AI Gateway, configure a política de proteção contra ameaças da ferramenta Agent 365 no portal do AI Gateway. A política utiliza Microsoft Defender e Microsoft Purview para avaliar solicitações de ferramentas e resultados.

Para pré-requisitos e etapas específicas de configuração do gateway, veja Proteger chamadas de ferramenta com Defender e Purview na camada do AI Gateway (prévia). Essa proteção requer a camada de AI Gateway no Gerenciamento de API do Azure e um token de usuário Microsoft Entra ID delegado. Chamadas de serviço a serviço somente de aplicativo não são suportadas.

Para monitorar a atividade do servidor MCP, veja Monitorar e observar a atividade do servidor MCP.

Conectar LiteLLM

O Microsoft Agent 365 permite que você se conecte a um gateway LiteLLM para descobrir e governar seus servidores MCP registrados e proteger as chamadas de ferramentas MCP. LiteLLM é um gateway de IA de terceiros e não é construído ou suportado pela Microsoft. Para informações sobre o LiteLLM e o registro de servidores MCP com seu gateway, veja o gateway LiteLLM na documentação do LiteLLM.

Pré-requisitos do LiteLLM

Antes de começar, verifique se:

  • Você tem acesso a um gateway LiteLLM com servidores MCP registrados.
  • Você tem um nome de gateway, URL do gateway e chave de API para o proxy LiteLLM.
  • Você tem a função de Administrador Global no Microsoft 365 para acessar o Centro de administração do Microsoft 365. Esse requisito se aplica ao Microsoft 365, não a funções no LiteLLM.

As seções a seguir explicam como conectar o gateway LiteLLM e configurar a proteção para chamadas de ferramentas MCP. Após a configuração, use os passos compartilhados para descobrir e governar servidores MCP.

Conecte o gateway LiteLLM ao Microsoft 365

  1. Faça login no Centro de administração do Microsoft 365 com a função de administrador do Microsoft 365 listada nos pré-requisitos.
  2. Vá para Agentes>Configurações>Gateways.
  3. Em LiteLLM Gateway, selecione Conectar gateway.
  4. Digite as informações a seguir:
    • Nome do gateway: Um nome amigável para identificar esse gateway no Centro de administração do Microsoft 365.
    • URL do Gateway: A URL do seu proxy LiteLLM.
    • Chave API: Uma chave API para o proxy LiteLLM.

Você precisa fornecer consentimento uma vez por tenant, e isso se aplica a todos os servidores MCP no gateway conectado. Servidores individuais não exigem consentimento separado.

Note

Depois que você conecta o gateway LiteLLM, o Agente 365 descobre os servidores MCP registrados nele e os disponibiliza na página de Ferramentas . A descoberta pode levar alguns minutos. Vá para Agentes>Ferramentas e atualize a página para visualizar os servidores MCP descobertos. Para gerenciar os servidores MCP descobertos, veja Descobrir e governar servidores MCP

Proteger chamadas de ferramenta MCP do LiteLLM

O Microsoft Agent 365 Guardrails usa o Microsoft Defender para avaliar chamadas de ferramentas MCP feitas pelo LiteLLM e fornecer proteção contra ameaças em tempo de execução.

Configure a proteção nesta ordem:

  1. Crie ou identifique o aplicativo Microsoft Entra que o LiteLLM usa para o gateway.
  2. Complete a configuração necessária do Microsoft Entra.
  3. Complete a configuração correspondente no LiteLLM.

Criar o registro do aplicativo

  1. No centro de administração do Microsoft Entra, mude para o tenant de destino.
  2. Vá para Registros de aplicativo e, em seguida, selecione Novo registro.
  3. Para o nome da aplicação, insira litellm-enterprise-api.
  4. Para tipos de conta com suporte, selecione contas somente neste diretório organizacional.
  5. Selecione Registrar.
  6. Copie o ID da aplicação (cliente) e mantenha-o como GATEWAY_API_APP_ID na configuração do LiteLLM.

Note

Se o gateway já tiver uma aplicação API apropriada, reutilize a aplicação existente em vez de criar outra. Preserve seus papéis, atribuições, credenciais e permissões não relacionadas existentes.

Configurar LiteLLM

Depois de concluir a configuração do Microsoft Entra, use GATEWAY_API_APP_ID para completar a configuração correspondente do gateway. Para orientações de configuração do LiteLLM, veja o gateway LiteLLM na documentação do LiteLLM.

Descubra e administre servidores MCP

Depois de conectar o Azure AI Gateway ou LiteLLM, você pode acessar servidores MCP que se registram no gateway conectado através da experiência Tools no Centro de administração do Microsoft 365. Essas etapas de descoberta e governança são comuns a ambos os gateways.

  1. No Centro de administração do Microsoft 365, acesse Agentes>Ferramentas.
  2. Filtre a lista por origem e então selecione o gateway cujos servidores MCP você quer visualizar.
  3. Selecione um servidor MCP para revisar seus detalhes e as ferramentas que ele expõe.

Você pode bloquear ou permitir um servidor MCP para controlar sua disponibilidade. Para o procedimento comum de governança, veja Bloquear ou permitir um servidor MCP.

Para servidores MCP suportados, você também pode gerenciar a disponibilidade de ferramentas individuais. Para obter mais informações, consulte Gerenciar ferramentas individuais em um servidor MCP.

  • Última atualização em