Connectez Amazon Bedrock à Microsoft Agent 365

Utilisez ce guide pour connecter Amazon Bedrock Agents Classic ou Amazon Bedrock AgentCore à Microsoft Agent 365.

Avant de commencer

  • Confirmez que l’administrateur IA de l’Agent 365 peut créer des connexions dans le centre d’administration Microsoft 365 admin center.
  • Demandez à l’administrateur de la plateforme un identifiant de clé d’accès AWS et une clé d’accès secrète.
  • Identifiez les régions AWS qui contiennent les agents que vous souhaitez synchroniser.
  • N’accordez que les autorisations requises pour les environnements que vous utilisez.

Autorisations requises pour la synchronisation

Pour Agents Classic, accordez :

bedrock:ListAgents
bedrock:GetAgent
ec2:DescribeRegions

Pour AgentCore, accordez :

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

bedrock:ListAgents et les opérations de liste AgentCore découvrent les agents dans les régions sélectionnées. Les opérations de recherche lisent les détails de l’agent. Les environnements d’exécution AgentCore qui appartiennent à un environnement sont ignorés afin qu’un assistant ne soit pas répertorié deux fois.

Configurer l’activité Amazon Bedrock Classic

Pour recueillir les données d’activité d’Agents Classic :

  1. Activez la capture de trace pour chaque agent dans la console Amazon Bedrock.
  2. Sélectionnez un compartiment d’activités S3.
  3. Stockez l’activité sous observability-store/<agent-id>/, où <agent-id> correspond à l’ID de l’agent Bedrock.
  4. Accordez s3:ListBucket sur le bucket d’activité.
  5. Accorder s3:GetObject sur les objets du bucket d’activité.

Agent 365 lit l’activité. Il n’invoque pas d’agents, n’écrit pas d’enregistrements d’activité, ni ne supprime les enregistrements d’activité.

Si le compartiment utilise une clé gérée par le client, accordez également kms:Decrypt sur cette clé.

Configurer l’activité AgentCore d’Amazon Bedrock

L’activité AgentCore est stockée dans les journaux Amazon CloudWatch. Grant :

logs:StartQuery
logs:GetQueryResults

Accordez logs:DescribeLogGroups pour permettre à Agent 365 de trouver des points de terminaison d’agent personnalisés. Sans cela, seul le point d’extrémité par défaut est lu.

Activez la recherche de transactions sur la console Amazon CloudWatch. L’activité AgentCore n’est interrogeable qu’après avoir activé la recherche transactionnelle pour le compte AWS.

Autorisations facultatives

Accordez ces autorisations uniquement lorsque la connexion nécessite les détails correspondants :

Capability Permissions
Afficher les outils, collaborateurs et sources de connaissances classiques bedrock:ListAgentActionGroups, bedrock:GetAgentActionGroup, bedrock:ListAgentCollaborators, bedrock:ListAgentKnowledgeBases, bedrock:ListDataSources, bedrock:GetDataSource
Afficher les outils AgentCore, serveurs MCP et agents connectés bedrock-agentcore:GetGateway, bedrock-agentcore:ListGatewayTargets, bedrock-agentcore:GetGatewayTarget
Connectez tous les comptes dans une organisation AWS organizations:ListAccounts, sts:AssumeRole

N’accordez pas les permissions de suppression pour une connexion en lecture seule. Si vous accordez bedrock:DeleteAgent, bedrock-agentcore:DeleteHarness, ou bedrock-agentcore:DeleteAgentRuntime, l’Agent 365 peut retirer l’agent correspondant lorsqu’un administrateur effectue explicitement cette action.

Créer la connexion

  1. Ouvrez le centre d’administration Microsoft 365.
  2. Sélectionner les agents>Tous les agents.
  3. Dans les plateformes connectées, sélectionnez Gérer.
  4. Sélectionnez + Connectez une plateforme et choisissez Amazon Bedrock.
  5. Saisissez le nom de la connexion, l’identifiant de la clé d’accès AWS, la clé d’accès secrète et les régions sélectionnées.
  6. Validez les informations d’identification.
  7. Enregistrez la connexion.
  8. Sélectionnez Sync agents.

Vérifier la connexion

Ouvre la connexion et vérifie le statut de la synchronisation ainsi que le nombre d’agents. Ouvrez un agent importé pour vérifier ses métadonnées. Pour l’observabilité, ouvrez l’agent et sélectionnez Activité après avoir configuré la plateforme source et l’activité est disponible.

Troubleshoot

Symptôme Cause la plus probable Résolution
Échec de validation de connexion Identifiants manquants ec2:DescribeRegions, invalides ou désactivés Confirmez les identifiants et autorisez ec2:DescribeRegions.
Les agents ont des métadonnées limitées Manquant bedrock:GetAgent ou l’opération AgentCore Accordez l’autorisation « get » appropriée.
Les agents classiques n’ont aucune activité Capture des traces incorrecte, emplacement du bucket incorrect, chemin du bucket incorrect ou autorisations S3 incorrectes Activez la capture de trace et vérifiez les permissions de bucket et d’objet.
Les agents AgentCore n’ont aucune activité Autorisations Transaction Search ou CloudWatch Logs manquantes Activez la recherche de transaction et accordez logs:StartQuery et logs:GetQueryResults.
L’activité AgentCore est incomplète Manquant logs:DescribeLogGroups Accordez la permission lorsque des terminaux personnalisés sont utilisés.

Pour les problèmes de connexion qui ne sont pas spécifiques à Amazon Bedrock, consultez Résolution des problèmes liés aux plateformes connectées.

  • Dernière mise à jour :