このガイドを使って、Amazon Bedrock Agents ClassicまたはAmazon Bedrock AgentCoreをMicrosoft Agent 365に接続してください。
始める前の準備
- Agent 365のAI管理者がMicrosoft 365 管理センターで接続を作成できるか確認してください。
- プラットフォーム管理者にAWSアクセスキーIDとシークレットアクセスキーを依頼してください。
- 同期したいエージェントを含むAWSリージョンを特定してください。
- 使用する環境に必要な権限だけを付与してください。
同期に必要な権限
エージェント・クラシックの場合、以下の条件を付与します:
bedrock:ListAgents
bedrock:GetAgent
ec2:DescribeRegions
AgentCoreには以下の許可を与えてください:
bedrock-agentcore:ListHarnesses
bedrock-agentcore:GetHarness
bedrock-agentcore:ListAgentRuntimes
bedrock-agentcore:GetAgentRuntime
ec2:DescribeRegions
bedrock:ListAgents AgentCoreのリスト操作は、選択したリージョン内のエージェントを発見します。 取得操作では、エージェントの詳細を読み取ります。 ハーネスに属するAgentCoreのランタイムはスキップされ、エージェントが二重にリストされないようにします。
Amazon Bedrock Classicアクティビティの設定
エージェント・クラシックから活動を収集するには:
- Amazon Bedrockコンソールで各エージェントのトレースキャプチャを有効にしてください。
- S3アクティビティのバケットを選択してください。
-
observability-store/<agent-id>/の下で活動をストアし、<agent-id>はBedrockエージェントIDです。 - アクティビティ バケットの
s3:ListBucket権限付与。 - アクティビティバケット内のオブジェクトに
s3:GetObjectを付与します。
エージェント365が活動を検知。 エージェントを呼び出したり、アクティビティレコードを書き込んだり、アクティビティレコードを削除したりしません。
もしバケットが顧客管理キーを使用している場合は、そのキーにも kms:Decrypt を付与します。
Amazon Bedrock AgentCoreアクティビティの設定
AgentCoreのアクティビティはAmazon CloudWatchログに保存されます。 グラント:
logs:StartQuery
logs:GetQueryResults
Agent 365がカスタムエージェントエンドポイントを検出できるように logs:DescribeLogGroups 付与してください。 それがなければ、デフォルトのエンドポイントのみが読み取られます。
Amazon CloudWatchコンソールで トランザクション検索 を有効にしてください。 AgentCoreのアクティビティは、AWSアカウントでトランザクション検索が有効になってからのみクエリ可能になります。
オプション権限
これらの権限は、接続が対応する詳細を必要とする場合にのみ付与してください:
| 能力 | Permissions |
|---|---|
| Classic ツール、共同研究者、知識源を表示 |
bedrock:ListAgentActionGroups、 bedrock:GetAgentActionGroup、 bedrock:ListAgentCollaborators、 bedrock:ListAgentKnowledgeBases、 bedrock:ListDataSources、 bedrock:GetDataSource |
| AgentCoreツール、MCPサーバー、接続済みエージェントを表示 |
bedrock-agentcore:GetGateway、bedrock-agentcore:ListGatewayTargets、bedrock-agentcore:GetGatewayTarget |
| AWS組織内のすべてのアカウントを連携してください |
organizations:ListAccounts、sts:AssumeRole |
読み取り専用接続には削除権限を与えないでください。
bedrock:DeleteAgent、bedrock-agentcore:DeleteHarness、またはbedrock-agentcore:DeleteAgentRuntimeを付与した場合、管理者が明示的にその操作を行う際にエージェント365は対応するエージェントを削除できます。
接続の作成
- Microsoft 365 管理センターを開きます。
- Agents>All Agents を選択します。
- 接続プラットフォームで「管理」を選択します。
- + プラットフォームを接続 をクリックし、Amazon Bedrockを選択します。
- 接続名、AWSアクセスキーID、シークレットアクセスキー、選択したリージョンを入力します。
- 資格情報を検証します。
- 接続を保存します。
- 同期エージェントを選択します。
接続を確認する
接続を開き、同期状況とエージェント数を確認してください。 インポートしたエージェントを開いてメタデータを検証します。 観察可能性については、ソースプラットフォームを設定してアクティビティ が利用可能になった後に エージェントを開き、アクティビティを選択します。
Troubleshoot
| 症状: | 考えられる原因 | Resolution |
|---|---|---|
| 接続検証が失敗します |
ec2:DescribeRegions がありません、または認証情報が無効か無効化されています |
資格を確認して ec2:DescribeRegionsを許可してください。 |
| エージェントのメタデータは限られています |
bedrock:GetAgent または AgentCore の get 操作が不足しています |
該当する取得権限を付与してください。 |
| クラシックエージェントは活動がありません | 誤ったトレースキャプチャ、バケットの位置、バケットパス、またはS3権限の誤り | トレースキャプチャを有効にし、バケットとオブジェクトの権限を検証します。 |
| AgentCoreエージェントにはアクティビティがありません | トランザクション検索やCloudWatchのログ権限が欠如している | トランザクション検索を有効にし、 logs:StartQuery と logs:GetQueryResultsを付与します。 |
| AgentCoreの活動は不完全です | 行方不明 logs:DescribeLogGroups |
カスタムエンドポイントを使用する場合は権限を付与します。 |
Amazon Bedrock特有でない接続問題については、「 接続プラットフォームのトラブルシューティング」を参照してください。