翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# リモート A2A エージェントの接続
<a name="configuring-integrations-and-knowledge-connecting-remote-a2a-agents"></a>

リモートエージェントは、エージェント間 (A2A) プロトコルを実装する外部エージェントにタスクを委任することで、 AWS DevOps エージェントの調査機能を拡張します。 Agent-to-Agent リモートエージェントを接続すると、 AWS DevOps Agent は調査サブタスクを割り当て、その結果を全体的な調査に組み込むことができます。このガイドでは、リモートエージェントを AWS DevOps エージェントに接続する方法について説明します。

**注:** リモート A2A エージェントは現在、インシデント調査でのみサポートされています。

## 要件
<a name="requirements"></a>

リモートエージェントを接続する前に、エージェントが次の要件を満たしていることを確認してください。
+ **A2A プロトコルのサポート** – エージェントは [Agent-to-Agent (A2A) プロトコル](https://a2a-protocol.org/latest/specification/) (JSONRPC または HTTP\+JSON バインディング) を実装し、アクセス可能な URL で有効なエージェントカードを提供する必要があります。エージェントカードは、エージェントとの通信方法を AWS DevOps エージェントに伝えます。エージェントカードのフェッチには、エージェントの呼び出しに使用したのと同じ認証情報が使用されます。次のエージェントカードフィールドは必須です。
  + name**** – エージェントを識別する一意の名前
  + description**** – エージェントの機能の説明。 AWS DevOps Agent はこれを使用して、特定のサブタスクに最適なリモートエージェントを決定します。
  + **supportedInterfaces** – 呼び出しエンドポイント URL、プロトコルバインディング (`JSONRPC` または `HTTP+JSON`)、およびプロトコルバージョンを宣言します
  + **機能** – エージェントがストリーミングレスポンスをサポートしているかどうかを示すオブジェクト
  + **スキル** – エージェントの特定の機能を説明する配列。 AWS DevOps Agent はスキルを使用してタスクを最も適切なリモートエージェントにルーティングします。
+ **認証のサポート** – リモートエージェントは、ベアラートークン、OAuth クライアント認証情報、API キー、または AWS 署名バージョン 4 (SigV4) のいずれかの認証方法をサポートする必要があります。

## セキュリティに関する考慮事項
<a name="security-considerations"></a>

リモートエージェントを AWS DevOps エージェントに接続するときは、次のセキュリティ面を考慮してください。
+ **読み取り専用エージェント** – リモートエージェントは、調査とデータ収集のみを目的として設計する必要があります。リモートエージェントが本番稼働用システムに対して書き込みオペレーションや変更を実行しないようにします。
+ **プロンプトインジェクションリスク** – リモートエージェントは、プロンプトインジェクション攻撃のリスクをさらに増やす可能性があります。詳細については、[「プロンプトインジェクション保護: AWS DevOps エージェントセキュリティ](aws-devops-agent-security.md)」を参照してください。

プロンプトインジェクションと責任共有モデルの詳細については、[AWS DevOps エージェントセキュリティ](aws-devops-agent-security.md)「」を参照してください。

## リモートエージェントの登録 (アカウントレベル)
<a name="registering-a-remote-agent-account-level"></a>

リモートエージェントは AWS アカウントレベルで登録され、そのアカウントのすべてのエージェントスペース間で共有されます。

### ステップ 1: リモートエージェントを設定する
<a name="step-1-configure-remote-agent"></a>

1.  AWS マネジメントコンソールにサインインする

1.  AWS DevOps エージェントコンソールに移動する

1. **機能プロバイダー**ページに移動する (サイドナビゲーションからアクセス可能)

1. **「利用可能な**プロバイダー」セクションで**リモートエージェント**を検索し、**「登録**」をクリックします。

1. **リモートエージェントの設定**ページで、エージェントの詳細と認証設定を入力します。

**エージェントの詳細:**
+ **名前** – このリモートエージェントの一意の名前
+ **エージェントカードエンドポイント** – リモートエージェントのエージェントカードの HTTPS URL。 AWS DevOps エージェントはこの URL を取得してエージェントの機能を検出し、エンドポイントを呼び出します。
+ **説明** (オプション) – エージェントの目的を特定するのに役立つ説明を追加します。

**認証方法:**

次のいずれかの認証方法を選択します。

**API キー** – カスタムヘッダーで送信された静的 API キーを使用して認証します。

1. **API キー名** – API キーのわかりやすい名前

1. **API キーヘッダー** – サービスで想定されるヘッダー名 (例: `x-api-key`)

1. **API キー値** – サービスで認証するための API キー値

**ベアラートークン** – ベアラートークン (RFC 6750) を使用して認証します。

1. **トークン** – ベアラートークン値

**OAuth クライアント認証情報** – OAuth 2.0 クライアント認証情報付与フローを使用して認証します。

1. **クライアント ID** – OAuth クライアントのクライアント ID を入力します。

1. **クライアントシークレット** – OAuth クライアントのクライアントシークレットを入力します。

1. **Exchange URL** – OAuth トークン交換エンドポイント URL を入力します。

1. **スコープの追加** – 認証用の OAuth スコープの追加

**AWS SigV4** – AWS 署名バージョン 4 を使用して認証します。

1. **IAM ロールの設定** – 次のいずれかのオプションを選択します。
   + **既存のロールを使用する** – ドロップダウンから既存の IAM ロールを選択します。ロールには、 AWS DevOps エージェントサービスプリンシパルがロールを引き受けることを許可する信頼ポリシーが必要です ([SigV4認証用の IAM ロールの作成](configuring-integrations-and-knowledge-connecting-mcp-servers.html#creating-an-iam-role-for-sigv4-authentication)」を参照）。
   + **新しいロールを手動で作成する** – コンソールに表示されるstep-by-step手順に従って、正しい信頼ポリシーを持つ新しい IAM ロールを作成します。

1. **AWS リージョン** – SigV4 署名の AWS リージョンを入力します (例: `us-east-1`)

1. **サービス名** – SigV4 署名 AWS のサービス名を入力します (API Gateway `execute-api` の場合は 、Amazon Bedrock AgentCore `bedrock-agentcore`の場合は など）。

1. **[次へ]** をクリックします。

### ステップ 2: 確認して登録する
<a name="step-2-review-and-register"></a>

1. すべてのリモートエージェント設定の詳細を確認する

1. **登録**をクリックして登録を完了します

1. AWS DevOps Agent はエージェントカードを取得して接続を検証します

1. 検証が成功すると、リモートエージェントはアカウントレベルで登録されます。

## リモートエージェントとエージェントスペースの関連付け
<a name="associating-remote-agents-with-an-agent-space"></a>

アカウントレベルでリモートエージェントを登録したら、それを特定のエージェントスペースに関連付けることができます。

1.  AWS DevOps エージェントコンソールで、エージェントスペースを選択します。

1. **機能**タブに移動する

1. **リモートエージェント**セクションで、**追加**をクリックします。

1. このエージェントスペースに接続する登録済みリモートエージェントを選択します。

1. **追加**をクリックして、リモートエージェントをエージェントスペースに関連付けます。

AWS DevOps エージェントは、このエージェントスペースのリモートエージェントに調査サブタスクを委任できるようになりました。

## リモートエージェント接続の管理
<a name="managing-remote-agent-connections"></a>

**接続されたエージェントの表示** – エージェントスペースに接続されているすべてのリモートエージェントを表示するには、エージェントスペースを選択し、**機能**タブに移動し、**リモートエージェント**セクションを確認します。

**リモートエージェント接続の削除** – エージェントスペースからリモートエージェントを切断するには、リモートエージェントセクションで**エージェント**を選択し、**削除**をクリックします。リモートエージェント登録を完全に削除するには、まずすべてのエージェントスペースから削除し、**次に機能プロバイダー**に移動して**登録解除**をクリックします。

**認証情報の更新** – 認証情報を更新する必要がある場合は、リモートエージェントを再登録する必要があります。 AWS DevOps エージェントコンソールの **Capability Providers** ページに移動し、リモートエージェントを見つけ、アクティブな関連付けを削除して、**登録解除**をクリックします。次に、新しい認証情報でリモートエージェントを登録し、エージェントスペースと必要な関連付けを再作成します。

## 関連トピック
<a name="related-topics"></a>
+ [MCP サーバーの接続](configuring-integrations-and-knowledge-connecting-mcp-servers.md)
+ [AWS DevOps エージェントセキュリティ](aws-devops-agent-security.md)
+ [エージェントスペースの作成](getting-started-with-aws-devops-agent-creating-an-agent-space.md)