AI 助理
文档备案控制台
开发者社区 物联网 行业解决方案 文章 正文

蚂蚁百宝箱 ✖️ 调用对话型智能体

2025-10-20 458
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 通过调用本接口，开发者可以向指定智能体发起对话，支持在对话时添加上下文消息，便于智能体做出合理的回复。

通过调用本接口，开发者可以向指定智能体发起对话，支持在对话时添加上下文消息，便于智能体做出合理的回复。

前提条件

  • 在调用本接口前，请先完成应用的发布，若无，请参见：发布应用，完成相关事项。
  • 若您需要通过本接口上传多模态文件，需要先开启应用配置中的多模态配置，再添加拥有多模态处理能力的大模型或插件。

请求地址

POSThttps://api.tbox.cn/api/chat

请求头

参数名

是否必填

类型

说明

示例

Authorization

是

String

用于验证客户端身份的访问令牌，你可以在百宝箱中获取，获取方式可参见：授权管理。

pat_2j4e******THUIVRH1

请求参数

参数名

是否必填

类型

说明

示例

appId

是

String

应用 ID，需要通过 API 进行集成的应用 ID。获取方式可参见：获取AppID。

202506e******00450562

query

是

String

用户发给智能体的问题内容。

你好

userId

是

String

用户 ID，指使用智能体的用户 ID，需开发者自行定义与维护。

-

conversationId

否

String

会话id，用于用户多轮对话时组装上下文信息。

多轮对话时，按照SDK中之前返回的conversationId 内容传入。

files

否

List<File>

文件列表，用于在对话中提供多模态（文档、图片、音频及视频）数据。

说明：

使用文件上传能力前，请先为智能体配置具有文件处理能力的大模型或插件。

列表内参数定义可参见：File 定义。

-

searchEngine

否

Boolean

本次对话是否使用联网搜索。

说明：

使用联网搜索前，需要先开启智能体对话配置中的联网搜索开关。

  • true：使用联网搜索；
  • false：默认值，不使用联网搜索。

true

stream

否

Boolean

是否流式返回。

  • true：流式（默认值）
  • false：非流式

true

File 定义

本模块参数仅在使用文件上传能力时，必传。

参数名

是否必填

类型

说明

示例

type

是

Enum<String>

指上传的文件类型。枚举值包括：

  • 图像：IMAGE
  • 音频：AUDIO
  • 视频：VIDEO
  • 文件：FILE

IMAGE

fileId

是

String

上传文件id，通过上传文件接口，完成文件上传后，在返回参数中获得。

202502********001001

请求示例

支持用 curl 命令或编程语言（如 Python、Java 等）调用接口，以下是 curl 命令示例。

curl --location 'https://api.tbox.cn/api/chat' 
--header 'Authorization: {your_token}' \
--header 'Content-Type: application/json' \
--header 'Accept: text/event-stream' \
--data '{"appId": {your_appId},"query":"你好","userId":"xxx"}'

返回参数

本 API 的返回内容会根据请求参数中 stream 参数值（true/false）来采用流式或非流式响应，您可以根据下述需求 list 来判断自身业务场景适配哪种响应方式。

需求 list

响应方式

当您的业务场景满足下述任一一条时：

  • 需要以打字机的效果来显示接口返回内容；
  • 需要即时查看智能体回复；
  • 需要同步处理返回内容；

流式响应（stream=true）

当您的业务场景不满足上述内容时

非流式响应（stream=false）

流式返回

流式返回的消息体结构如下：

参数名

类型

说明

id

Integer

对话 ID，当前对话的唯一标识。

event

String

当前流式返回的消息类型。

data

Object

返回内容详情，data 详细说明可参见：data 定义。

data 定义

参数名

类型

说明

type

String

数据类型描述，如元数据、普通数据等，详情描述如下：

  • meta：包含联网搜索的相关内容。
  • header：表示百宝箱开始将要开始返回chunk 内容。多输出场景下会有多个header。
  • chunk：本次请求返回的具体消息内容。
  • thinking：当本次请求开启了思维链能力时，用于展示具体的思维链内容。

payload

String (JSONString)

具体返回内容，实际结构会根据 type 的不同而变化，详细说明可参见：
当 data.type = header 时，payload 定义

参数名

类型

说明

extraParams

Object

额外输出参数

mediaType

String

输出的内容类型

requestId

String

请求ID

sessionId

String

sessionId 即 conversationId
当 data.type = chunk 时，payload 定义

参数名

类型

说明

type

String

类型标识符，如 chunk

lane

String

流水线标识（默认为 default）

text

String

当前文本流中返回的内容

conversationId

String

当前会话id

messageId

String

当前消息id
当 data.type = meta 时，payload 定义

参数名

类型

