乐享知识库接口文档 # AI 问答 - Agent 模式
请求URL
POST https://lxapi.lexiangla.com/cgi-bin/v2/ai/qa
请求头
| 参数 | 是否必须 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定值："application/json; charset=utf-8" |
| Authorization | 是 | 接口调用凭证 access_token 值格式："Bearer access_token" 示例值："Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJS" |
| x-staff-id | 是 | 发起问答的成员帐号 |
其他说明
| 事项 | 说明 |
|---|---|
| 权限要求 | AI 助手 |
请求参数
{
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "乐享是什么？"
}
]
}
],
"forwardedProps": {
"qa_mode": "react-ds-v4-flash"
},
"threadId": ""
}
参数说明
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| messages | 是 | 无 | 消息列表，当前仅支持一条 role=user 的消息 |
| messages[].role | 是 | 无 | 固定值 "user" |
| messages[].content | 是 | 无 | 消息内容数组 |
| messages[].content[].type | 是 | 无 | 固定值 "text" |
| messages[].content[].text | 是 | 无 | 消息文本内容，总长度不超过 5000 字符 |
| forwardedProps | 是 | 无 | 扩展参数（forwardedProps 内部为乐享自定义参数，使用蛇形命名法；顶层参数遵循 AG-UI 协议，使用小驼峰命名法；请注意区分） |
| forwardedProps.qa_mode | 是 | 无 | 使用的模型 react-hy3: 使用HY 3.0模型 react-ds-v4-flash: 使用deepseek-v4-flash模型 react-ds-v4-pro: 使用deepseek-v4-pro模型 react-glm-5: 使用glm-5模型 react-glm-5.2: 使用glm-5.2模型 react-glm-5v-turbo: 使用glm-5v-turbo模型 react-kimi-k2.6: 使用kimi-k2.6模型 react-kimi-k3: 使用kimi-k3模型 react-minimax-m3: 使用minimax-m3模型 |
| threadId | 否 | 无 | 会话ID，用以区分不同的会话。不同会话间的对话历史相互隔离。首次请求留空，后续通过传入响应中返回的 threadId 保持多轮对话。字符串长度：32 |
流式响应
基于 AG-UI Protocol (opens new window) 实现。
200 OK 状态码
id: RUN_STARTED_1786333185273
data: {"type":"RUN_STARTED","timestamp":1786333185273,"threadId":"84764a80099c4431819f3f09a864bee8","runId":"16bd2428226a4b1f9124728a7b1aeab7"}
id: TEXT_MESSAGE_START_1786333186939
data: {"type":"TEXT_MESSAGE_START","timestamp":1786333186939,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","role":"assistant"}
id: TEXT_MESSAGE_CONTENT_1786333186939
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333186939,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"我来"}
id: TEXT_MESSAGE_CONTENT_1786333186965
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333186965,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"为您"}
id: TEXT_MESSAGE_CONTENT_1786333186968
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333186968,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"解答"}
id: TEXT_MESSAGE_CONTENT_1786333186970
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333186970,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"\""}
id: TEXT_MESSAGE_CONTENT_1786333187008
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187008,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"乐"}
id: TEXT_MESSAGE_CONTENT_1786333187009
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187009,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"享"}
id: TEXT_MESSAGE_CONTENT_1786333187011
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187011,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"是什么"}
id: TEXT_MESSAGE_CONTENT_1786333187012
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187012,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"\""}
id: TEXT_MESSAGE_CONTENT_1786333187013
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187013,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"这个问题"}
id: TEXT_MESSAGE_CONTENT_1786333187015
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187015,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"。"}
id: TEXT_MESSAGE_CONTENT_1786333187021
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187021,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"让我"}
id: TEXT_MESSAGE_CONTENT_1786333187023
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187023,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"先在"}
id: TEXT_MESSAGE_CONTENT_1786333187075
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187075,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"知识"}
id: TEXT_MESSAGE_CONTENT_1786333187080
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187080,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"库"}
id: TEXT_MESSAGE_CONTENT_1786333187096
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333187096,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"中"}
id: TEXT_MESSAGE_CONTENT_1786333188214
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333188214,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"检索"}
id: TEXT_MESSAGE_CONTENT_1786333188219
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333188219,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"相关信息"}
id: TEXT_MESSAGE_CONTENT_1786333188220
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333188220,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6","delta":"。"}
id: TEXT_MESSAGE_END_1786333188223
data: {"type":"TEXT_MESSAGE_END","timestamp":1786333188223,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6"}
id: STEP_STARTED_1786333188223
data: {"type":"STEP_STARTED","timestamp":1786333188223,"stepName":"REASONING"}
id: TOOL_CALL_START_1786333188223
data: {"type":"TOOL_CALL_START","timestamp":1786333188223,"toolCallId":"call_00_uzHHrdRUQ023JwGHHQPZ2678","toolCallName":"search_knowledge_base","parentMessageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1"}
id: TOOL_CALL_ARGS_1786333188312
data: {"delta":"","timestamp":1786333188312,"toolCallId":"call_00_uzHHrdRUQ023JwGHHQPZ2678","type":"TOOL_CALL_ARGS"}
id: TOOL_CALL_END_1786333188312
data: {"type":"TOOL_CALL_END","timestamp":1786333188312,"toolCallId":"call_00_uzHHrdRUQ023JwGHHQPZ2678"}
id: TOOL_CALL_START_1786333188312
data: {"type":"TOOL_CALL_START","timestamp":1786333188312,"toolCallId":"call_01_2jbLM8uF07Kf9TXoStkl2641","toolCallName":"search_knowledge_base","parentMessageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1"}
id: TOOL_CALL_ARGS_1786333196939
data: {"delta":"","timestamp":1786333196939,"toolCallId":"call_01_2jbLM8uF07Kf9TXoStkl2641","type":"TOOL_CALL_ARGS"}
id: TOOL_CALL_END_1786333196939
data: {"type":"TOOL_CALL_END","timestamp":1786333196939,"toolCallId":"call_01_2jbLM8uF07Kf9TXoStkl2641"}
id: TOOL_CALL_RESULT_1786333196939
data: {"content":"工具调用完成","messageId":"13d8c1c5-d2f7-4f0a-b218-ca4460213d6d","role":"tool","timestamp":1786333196939,"toolCallId":"call_00_uzHHrdRUQ023JwGHHQPZ2678","type":"TOOL_CALL_RESULT"}
id: TOOL_CALL_RESULT_1786333196939
data: {"content":"工具调用完成","messageId":"13d8c1c5-d2f7-4f0a-b218-ca4460213d6d","role":"tool","timestamp":1786333196939,"toolCallId":"call_01_2jbLM8uF07Kf9TXoStkl2641","type":"TOOL_CALL_RESULT"}
id: STEP_FINISHED_1786333199688
data: {"type":"STEP_FINISHED","timestamp":1786333199688,"stepName":"REASONING"}
id: TEXT_MESSAGE_START_1786333199688
data: {"type":"TEXT_MESSAGE_START","timestamp":1786333199688,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","role":"assistant"}
id: TEXT_MESSAGE_CONTENT_1786333199688
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199688,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"根据"}
id: TEXT_MESSAGE_CONTENT_1786333199728
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199728,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"知识"}
id: TEXT_MESSAGE_CONTENT_1786333199750
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199750,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"库"}
id: TEXT_MESSAGE_CONTENT_1786333199756
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199756,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"中的"}
id: TEXT_MESSAGE_CONTENT_1786333199760
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199760,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"资料"}
id: TEXT_MESSAGE_CONTENT_1786333199775
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199775,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"，"}
id: TEXT_MESSAGE_CONTENT_1786333199779
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199779,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"我来"}
id: TEXT_MESSAGE_CONTENT_1786333199784
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199784,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"为您"}
id: TEXT_MESSAGE_CONTENT_1786333199788
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199788,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"全面"}
id: TEXT_MESSAGE_CONTENT_1786333199801
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199801,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"介绍"}
id: TEXT_MESSAGE_CONTENT_1786333199806
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199806,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"**"}
id: TEXT_MESSAGE_CONTENT_1786333199811
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199811,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"腾讯"}
id: TEXT_MESSAGE_CONTENT_1786333199816
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199816,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"乐"}
id: TEXT_MESSAGE_CONTENT_1786333199822
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333199822,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"享"}
...此处省略中间部分流式响应内容...
id: TEXT_MESSAGE_CONTENT_1786333205124
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333205124,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"欢迎"}
id: TEXT_MESSAGE_CONTENT_1786333205157
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333205157,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"继续"}
id: TEXT_MESSAGE_CONTENT_1786333205162
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333205162,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"提问"}
id: TEXT_MESSAGE_CONTENT_1786333205166
data: {"type":"TEXT_MESSAGE_CONTENT","timestamp":1786333205166,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1","delta":"！"}
id: TEXT_MESSAGE_END_1786333205261
data: {"type":"TEXT_MESSAGE_END","timestamp":1786333205261,"messageId":"bb63145d-9a15-4eac-8bf1-f1377256daa6:1"}
id: CUSTOM_1786333205274
data: {"type":"CUSTOM","timestamp":1786333205274,"name":"REFERENCE_DOCS","value":{"reference_docs":[{"title":"腾讯乐享介绍","url":"/pages/5dc00bd321a24568bb4787dec964cde2"},{"title":"SaaS产品分析","url":"/pages/93f2cf8eec6a438381aa2ccf040dfa85"}]}}
id: CUSTOM_1786333205274
data: {"type":"CUSTOM","timestamp":1786333205274,"name":"REFERENCE_CHUNKS","value":{"REFERENCE_CHUNKS","value":{"reference_chunks":[{"content":"腾讯乐享是腾讯推出的……","target_id":"5dc00bd321a24568bb4787dec964cde2","target_type":"kb_entry","title":"腾讯乐享介绍","url":"/pages/5dc00bd321a24568bb4787dec964cde2"},{"content":"打造公司的社区……","target_id":"a8db4ead786041afa336a42b8dad926b","target_type":"kb_entry","title":"SaaS产品分析","url":"/pages/a8db4ead786041afa336a42b8dad926b"}]}}
id: RUN_FINISHED_1786333205274
data: {"type":"RUN_FINISHED","timestamp":1786333205274,"threadId":"84764a80099c4431819f3f09a864bee8","runId":"16bd2428226a4b1f9124728a7b1aeab7"}
响应字段说明
| 参数 | 说明 |
|---|---|
| runId | 任务id |
| threadId | 会话id |
| type | 事件类型，参考 AG-UI EventType (opens new window) |
| processes.message | 处理过程的具体信息 |
| delta | 正文内容块 |
| reference_chunks | 回答参考的内容段落 |
| reference_docs | 问答参考的内容来源 |
错误响应
接口失败时统一返回如下结构，HTTP 状态码由 code 决定：
{
"code": 51,
"message": "qa_mode 参数无效",
"request_id": "eb83bd93-5e50-4a0a-8db6-c0fb1bc7aa2b",
"data": null
}
401 Unauthorized 状态码（鉴权失败）
{
"code": 41,
"message": "AccessToken 无效",
"request_id": "eba7d53e-e104-4436-9fb2-d2293385b205",
"data": null
}
429 Too Many Requests 状态码（限流/配额耗尽）
{
"code": 123,
"message": "llm model limit exhausted",
"request_id": "eba7d53e-e104-4436-9fb2-d2293385b205",
"data": null
}
{
"code": 123,
"message": "ai token quota exhausted",
"request_id": "eba7d53e-e104-4436-9fb2-d2293385b205",
"data": null
}
错误码说明
| HTTP状态码 | code | 说明 |
|---|---|---|
| 400 | 51 | 请求参数校验失败（含字段必填/格式校验、模型参数无效等） |
| 401 | 41 | AccessToken 无效或鉴权失败 |
| 429 | 123 | 大模型调用配额或 AI Token 余量耗尽，请稍后重试或联系管理员 |
| 500 | 999 | 服务内部错误，请携带 request_id 联系管理员排查 |