SendMessageConfiguration

メッセージ リクエストの構成。

JSON 表現
{
  "acceptedOutputModes": [
    string
  ],
  "taskPushNotificationConfig": {
    object (TaskPushNotificationConfig)
  },
  "returnImmediately": boolean,
  "historyLength": integer
}
フィールド
acceptedOutputModes[]

string

クライアントがレスポンス パーツで受け入れる準備ができているメディアタイプのリスト。エージェントはこれを使用して出力を調整する必要があります。

taskPushNotificationConfig

object (TaskPushNotificationConfig)

タスクの更新に関するプッシュ通知を送信するためのエージェントの構成。message.send リクエストでこの構成を送信する場合、タスク ID は空にする必要があります。

returnImmediately

boolean

true の場合、処理が進行中でも、タスクの作成直後にオペレーションが返されます。false(デフォルト)の場合、オペレーションは、タスクがターミナル(COMPLETEDFAILEDCANCELEDREJECTED)または中断(INPUT_REQUIREDAUTH_REQUIRED)状態になるまで待機してから返される必要があります。

historyLength

integer

レスポンスで取得するタスクの履歴から取得する最新のメッセージの最大数。値が設定されていない場合、クライアントは制限を課しません。値が 0 の場合は、メッセージを含めないようにリクエストします。サーバーは、指定された値よりも多くのメッセージを返してはなりませんが、下限を適用してもかまいません。

TaskPushNotificationConfig

プッシュ通知構成を特定のタスクに関連付けるコンテナ。

JSON 表現
{
  "tenant": string,
  "id": string,
  "taskId": string,
  "url": string,
  "token": string,
  "authentication": {
    object (AuthenticationInfo)
  }
}
フィールド
tenant

string

省略可。不透明なルーティング識別子。このフィールドが設定されている場合は、エージェント カードで選択した AgentInterfacetenant 値と一致する必要があります。

id

string

プッシュ通知構成の詳細。このプッシュ通知構成の一意の識別子(UUID など)。

taskId

string

この構成が関連付けられているタスクの ID。

url

string

必須。通知の送信先 URL。

token

string

このタスクまたはセッションに固有のトークン。

authentication

object (AuthenticationInfo)

通知の送信に必要な認証情報。

AuthenticationInfo

プッシュ通知に使用される認証の詳細を定義します。

JSON 表現
{
  "scheme": string,
  "credentials": string
}
フィールド
scheme

string

必須。IANA レジストリの HTTP 認証スキーム。例: BearerBasicDigestRFC 9110 セクション 11.1 に従って、スキーム名では大文字と小文字が区別されません。

credentials

string

プッシュ通知の認証情報。形式はスキームによって異なります(Bearer の場合はトークンなど)。