标准知识问答（Chat）

containerId 省略时使用当前鉴权用户可问答的知识库，不等于整个租户的全部知识库。当前没有可用知识库时执行纯大模型回答。指定 fileIds 不会绕过知识库权限。

非流式：

curl --request POST "${BASE_URL}/openapi/api/v1/chat/completions" \
  --header "Authorization: Bearer ${AIS_API_KEY}" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "请介绍产品支持的部署方式",
    "containerId": ["partner_kb_001"],
    "ragSearch": true,
    "multipleDialog": true,
    "stream": false
  }'

自行提供历史时，最后一条消息是本次问题，不要求消息必须以 user/assistant 严格成对：

{
  "messages": [
    {"role": "user", "content": "产品有哪些部署方式？"},
    {"role": "assistant", "content": "可以按项目要求部署。"},
    {"role": "user", "content": "对运行环境有什么要求？"}
  ],
  "containerId": ["partner_kb_001"],
  "stream": false
}

messages 模式使用调用方提供的历史；同时传 prompt 和 messages 时，优先使用 prompt，不进入 messages 历史分支。

成功直接返回对话对象，没有 code/message/data 外层包装。精简示例：

{
  "created": 1788575400000,
  "id": "message_001",
  "conversationId": "conversation_001",
  "model": "configured-model",
  "costTime": 1200,
  "usage": {
    "completion_tokens": 30,
    "prompt_tokens": 120,
    "total_tokens": 150
  },
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "请根据项目交付方案准备运行环境。"
      }
    }
  ],
  "references": [],
  "paragraphs": [],
  "multiParts": []
}

无知识来源或尚未产生引用时，引用数组可以为空；不能据此假定整个回答失败。相反，有引用也不代表生成内容已通过业务审核。

引用文件编码为 dataSetId。引用 URL 按接口实际返回值使用，不硬编码对象存储签名地址。

设置 stream=true，客户端按 text/event-stream 解析。命令行调试加 curl --no-buffer。

event:add
data:{"conversationId":"conversation_001","choices":[{"message":{"role":"assistant","content":"支持"}}]}

event:add
data:{"conversationId":"conversation_001","choices":[{"finish_reason":"stop","message":{"role":"assistant","content":""}}],"references":[],"paragraphs":[],"multiParts":[]}

上例展示事件格式，实际事件可能附带 id 和其他字段。逐事件累加文本，保留结束事件中的引用与 usage；中间事件可能尚未携带这些字段。此标准入口当前固定使用明文 JSON 数据，不需要 Base64 解码，不能沿用旧文档的 encode=true 说明。

建立 SSE 前的失败可能返回 JSON 错误；建立流之后还应处理流内异常和连接中断。不要把一次网络读取直接当成一个完整 SSE 事件。标准 Chat 限流时可能返回 HTTP 429 和 Retry-After，详见 错误处理。

SSE data 的字段类型与非流式响应一致，但每个事件通常只是其中一部分。只实现固定供应商的 [DONE] 或 choices[].delta 协议不足以消费 AIS 的 choices[].message 事件。