A2A Connector 0.1.0 - ベータリファレンス

Agent2Agent (A2A) 用 Anypoint Connector (A2A Connector) は、LLM エージェントに A2A プロトコルサポートを提供し、エージェントが他のエージェントと会話できるようにします。

Agent2Agent (A2A) 用 Anypoint Connector は、 Salesforce.com の契約に関するページ​のベータサービス規約か、お客様が署名された Unified Pilot Agreement、および、および 「製品規約ディレクトリ」​の非正式リリースの生成 AI と非正式リリースのクレジット消費条件に従うベータサービスです。外部システムまたはサービスでのこのベータコネクタの使用は、​Mule メッセージ​を消費します。また、お客様独自の裁量で使用するものとします。

設定

Client (クライアント)

要求を開始し、A2A サーバーが提供するサービスを使用するアプリケーションまたは AI システム。これにより、Mule アプリケーションは非 A2A 「ヘッド」エージェントと A2A 「ノード」エージェント間の A2A ブローカーとして機能できるようになります。

パラメーター

名前 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Name (名前)

String (文字列)

この設定の参照に使用される ID。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

接続種別

クライアント接続
パラメーター
名前 説明 デフォルト値 必須

Server Url (サーバー URL)

String (文字列)

対象 A2A サーバーのベース URL。

x

Request Timeout (要求タイムアウト)

Number (数値)

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Request Timeout (要求タイムアウト)]​ 項目の時間単位。

SECONDS

Authentication (認証)

HttpRequestAuthentication

Tls Context (TLS コンテキスト)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。


サーバー

A2A サーバーは、HTTP(S) エンドポイントを公開し、他の AI エージェントと対話するための A2A プロトコルメソッドを実装するリモートエージェントとして機能します。これにより、Mule ベースのエージェントは A2A プロトコルに準拠した要求を受信して​​応答できるようになります。

パラメーター

名前 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Card (カード)

x

Name (名前)

String (文字列)

この設定の参照に使用される ID。

x

Task History Enabled (タスク履歴有効)

Boolean (ブール)

タスク履歴の取得を有効にするには、​true​ に設定します。タスク履歴は、メッセージオブジェクトとして保存されます。

false

Default Max History Length (デフォルトの最大履歴長)

Number (数値)

保存するタスク履歴オブジェクトの最大数。

Task History Object Store (タスク履歴オブジェクトストア)

ObjectStore

接続種別

Server Connection (サーバー接続)
パラメーター
名前 説明 デフォルト値 必須

Listener Config (リスナー設定)

String (文字列)

インバウンドエンドポイントを公開するために使用される ​<http:listener-config>​ への参照。

x

Agent Path (エージェントパス)

String (文字列)

エージェントカードが配置されているURL。

x

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

関連付けられたソース

サポートされている操作

Cancel Task

<a2a:cancel-task>

一意の識別子で指定されたタスクをキャンセルします。以前に開始されたタスクを停止するために使用されます。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Task Id (タスク ID)

Any (任意)

タスクの一意の識別子。

#[payload]

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

Error Mapping (エラーのマッピング)

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

Type (型)

Any (任意)

Attributes Type (属性型)

次の設定の場合

スロー

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR​

  • A2A:INVALID_PARAMS​

  • A2A:INVALID_REQUEST​

  • A2A:JSON_RPC_ERROR​

  • A2A:METHOD_NOT_FOUND​

  • A2A:PARSE_ERROR​

  • A2A:REQUEST_TIMEOUT​

  • A2A:RETRY_EXHAUSTED​

  • A2A:SERVER_ERROR​

  • A2A:UNAUTHORIZED

Get Task

<a2a:get-task>

指定されたクエリに基づいてタスクに関する情報を取得します。これにより、別のエージェントからタスクの状況または詳細を取得できます。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Task Query (タスククエリ)

Any (任意)

#[payload]

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

Error Mapping (エラーのマッピング)

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

Type (型)

Any (任意)

Attributes Type (属性型)

次の設定の場合

スロー

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR​

  • A2A:INVALID_PARAMS​

  • A2A:INVALID_REQUEST​

  • A2A:JSON_RPC_ERROR​

  • A2A:METHOD_NOT_FOUND​

  • A2A:PARSE_ERROR​

  • A2A:REQUEST_TIMEOUT​

  • A2A:RETRY_EXHAUSTED​

  • A2A:SERVER_ERROR​

  • A2A:UNAUTHORIZED