说明

entity

Object

节点信息。

event

String

事件名称，表示流程中的执行过程事件。

ext_data

JSONString

扩展信息，包含节点执行过程中的详细信息。

其中，entity 以及 ext_data 的定义信息可参见：附录。

当 data.type = thinking 时，payload 定义

说明：

  • 仅智能体配置了支持思维链能力的大模型时，会返回当前内容。
  • 当智能体为简单应用时，智能体中仅存在一个大模型， thinking 返回值与智能体的返回结果存在关联关系；
  • 当智能体为工作流应用时，智能体中可能存在一到多个大模型，thinking 返回内容可能与智能体最终返回结果不相干。

参数名

类型

说明

entity

Object

节点信息。

event

String

事件名称，表示流程中的执行过程事件，详细说明可参见：流式响应事件。

ext_data

JSONString

扩展信息，包含节点执行过程中的详细信息。

其中，entity 以及 ext_data 的定义信息可参见：附录。

流式响应事件枚举

事件名称

说明

flow.graph.start

流程开始执行

flow.node.start

节点开始执行

flow.node.end

节点执行结束

flow.graph.end

流程执行结束

flow.node.llm.search.result

执行联网搜索

flow.node.llm.think.start

表示思维链开始输出

flow.node.llm.thinking

表示思维链输出中

flow.node.llm.think.end

表示思维链输出结束

返回示例

