对象

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 回答的同一问题（例如在 fast 回答之后改用 precise）。之前的问答对会保留。其后的轮次留在原分支中，选中新版本时不在对话记录中显示（FeedItem.versions、POST /v1/conversations/{conv_id}/versions）。用于生成回答的历史记录是所选分支中截至该轮次的部分。版本的 quality 不会更改对话的设置。需要 conversation_id；来自其他对话的问题返回 404 questions.not_found。

• qualitystring

  结果所依据的搜索在速度与准确度之间的取舍：fast 更快，precise 更准确。默认值：precise。

  可选值: fastprecise

使用方

• POST/v1/chat以流式返回助手的回答（SSE）