Method: projects.locations.apps.chatAiAssistant

指定されたアシスタント セッションで AI アシスタントの Arc を実行します。

HTTP リクエスト

POST https://ces.googleapis.com/v1beta/{app=projects/*/locations/*/apps/*}:chatAiAssistant

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
app

string

必須。アシスタントを実行するアプリ。形式: projects/{project}/locations/{location}/apps/{app}

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
フィールド
assistantSession

string

必須。アシスタントの実行に使用されるアシスタント セッション。形式: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
message

string

必須。アシスタント エージェントに送信するメッセージ。
attachedGcsUris[]

string

省略可。このターン中にユーザーがアップロードしたファイルの Cloud Storage URI。例: 「gs://cxas-transient-uploads/uuid/prd.pdf」
contextToken

string

省略可。SessionService.GenerateOnboardingSuggestions から返される不透明なオンボーディング コンテキスト トークン。設定されていて、まだ新しい場合、サーバーは最初の会話ターンで再計算するのではなく、ゼロ状態用に計算されたオンボーディング スナップショットを再利用します。

レスポンスの本文

AssistantService.ChatAiAssistant に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "eventId": string,
  "eventTime": string,
  "uiEvent": {
    object (UiEvent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textChunk": string,
  "statusMessage": string,
  "sessionCheckpoint": {
    object (SessionCheckpoint)
  }
  // End of mutually exclusive fields.
}
フィールド
eventId

string

イベントの固有識別子。
eventTime

string (Timestamp format)

イベントが発生したタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
uiEvent

object (UiEvent)

省略可。UI イベントのペイロード。
イベント ペイロード。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
textChunk

string

テキスト トークン（Gemini の回答を単語ごとにストリーミングする場合）
statusMessage

string

簡単なステータス アップデート
sessionCheckpoint

object (SessionCheckpoint)

ユーザーの意図とローリング サマリーを含むセッション チェックポイント / 圧縮要約イベント。
相互に排他的なフィールドの終了。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

詳細については、Authentication Overview をご覧ください。

IAM 権限

app リソースに対する次の IAM 権限が必要です。

  • ces.apps.update

詳細については、IAM のドキュメントをご覧ください。