Conecte o Amazon Bedrock ao Microsoft Agent 365

Use este guia para conectar o Amazon Bedrock Agents Classic ou o Amazon Bedrock AgentCore ao Microsoft Agent 365.

Antes de começar

  • Confirme se o administrador de IA do Agent 365 pode criar conexões no Centro de administração do Microsoft 365.
  • Peça ao administrador da plataforma um ID da chave de acesso AWS e uma chave secreta de acesso.
  • Identifique as Regiões AWS que contêm os agentes que você deseja sincronizar.
  • Conceda apenas as permissões necessárias para os ambientes que você usa.

Permissões necessárias para sincronização

Para Agents Classic, conceda:

bedrock:ListAgents
bedrock:GetAgent
ec2:DescribeRegions

Para o AgentCore, conceda:

bedrock-agentcore:ListHarnesses
bedrock-agentcore:GetHarness
bedrock-agentcore:ListAgentRuntimes
bedrock-agentcore:GetAgentRuntime
ec2:DescribeRegions

bedrock:ListAgents e as operações de listagem do AgentCore descobrem agentes nas regiões selecionadas. As operações GET recuperam os detalhes do agente. Os runtimes do AgentCore que pertencem a um harness são ignorados para que um agente não seja listado duas vezes.

Configurar a atividade Amazon Bedrock Classic

Para coletar atividades do Agents Classic:

  1. Ative a captura de rastreamento para cada agente no console do Amazon Bedrock.
  2. Selecione um bucket de atividades para o S3.
  3. Armazene a atividade em observability-store/<agent-id>/, onde <agent-id> é o ID do agente Bedrock.
  4. Conceder s3:ListBucket no bucket de atividades.
  5. Conceder s3:GetObject em objetos no bucket de atividades.

Agente 365 lê atividade. Ele não invoca agentes, não grava registros de atividade nem exclui registros de atividade.

Se o bucket usa uma chave gerenciada pelo cliente, também conceda kms:Decrypt para essa chave.

Configurar a atividade do Amazon Bedrock AgentCore

A atividade do AgentCore é armazenada nos Logs do Amazon CloudWatch. Grant:

logs:StartQuery
logs:GetQueryResults

Conceda logs:DescribeLogGroups para permitir que o Agent 365 encontre pontos de extremidade de agentes personalizados. Sem ele, apenas o endpoint padrão é lido.

Ative a Busca de Transações no console Amazon CloudWatch. A atividade do AgentCore só pode ser consultada após a Busca de Transações ser ativada para a conta AWS.

Permissões opcionais

Conceda essas permissões apenas quando a conexão precisar dos detalhes correspondentes:

Capability Permissions
Mostrar ferramentas, colaboradores e fontes de conhecimento clássicas bedrock:ListAgentActionGroups, bedrock:GetAgentActionGroup, bedrock:ListAgentCollaborators, bedrock:ListAgentKnowledgeBases, bedrock:ListDataSources, bedrock:GetDataSource
Mostrar ferramentas do AgentCore, servidores MCP e agentes conectados bedrock-agentcore:GetGateway, bedrock-agentcore:ListGatewayTargets, bedrock-agentcore:GetGatewayTarget
Conecte todas as contas em uma organização AWS organizations:ListAccounts, sts:AssumeRole

Não conceda permissão de exclusão para uma conexão de somente leitura. Se você conceder bedrock:DeleteAgent, bedrock-agentcore:DeleteHarness, ou bedrock-agentcore:DeleteAgentRuntime, o Agente 365 pode remover o agente correspondente quando um administrador executar explicitamente essa ação.

Criar a conexão

  1. Abra o Centro de administração do Microsoft 365.
  2. Selecionar Agentes>Todos os Agentes.
  3. Nas plataformas conectadas, selecione Gerenciar.
  4. Selecione + Conecte uma plataforma e escolha Amazon Bedrock.
  5. Insira o nome da conexão, o ID da chave de acesso da AWS, a chave de acesso secreta e as Regiões selecionadas.
  6. Valide as credenciais.
  7. Salve a conexão.
  8. Selecione Sincronizar agentes.

Verificar a conexão

Abra a conexão e verifique o status da sincronização e o número de agentes. Abra um agente importado para verificar seus metadados. Para observabilidade, abra o agente e selecione Atividade após configurar a plataforma de origem e a atividade estiver disponível.

Troubleshoot

Sintoma Causa provável Resolução
Falha na validação da conexão Credenciais ausentes ec2:DescribeRegions, inválidas ou desativadas Confirme as credenciais e conceda ec2:DescribeRegions
Os agentes possuem metadados limitados Está faltando bedrock:GetAgent ou a operação get do AgentCore Conceda a permissão de obtenção relevante.
Agentes clássicos não têm atividade Captura de rastreamento incorreta, localização do bucket, caminho do bucket ou permissões do S3 Ative a captura de rastreio e verifique as permissões do bucket e do objeto.
Agentes AgentCore não têm atividade Falta de permissões para pesquisar transações ou acessar os logs do CloudWatch Ative a Busca de Transações e conceda logs:StartQuery e logs:GetQueryResults.
A atividade do AgentCore está incompleta Faltando logs:DescribeLogGroups Conceda a permissão quando forem usados endpoints personalizados.

Para problemas de conexão que não sejam específicos da Amazon Bedrock, veja Solucionar problemas em plataformas conectadas.

  • Última atualização a