Send Task

<a2a:send-task>

別のエージェントにタスクを送信します。リモート A2A サーバーへの新しいタスク要求を開始します。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Task (タスク)

Any (任意)

#[payload]

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

Error Mapping (エラーのマッピング)

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

Type (型)

Any (任意)

Attributes Type (属性型)

次の設定の場合

スロー

  • A2A:CONNECTIVITY

  • A2A:INTERNAL_ERROR​

  • A2A:INVALID_PARAMS​

  • A2A:INVALID_REQUEST​

  • A2A:JSON_RPC_ERROR​

  • A2A:METHOD_NOT_FOUND​

  • A2A:PARSE_ERROR​

  • A2A:REQUEST_TIMEOUT​

  • A2A:RETRY_EXHAUSTED​

  • A2A:SERVER_ERROR​

  • A2A:UNAUTHORIZED

ソース

Task Listener

<a2a:task-listener>

Mule アプリケーションが他の AI エージェントからの A2A プロトコル準拠の受信要求をリスンして受信できるようにし、Mule ベースのエージェントが A2A サーバーとして機能してタスクに応答できるようにします。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Response (応答)

Any (任意)

#[payload]

Response Headers (レスポンスヘッダー)

Object (オブジェクト)

HTTP レスポンスヘッダー。

Error Status Code (エラー状況コード)

Number (数値)

応答の HTTP 状況コード。

500

出力

Type (型)

Any (任意)

Attributes Type (属性型)

次の設定の場合

TLS

Mule アプリケーションのセキュアな通信を提供するように TLS を設定します。

項目 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

TLS トラストストアを設定します。

Key Store (キーストア)

TLS キーストアを設定します。

Revocation Check (取り消し確認)

取り消し確認メカニズムを設定します。

Truststore (トラストストア)

TLS 用のトラストストアを設定します。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

ストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用する暗号化アルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、Mule では証明書の検証の実行を停止します。これを ​true​ に設定すると、接続が攻撃に対して脆弱になる可能性があります。

Keystore (キーストア)

TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開キーと公開証明書が格納されます。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Type (型)

String (文字列)

ストアの型。

Alias (別名)

String (文字列)

キーストアに複数の非公開キーが含まれている場合に使用するキーの別名。デフォルトでは、Mule はファイル内の最初のキーを使用します。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用する暗号化アルゴリズム。

Standard Revocation Check (標準の取り消し確認)

TLS 証明書の標準取り消し確認を設定します。

項目 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーン内で確認する要素:

  • true

証明書チェーンの最後の要素のみを確認します。

  • false

証明書チェーンのすべての要素を確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

証明書の有効性を確認する方法:

  • true

証明書失効リスト (CRL) で証明書の有効性を確認します。

  • false

オンライン証明書状況プロトコル (OCSP) を使用して証明書の有効性を確認します。

No Fallback (代替なし)

Boolean (ブール)

証明書の有効性を確認するための第 2 の方法を使用するかどうか:

  • true

[Prefer Crls (CRL を優先)]​ 項目で指定されていない方法 (第 2 の方法) を使用して証明書の有効性を確認します。

  • false

証明書の有効性を確認するための第 2 の方法を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合の処理:

  • true

検証エラーを回避します。

  • false

検証の失敗を許可します。

Custom OCSP Responder (カスタム OCSP レスポンダー)

証明書の取り消し確認のカスタム OCSP レスポンダーを設定します。

項目 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

OCSP 応答の署名証明書の別名。指定した場合、別名はトラストストアに存在する必要があります。

CRL File (CRL ファイル)

証明書失効リスト (CRL) ファイルの場所を指定します。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

Reconnection (再接続)

操作の再接続戦略を設定します。

項目 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

標準再接続戦略を設定し、再接続の頻度と、コネクタソースまたは操作で実行できる再接続の試行回数を指定します。

項目 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続を試行する頻度 (ミリ秒)。

Blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

Count (数)

Number (数値)

Mule アプリケーションで実行できる再接続の試行回数。

Reconnect Forever (繰り返し再接続)

Mule アプリケーションが実行されている間はコネクタソースや操作によって指定された頻度で再接続が試行される Forever 再接続戦略を設定します。

項目 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続を試行する頻度 (ミリ秒)。

Blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

Expiration Policy (有効期限ポリシー)

有効期限ポリシー戦略を設定します。

項目 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 項目の時間単位。

