エージェント 2: エージェントの認証

Integration Service をリモートの Agent2Agent (A2A) エージェントに接続するには、エージェントのサービス URL と、エージェントに必要な認証の種類の資格情報を入力します。

Agent 2 Agent の各エージェント接続は 1 つのリモート エージェントを指します。Maestro から呼び出すすべてのエージェントのコネクションを作成します。

前提条件

• リモート エージェントが リモート エージェントの要件を満たしている。
• サービス URL として使用されるエージェントのベース URL です。ベース URL のみを入力し、パスや末尾にスラッシュを付けないでください。コネクタは、 /.well-known/agent-card.jsonなどの A2A パス自体を追加します。
• エージェントに必要な認証の種類の資格情報です。エージェントは、サポートされているセキュリティ スキームをエージェント カードで宣言します。

認証の種類

すべての認証の種類にはサービス URL が必要です。その他のフィールドは認証の種類によって異なります。

認証の種類	フィールド
基本認証	ユーザー名、 パスワード (任意)、 認証検証 API (任意)
API キー	パラメーター名、 値、 追加先 (ヘッダー または クエリ、既定の ヘッダー)、 認証検証 API (任意)
個人用アクセス トークン	トークン プレフィックス (既定 Bearer)、 トークン、 認証検証 API (任意)
OAuth 2.0 の認可コード	クライアント ID、 クライアント シークレット、 認可 URL、 トークン URL、 スコープ (任意)
OAuth 2.0 クライアント資格情報	クライアント ID、 クライアント シークレット、 トークン URL、 スコープ (任意)
OAuth 2.0 パスワード	クライアント ID、 クライアント シークレット、 認可 URL、 トークン URL、 ユーザー名、 パスワード (任意)、 スコープ (任意)
OAuth 2.0 JWT ベアラー	クライアント ID、 クライアント シークレット、 認可 URL、 トークン URL、 JWT Base64 でエンコードされたキー、 スコープ (任意)

以下のフィールドには、追加のコンテキストが必要です。

• パラメーター名: API キーを保持するヘッダーまたはクエリ パラメーターの正確な名前です (例: X-API-Key)。
• トークン プレフィックス: Authorization ヘッダーでトークンの前に追加されるプレフィックスです。エージェントがプレフィックスなしのトークンを予期している場合は、空のままにします。
• 認証検証 API: 資格情報が有効な場合に成功した応答を返す相対パスです (例: /api/v1/me)。
• 範囲: エージェントの認可サーバーから要求される OAuth スコープです。エージェント カードで宣言されています。複数のスコープは、スペースまたはコンマで区切ります。認可サーバーの既定のスコープを使用する場合は、空のままにします。
• JWT Base64 でエンコードされたキー: JWT の署名に使用される Base64 でエンコードされた秘密キーです。ID プロバイダーの指示に従って、メッセージを生成してエンコードします。

Agent 2 Agent 接続を追加します

1. 製品起動ツールから [ Orchestrator ] を選択します。

2. フォルダーを選択して [ コネクション ] タブに移動します。

3. [ コネクションを追加] を選択します。

4. 接続の作成ページを開くには、リストからAgent 2 Agent コネクタを選択します。検索バーを使用してコネクタを検索できます。

5. [ サービス URL] に、エージェントのベース URL を入力します。

6. [ 認証の種類] を選択します。

7. 選択した認証の種類に必要なフィールドを入力します。

   利用可能な場合は、フィールドの横にあるメニューを選択し、[ 資格情報アセットを使用 ] または [ Orchestrator アセットを使用 ] を選択して、値を直接入力するのではなく Orchestrator アセットを参照します。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。

8. [接続] を選択します。

コネクションは、エージェント カードの [ name ] フィールドで宣言されているとおり、エージェントにちなんで作成され、名前が付けられます。