Collega Amazon Bedrock a Microsoft Agent 365

Usa questa guida per collegare Amazon Bedrock Agents Classic o Amazon Bedrock AgentCore a Microsoft Agent 365.

Prima di iniziare

  • Conferma che l'amministratore AI di Agent 365 possa creare connessioni nel interfaccia di amministrazione di Microsoft 365.
  • Chiedi all'amministratore della piattaforma un ID chiave di accesso AWS e una chiave segreta.
  • Identifica le regioni AWS che contengono gli agenti che vuoi sincronizzare.
  • Concedi solo i permessi richiesti per gli ambienti che utilizzi.

Permessi richiesti per la sincronizzazione

Per agenti classici, concedi:

bedrock:ListAgents
bedrock:GetAgent
ec2:DescribeRegions

Per AgentCore, concedi:

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

bedrock:ListAgents e le operazioni di elenco AgentCore scoprono agenti nelle Regioni selezionate. Le operazioni GET leggono i dettagli dell'agente. I runtime di AgentCore che appartengono a un harness vengono ignorati, in modo che un agente non venga elencato due volte.

Configura l'attività Amazon Bedrock Classic

Per raccogliere attività da Agents Classic:

  1. Abilita l'acquisizione delle tracce per ogni agente nella console Amazon Bedrock.
  2. Seleziona un bucket di attività S3.
  3. Memorizza l'attività in observability-store/<agent-id>/, dove <agent-id> è l'ID dell'agente Bedrock.
  4. Concedi s3:ListBucket sul bucket degli impegni.
  5. Concedi s3:GetObject sugli oggetti nel bucket degli impegni.

Agent 365 legge l'attività. Non invoca agenti, non scrive record di attività né cancella record di attività.

Se il bucket utilizza una chiave gestita dal cliente, concedi kms:Decrypt anche su quella chiave.

Configura l'attività AgentCore di Amazon Bedrock

L'attività di AgentCore è memorizzata nei registri Amazon CloudWatch. Grant:

logs:StartQuery
logs:GetQueryResults

Concedi logs:DescribeLogGroups per consentire a Agent 365 di trovare gli endpoint personalizzati degli agenti. Senza di esso, viene letto solo l'endpoint predefinito.

Abilita la Ricerca Transazioni nella console Amazon CloudWatch. L'attività di AgentCore è consultabile solo dopo che la Transaction Search è stata abilitata per l'account AWS.

Autorizzazioni facoltative

Concedi questi permessi solo quando la connessione richiede i relativi dettagli:

Capability Permissions
Mostra strumenti classici, collaboratori e fonti di conoscenza bedrock:ListAgentActionGroups, bedrock:GetAgentActionGroup, bedrock:ListAgentCollaborators, bedrock:ListAgentKnowledgeBases, bedrock:ListDataSources, bedrock:GetDataSource
Mostra gli strumenti AgentCore, i server MCP e gli agenti connessi bedrock-agentcore:GetGateway, bedrock-agentcore:ListGatewayTargets, bedrock-agentcore:GetGatewayTarget
Collega ogni account in un'organizzazione AWS organizations:ListAccounts, sts:AssumeRole

Non concedere permessi di cancellazione per una connessione in sola lettura. Se concedi bedrock:DeleteAgent, bedrock-agentcore:DeleteHarness, o bedrock-agentcore:DeleteAgentRuntime, l'Agente 365 può rimuovere l'agente corrispondente quando un amministratore esegue esplicitamente quell'azione.

Creare la connessione

  1. Apri l'interfaccia di amministrazione di Microsoft 365.
  2. Seleziona agenti>Tutti gli agenti.
  3. Nelle piattaforme connesse, seleziona Gestisci.
  4. Seleziona + Collega una piattaforma e scegli Amazon Bedrock.
  5. Inserisci il nome della connessione, l'ID della chiave di accesso AWS, la chiave di accesso segreta e le regioni selezionate.
  6. Convalidare le credenziali.
  7. Salva la connessione.
  8. Seleziona agenti di sincronizzazione.

Verificare la connessione

Apri la connessione e controlla lo stato della sincronizzazione e il numero di agenti. Apri un agente importato per verificarne i metadati. Per l'osservabilità, apri l'agente e seleziona Attività dopo aver configurato la piattaforma sorgente e l'attività è disponibile.

Troubleshoot

Sintomo Causa possibile Resolution
Fallimento della validazione della connessione Credenziali mancanti ec2:DescribeRegions, invalide o disabilitate Conferma le credenziali e concedi ec2:DescribeRegions.
Gli agenti hanno metadati limitati Scomparso bedrock:GetAgent o l'AgentCore si attiva Concedi l'autorizzazione get pertinente.
Gli agenti classici non hanno attività Errore di cattura delle tracce, posizione del bucket, percorso del bucket o permessi S3 Abilita la cattura delle tracce e verifica i permessi del bucket e dell'oggetto.
Gli agenti AgentCore non hanno attività Autorizzazioni mancanti per Ricerca transazioni o per i registri di CloudWatch Logs Abilita la Ricerca Transazioni e concede logs:StartQuery e logs:GetQueryResults.
L'attività di AgentCore è incompleta Mancante logs:DescribeLogGroups Concedi il permesso quando vengono utilizzati endpoint personalizzati.

Per problemi di connessione che non sono specifici di Amazon Bedrock, vedi Risoluzione dei problemi delle piattaforme connesse.

  • Ultimo aggiornamento: