调用 Agent 对话

以 SSE 流式方式调用已发布 Agent，租户信息由 appKey 鉴权上下文确定。

请求体

名称	类型	必填	描述	示例值
traceId	string	否	链路 ID，用于问题定位	trace-20260803-001
appId	string	是	Agent 应用 ID	10001
query	string	是	用户当前问句	如何创建一个智能体？
recallQuestion	string	否	用于知识召回的问句
chatHistories	object[]	否	历史对话信息
└content	string	否
└fromUser	int32	否
└msgTime	int64	否
└status	int32	否
└msgType	int32	否
historyLimit	int32	否	历史对话最大轮数
reactLimit	int32	否	ReAct 模式最大循环轮次
sessionId	string	否	七鱼会话 ID
chatId	string	否	对话 ID
messageId	string	否	消息 ID
staffId	int64	否	客服 ID
qiyuSourceType	int32	否	七鱼业务来源场景
docSearchMode	int32	否	文档搜索模式
ysDocs	object	否	指定的云商文档范围
└docSpaceIdList	string[]	否
└docIdList	string[]	否
└entityMatchOfDoc	object	否
└token	string	否
└docSpacesOfHighPriority	object	否
└notEmpty	boolean	否
docRangeType	int32	否	文档范围类型
ysDocList	object[]	否	云商文档列表
└docId	string	否
└spaceId	string	否
robotId	int64	否	机器人 ID
foreignId	string	否	外部用户 ID
userId	int64	否	用户 ID，用于记忆记录；优先使用 foreignId
nlpInfoList	object[]	否	NLP 答案信息列表
└answerType	string	否
└standQuestion	string	否
└score	double	否
└id	string	否
└categoryPath	string	否
parameters	object	否	提示词变量替换参数
userFromIp	string	否	用户 IP 地址	192.0.2.1
globalTraceId	string	否	全局链路追踪 ID，用于跨系统问题定位
robotToken	string	否	七鱼机器人唯一标识
appType	string	否	钱包应用类型
billBizId	string	否	计费业务 ID，用于钱包扣费幂等和业务对账

返回参数

SSE 流式响应

postEndpoint

/openapi/agent/v2/chat

curl -X POST "https://b.163.com/openapi/agent/v2/chat" \  -H "Content-Type: application/json" \  -d '{    "appId": 10001,    "query": "如何创建一个智能体？"  }'

"string"