Response Attributes (応答属性)

項目 説明 デフォルト値 必須

Status Code (状況コード)

Number (数値)

応答の HTTP 状況コード。

x

Headers (ヘッダー)

Object (オブジェクト)

メッセージ内の HTTP ヘッダーのマッピング。

x

Reason Phrase (理由を示す語句)

String (文字列)

応答の HTTP の理由を示す語句。

Error Mapping (エラーのマッピング)

項目 説明 デフォルト値 必須

Source (ソース)

Enumeration (列挙)。次のいずれかになります。

  • ANY

  • REDELIVERY_EXHAUSTED​

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY​

  • SERVER_SECURITY​

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED​

  • TIMEOUT

Target (対象)

String (文字列)

x

Agent Card (エージェントカード)

項目 説明 デフォルト値 必須

Name (名前)

String (文字列)

エージェントの名前。

x

Url

String (文字列)

エージェントの A2A サービスのベース URL エンドポイント。本番では絶対 HTTPS URL である必要があります。

x

Version (バージョン)

String (文字列)

エージェントのバージョン。

x

Description (説明)

String (文字列)

エージェントの説明。

Skills (スキル)

x

Capabilities (機能)

Provider (プロバイダー)

Documentation Url (ドキュメント URL)

String (文字列)

エージェントのドキュメントの URL。

Agent Authentication (エージェント認証)

Default Input Modes (デフォルトの入力モード)

Array of String (文字列の配列)

エージェントがすべてのスキルで入力として受け入れる MIME タイプの配列。

Default Output Modes (デフォルトの出力モード)

Array of String (文字列の配列)

エージェントがすべてのスキルで出力として生成する MIME タイプの配列。

Agent Skill (エージェントスキル)

項目 説明 デフォルト値 必須

Id

String (文字列)

このエージェントのコンテキスト内でのこのスキルの一意の識別子。

x

Name (名前)

String (文字列)

スキルの名前。

x

Description (説明)

String (文字列)

スキルで実行する内容の説明。

Tags (タグ)

Array of String (文字列の配列)

エージェントの検出可能性に関するキーワードまたはカテゴリ。

Examples (例)

Array of String (文字列の配列)

プロンプト、入力、またはユースケースの例。例は、クライアントとエージェントがこのスキルの要求を作成するのに役立ちます。

Input Modes (入力モード)

Array of String (文字列の配列)

この特定のスキルのエージェントカード ​[Default Input Modes (デフォルトの入力モード)]​ を上書きします。

Output Modes (出力モード)

Array of String (文字列の配列)

この特定のスキルのエージェントカード ​[Default Output Modes (デフォルトの出力モード)]​ を上書きします。

Agent Capabilities (エージェント機能)

項目 説明 デフォルト値 必須

Streaming (ストリーミング)

Boolean (ブール)

SSE ストリーミングメソッドをサポートするには ​true​ に設定します。

false

Push Notifications (プッシュ通知)

Boolean (ブール)

プッシュ通知メソッドをサポートするには ​true​ に設定します。

false

State Transition History (状態の移行履歴)

Boolean (ブール)

false

Agent Provider (エージェントプロバイダー)

項目 説明 デフォルト値 必須

Organization (組織)

String (文字列)

組織またはエンティティの名前。

x

Url

String (文字列)

プロバイダーの Web サイトの URL。

Agent Authentication (エージェント認証)

項目 説明 デフォルト値 必須

Authentication (認証)

Array of String (文字列の配列)

x

Credentials (ログイン情報)

String (文字列)

Request Attributes (要求属性)

項目 説明 デフォルト値 必須

Query Params (クエリパラメーター)

Object (オブジェクト)

x

Headers (ヘッダー)

Object (オブジェクト)

メッセージ内の HTTP ヘッダーのマッピング。

x

Redelivery Policy (再配信ポリシー)

エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。

項目 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

REDELIVERY_EXHAUSTED​ エラーが返されるまでに、再配信された要求に失敗できる最大回数。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

Message Identifier (メッセージ識別子)

メッセージが再配信されたかどうかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

ObjectStore

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。

Redelivery Policy Message Identifier (再配信ポリシーメッセージ識別子)

再配信されたメッセージを識別する方法と、メッセージがいつ再配信されたのかを見つける方法を設定します。

項目 説明 デフォルト値 必須

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

true​ の場合、再配信されたメッセージの識別にセキュアハッシュアルゴリズムが使用されます。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。