オブジェクト

ChatRequest

フィールド

• messagesarray of ChatMessage必須

  items ≥ 1

• collectionstring

  デフォルト："default"

• tagsarray of string | null
• exportstring | null
• card_idsarray of string | null

  items ≤ 50

• streamboolean

  デフォルト：false

• conversation_idstring | null

  length ≤ 64

• originstring | null
• toolsboolean | null
• bypass_cacheboolean

  回答キャッシュから回答を取得しません（キャッシュされた回答の下にある「Get a fresh answer」ボタン）。新しい回答がキャッシュのエントリを置き換えます。

  デフォルト：false

• languagestring | null

  回答の言語：その言語で回答させるためのISO 639-1コード（de、en、ru、…）。autoの場合またはフィールドがない場合、言語は質問から判定されます。画面は、別の言語の提案の言語を明示的に渡します（Starter.language）。

• scopeChatScope | null

  質問の範囲：複数のコレクション、ソース、タグ、期間。範囲のコレクションはcollectionに代わります。ソースを指定すると、回答はそのソースのコレクション（とソース自身のカード）に絞り込まれます。タグはtagsに追加されます。期間は、財務に関する回答をその期間に限定します。選択できるのは、ユーザーが参照できるものだけです（コレクション：collections.no_access/collections.not_found、ソース：sources.not_found）。conversation_idを指定すると、範囲は会話に保存されます。フィールドがない場合は会話の範囲が適用され、nullまたは空の範囲を渡すとクリアされます。

• request_idstring

  質問の冪等キー。同じ質問に対するストリームの再試行（切断後の再試行。この場合、Last-Event-IDはストリームを継続せず、ログに記録されるだけです）では、毎回同じキーを送ってください。すでに保存された回答のキーで再試行しても、質問が重複して作成されることはありません：保存済みの結果が単一のdoneイベント（とテキストを含むtoken）として再送されます。質問数やクレジットの上限に達していても同じです。切断されたクライアントに向けて前の回答がまだ生成中の場合、その生成は停止し、回答があらためて生成されます。

  length ≤ 64

• version_ofinteger (int64)

  会話内のこの質問のターンについて、新しいバージョンを作成します（会話の履歴のquestion_id）：編集した質問（messagesの新しいテキスト）、再生成した回答（同じテキスト。通常はbypass_cacheと併用）、または別のqualityでの同じ質問（たとえば、preciseでfastの回答をやり直す）。以前の質問と回答のペアは保持されます。その後のターンは元の分岐に残り、新しいバージョンが選択されている間は会話の履歴に表示されません（FeedItem.versions、POST /v1/conversations/{conv_id}/versions）。回答に使われる履歴は、選択中の分岐のこのターンまでの部分です。バージョンのqualityは、会話の設定を変更しません。conversation_idが必要です。ほかの会話の質問では404 questions.not_foundが返ります。

• qualitystring

  結果の元になる検索の速さと正確さのバランス：fastはより速く、preciseはより正確です。デフォルト：precise。

  指定できる値: fastprecise

使用箇所

• POST/v1/chatアシスタントの回答をストリーミングする（SSE）