id:1
event:message
data:{"entity":{"node_type":"output","execute_id":"7","node_name":"输出内容","node_id":"OU_awwbf6"},"lane":"default","payload":"{\"extraParams\":{},\"mediaType\":\"text\",\"requestId\":\"test-yuhao-201\",\"sessionId\":\"20250716Pj9q35266510\"}","type":"header"}
id:2
event:message
data:{"lane":"default","payload":"{\"text\":\"您\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\"}","type":"chunk"}
id:3
event:message
data:{"lane":"default","payload":"{\"text\":\"提到\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:4
event:message
data:{"lane":"default","payload":"{\"text\":\"的文件是指\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:5
event:message
data:{"lane":"default","payload":"{\"text\":\"之前\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:6
event:message
data:{"lane":"default","payload":"{\"text\":\"上传过的某个文件吗\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:7
event:message
data:{"lane":"default","payload":"{\"text\":\"？能否请您提供一下\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:8
event:message
data:{"lane":"default","payload":"{\"text\":\"该文件或者描述一下文件\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:9
event:message
data:{"lane":"default","payload":"{\"text\":\"的具体内容，这样我才能\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:10
event:message
data:{"lane":"default","payload":"{\"text\":\"更好地帮助您。如果您\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:11
event:message
data:{"lane":"default","payload":"{\"text\":\"能分享文件链接\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:12
event:message
data:{"lane":"default","payload":"{\"text\":\"或相关细节，那\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:13
event:message
data:{"lane":"default","payload":"{\"text\":\"将非常有帮助。\",\"conversationId\":\"2025****3948\",\"messageId\":\"2025****6765\}","type":"chunk"}
id:14
event:end
data:{"type":"end"}

非流式响应

参数名

类型

说明

errorCode

String

错误码，"0" 表示成功。

errorMsg

String

错误信息。

data

List<ChatResponse>

返回结果，详细说明可参见：ChatResponse 定义。

traceId

String

traceId，用于排查问题

ChatResponse 定义

参数名

类型

说明

requestId

String

请求ID

converstionId

String

当前会话 ID

messageId

String

当前消息 ID

result

List<Answer>

返回结果，详细说明可参见：Answer 定义。

searchResult

List<SearchResult>

联网搜索结果集合，仅开启并使用联网搜索能力时，有相关返回，详细说明可参见：SearchResult 定义。

reasoningContent

List<ReasoningContent>

思维链集合，仅当智能体的大模型支持思维链能力时返回，详细说明可参见：ReasoningContent 定义。

Answer 定义

参数名

类型

说明

lane

String

流水线标识（默认为 default）

extraParams

Object

额外输出参数

mediaType

String

输出的内容类型

chunk

JSONString

输出内容，根据 mediaType 有不同的结构：

  • 如果 mediaType=text：chunk 直接表示输出的文本内容；
  • 如果 mediaType=image：chunk 返回内容需要反序列化，其中 url 字段表示返回的图片 url 集合。

SearchResult 定义

参数名

类型

说明

action

String

参考链接

title

String

标题

ReasoningContent 定义

参数名

类型

说明

text

String

思维链内容

ext_data

Object

扩展信息

>>start_time

Long

思维链开始输出时间，时间戳，单位 s

>>end_time

Long

思维链输出结束时间，时间戳，单位 s

>>thinking_elapsed_secs

Int

思维链输出总耗时，单位 s

entity

Object

节点信息（工作流应用关心即可）

>>node_name

String

工作流节点名称，可以通过该字段判断思维链是哪个大模型节点产生的

返回示例

{
  "requestId": "b18ecc07-5db1-********e56ddf12581f",
  "conversationId": "2025****3948",
  "messageId": "2025****6765",
  "input_tokens": 100,
  "output_tokens": 200,
  "total_tokens": 300,
  "result": [{
    "lane":"default",
    "extraParams": {},
    "mediaType": "text",
    "chunk": "你好，有什么可以帮助你"
  }]
}
{
  "requestId": "b18ecc07-5db1-********e56ddf12581f",
  "conversationId": "2025****3948",
  "messageId": "2025****6765",
  "input_tokens": 100,
  "output_tokens": 200,
  "total_tokens": 300,
  "result": [{
    "lane":"default",
    "extraParams": {},
    "mediaType": "image",
    "chunk": "{\"url\":[\"https://mdn.alipayobjects.com/cto_doraemon/afts/img/iVe7Q6mHhpIAAAAAAAAAAAAAehe3AQBr/original\"]}"
  }]
}

附录

paylod.entity 定义

参数名

类型

说明

node_type

String

节点类型，表示该节点功能

execute_id

String

节点执行顺序编号（字符串格式）

node_name

String

节点显示名称

node_id

String

节点唯一标识符

payload.ext_data 定义

参数名

类型

说明

start_time

Number (float)

节点开始时间戳（秒级）

end_time

Number (float)

节点结束时间戳（秒级）

input_params

JSONString

当前节点的输入参数

query

JSONString

用户输入查询内容

search_result

List<SearchResult>

联网搜索参考资源明细

text

String

思考内容，仅 flow.node.llm.thinking 节点有相关返回。

thinking_elapsed_secs

Int

思维链输出总耗时，单位 s。仅 flow.node.llm.think.end 节点中有相关返回）

ext_data.input_params 定义

参数名

类型

说明

iconversationId

String

当前会话ID

requestId

String

请求唯一标识

historyChat

Array

历史对话记录（空数组表示无历史）

ext_data.query 定义

参数名

类型

说明

query

String

用户实际输入内容

ext_data.search_result 定义

参数名

类型

说明

action

String

参考链接

title

String

标题

常见问题

智能体调用过程中可能遇见的问题及解决方案，请参见：常见问题。

文章标签：
API
开发者
Java
Python
开发工具
蚂蚁百宝箱
目录
相关文章
千寻简
|
小程序 安全 API
支付宝消息订阅
订阅界面是根据当前小程序在商家平台配置的消息模板 id 来展示对应消息的订阅选项（参考接入流程第 4 步）。一次性：使用一次性消息模板订阅，每次向用户发送消息都需要用户在订阅界面点击同意后才可以发送。长期性：使用长期性消息模板订阅，用户同意订阅后，可以多次向订阅用户发送消息。
千寻简
1780 0
支付宝消息订阅
老陈聊架构
|
存储 监控 Kubernetes
『Skywalking』.NET Core快速接入分布式链路追踪平台
📣读完这篇文章里你能收获到 - .NET Core接入Skywalking - 了解Skywalking的整体架构设计 - 了解Skywalking的各项技术指标怎么看 - 生产部署时的坑全跳过 - 感谢点赞+收藏，避免下次找不到~
老陈聊架构
1847 1
『Skywalking』.NET Core快速接入分布式链路追踪平台
GoodTime
|
算法 JavaScript 大数据
高德地图 错误码说明 对照表
序号  infocode info返回值 状态描述 问题排查策略 1 10000 OK 请求正常 请求正常 2 10001 INVALID_USER_KEY key不正确或过期 开发者发起请求时，传入的key不正确或者过期  3 10002 SERVICE_NOT_AVAILABLE 没有权限使用相应的服务或者请求接口的路径拼写错误 1.开发者没有权限使用相应的服务，例如：开发者申请了WEB定位功能的key，却使用该key访问逆地理编码功能时，就会返回该错误。反之亦然。2.开发者请求接口的路径拼写错误。例如：正确的https://restapi.amap.com/v3/ip在程序中被拼装写了h
GoodTime
6261 0
愿天堂没有BUG（公众号同名）
|
Web App开发 前端开发 JavaScript
看看人家 阿里的 低代码引擎，多优雅！
特性 引擎协议 使用示例 工程化配置： cdn 可选方式：
愿天堂没有BUG（公众号同名）
2100 0
DCodes
|
缓存 小程序
微信小程序使用vant组件样式不生效的问题
微信小程序使用vant组件样式不生效的问题
DCodes
1864 0
ClawdbotMoltbot
|
4月前
|
人工智能 安全 调度
QwenPaw：你的私人AI助理 —— 数据归你、记忆进化、多端触达的开源个人智能体
在AI智能体快速普及的当下，绝大多数通用AI助手存在三大无法规避的痛点：用户所有对话记录、个人偏好画像、私密记忆数据统一托管至第三方远端服务器，数据隐私不受自身掌控；平台内置功能固定，无法根据个人业务、学习、创作需求自定义拓展能力；多办公软件、社交渠道数据割裂，在网页端配置的人设、记忆无法同步至办公IM工具，使用体验碎片化。由AgentScope开源生态团队打造的QwenPaw，以**本地优先、全开源、数据自持**为核心设计思路，彻底解决以上行业痛点，推出一款面向个人与小型团队的私有AI智能体框架，采用Apache 2.0开源协议，无商用限制，仅需3行命令即可完成全量部署，内置Web Codi
ClawdbotMoltbot
935 1
AiKeyLabs
|
4月前
|
人工智能 缓存 安全
AI Agent 凭证治理实践：从长期 API Key 到临时授权
AI Agent 不再只是生成文本，它会读取数据、调用工具、触发流程。本文从工程视角讨论为什么不应把长期 API Key 直接交给 Agent，并给出临时凭证、策略绑定、运行时拦截和审计归因的治理思路。
AiKeyLabs
410 2
32ea2c6h24f0eeLvbTg
|
11月前
|
存储 弹性计算 人工智能
租用阿里云服务器一年要多少钱？阿里云ECS、轻量与 GPU 服务器最新价格总结，手动整理
租用阿里云服务器一年要多少钱？轻量应用服务器 200M 高带宽依旧最低 38 元/年起（限时秒杀），ECS 经济型实例 2 核 2G 仅 99 元/年、2 核 4G 实例 199 元/年。更高配置如 4 核 16G 仅 89 元/月、8 核 32G 仅 160 元/月。海外用户可选香港轻量，25 元/月起，新老用户均可购买，续费同价，无隐藏涨价。手动整理了阿里云ECS、轻量与 GPU 服务器最新价格，仅供参考。
32ea2c6h24f0eeLvbTg
562 0
蚂蚁百宝箱
|
人工智能 自然语言处理 数据可视化
告别高成本定制：友盟U-AgentBox上线，开发者可一键集成行业模板，3天打造专属企业Agent
12月29日，蚂蚁百宝箱与友盟联合推出面向开发者的智能体产品U-AgentBox，聚焦低门槛、高效率集成专属智能体。通过模板化构建、可视化编辑与轻量级部署，助力开发者快速实现业务智能化升级。
蚂蚁百宝箱
616 0
告别高成本定制：友盟U-AgentBox上线，开发者可一键集成行业模板，3天打造专属企业Agent
物联网

行业解决方案

热门文章

最新文章

  • 1
    会话存档到底存了什么：一次技术拆解
  • 2
    企业AI落地的技术侧真相：瓶颈不在模型，在流程与组织
  • 3
    拆解Accio Work进入1688商家工具箱：电商经营从人力密集到Agent协作
  • 4
    AI搜索优化落地指南：让机器读懂你的工厂业务
  • 5
    拆解1688采购指数4.0：B2B平台给商品「采购吸引力」定价的底层逻辑
  • 6
    1688搜索排序的AI重构：从关键词匹配到需求理解的供给侧信号
  • 7
    从1688哇噢定制强制免费定制项，看B2B定制供给侧的标准化信号
  • 8
    内网违规外联监测报警系统：从发现到告警的闭环
  • 9
    把经验固化成智能体：这期密训给1688商家的AI落地路径
  • 10
    排名上不去的三个层面：1688搜索排序的匹配与权重逻辑
  • 1
    企业服务行业分析：一站式模式如何重构中小企业的合规外包决策
    23
  • 2
    对话式经营代理：1688生意助手的架构逻辑与B2B运营启示
    21
  • 3
    机房运维人员怎么排查GPS时钟服务器常见问题？
    28
  • 4
    设计院做方案时电子时钟系统施工要点有哪些？
    29
  • 5
    周期网页工作上线前怎样核对运行条件
    24
  • 6
    1688商品采购指数4.0：B2B平台流量分配的量化模型与运营启示
    41
  • 7
    购物中心店铺销售数据采集：五种方式的能力边界与组合打法
    39
  • 8
    数采打印机方案的技术架构
    33
  • 9
    人员定位系统供应商技术评估：资质、案例与口碑的三层验证方法
    67
  • 10
    AI工具连接中的MCP与定制API分别解决什么
    51

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    一条命令迁移，帮你实现 OpenClaw 与 Hermes Agent 记忆互通！