基于智能体应用管理提供的 agent_id 与 agent_version 信息,提供场景化对话、研究、写作相关能力。
请求语法
请求参数
参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
stream | bool | 是 | 必须填 true,当前版本仅支持流式响应。若提供 |
input | object | 是 | 输入字段 |
input.request_id | str | 否 | 请求ID(业务自定义) |
input.messages | array[object] | 是 | 对话消息 |
input.messages.[].role | str | 是 | 角色,枚举值为: |
input.messages.[].content | str | 是 | 生成内容 |
parameters | object | 是 | 配置参数字段 |
parameters.agent_options | object | 是 | 智能体专用参数 |
parameters.agent_options.agent_id | string | 是 | 应用ID |
parameters.agent_options.agent_version | string | 是 | 应用版本 |
parameters.agent_options.session_files | array[string] | 否 | 动态文件 ID 列表,文件 ID 的获取参考文件上传文档,最大支持传入10个文件ID |
返回参数
参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
request_id | str | 是 | 请求ID(dashscope 平台) |
code | str | 是 | 状态码(成功:200) |
message | str | 是 | 状态信息 |
output | object | 是 | 输出字段 |
output.request_id | str | 否 | 请求ID(业务自定义) |
output.choices | array[object] | 是 | 模型输出信息 |
output.choices.[].finish_reason | str | 是 | 生成结束原因,仅尾包输出 |
output.choices.[].message | object | 是 | 对话消息 |
output.choices.[].message.role | str | 是 | 角色,枚举值为: |
output.choices.[].message.content | str | array[object] | 是 | 生成内容/工具返回内容,当生成配置开启输出报告时,报告消息体类型为 |
output.choices.[].message.reasoning_content | str | 否 | 思考内容,如果 content内没有内容,则尝试获取最后一轮深度思考中的reasoning_content内容 |
output.choices.[].message.tool_calls | array[object] | 否 | 工具调用信息 |
output.choices.[].message.tool_calls[0].arguments | dcit[str,object] | 否 | 工具调用参数 |
output.choices.[].message.tool_calls[0].name | str | 否 | 工具调用名称 |
output.choices.[].message.additional_kwargs.extra_json | Any | 否 | 工具调用返回时,携带结构化输出信息 |
output.choices.[].message.extra | dict | 否 | 步骤状态信息 |
output.choices.[].message.extra.group | str | 否 | 执行阶段 |
output.choices.[].message.extra.step_change | str | 否 | 步骤变化事件 |
output.choices.[].message.extra.step | str | 否 | 当前步骤 |
output.choices.[].message.response_metadata | dict | 否 | 请求模型调用详细信息 |
output.usage | object | 否 | 用量统计 |
output.usage.input_tokens | int | 否 | 输入 tokens |
output.usage.output_tokens | int | 否 | 输出 tokens |
output.usage.total_tokens | int | 否 | 总 tokens |
计划枚举
执行阶段( | 描述 | 说明 |
|---|---|---|
planning | 计划中 | 对应plan模型,即系统处于任务规划阶段,该阶段包含 start 和 end 事件 |
generating | 生成中 | 表示为写作模型,表示系统正处于报告生成阶段,此阶段不区分详细事件变化,无 start/end 事件;step 状态仅包括 thinking 和 generating,且不会调用工具。 |
当前步骤( | 描述和说明 |
|---|---|
planning | 计划中 |
thinking | 思考中 |
reporting | 总结中(法律场景特有) |
generating | 生成中 |
tool_calling | 工具调用中 |
tool_calling_{工具名称} | 工具调用中,附带工具名称 |
- 由于模型原因 step_change 值可能为不存在,请尽可能使用持久化的标志step
- 空包情况下 step、step_change、group 字段的值可能不存在
- plan、think、generation 均由 xxx_start 事件 和 xxx_end 事件两个事件组成
- tool_call 由 tool_call_start、tool_calling、tool_return 三个事件组成
- tool_call_start 表示工具调用开始(开始流式收集工具调用信息,此时还无法吐出工具调用详情(name、args等))、tool_calling 表示获取到完整工具调用的参数并会抛出完整的工具调用参数tool_return 表示工具调用返回结果,同时会携带结构化的工具返回信息。
步骤变化事件 ( | 事件发生时 | 事件名称 | 解释说明 |
|---|---|---|---|
plan_start |
| 开始规划 |
|
plan_end |
| 结束规划 |
|
think_start |
| 开始思考 | 与 |
think_end |
| 结束思考 | 与 |
report_start |
| 开始总结 | 与 |
report_end |
| 结束总结 | 与 |
generation_start |
| 开始生成 | 与 |
generation_end |
| 结束生成 | 与 |
tool_call_start |
| 开始工具调用 | 表示工具调用开始(开始流式收集工具调用信息,此时还无法吐出工具调用详情(name、arguments等))。 |
tool_calling |
| 工具调用中 | 会输出tool_call的具体参数和工具名称, |
tool_return |
| 工具返回 | 会携带工具返回信息, |
示例
请求示例
返回示例
- file_path:文件存储路径用于后续导出pdf和二次获取以下文件下载链接
- md_file_url:md下载链接
- html_file_url:html下载链接