智能体会话与消息API

API密钥

密钥仅在浏览器端存储,易源不做转发

创建会话

创建一个会话,会话是智能体和用户之间的基于一个或多个主题的问答交互。

返回结果

API调用结果将显示在这里

功能示例

创建新会话

会话管理 初始化

用户操作:

指定智能体ID,发送初始问题"推荐三亚5天4晚自由行攻略"

系统结果:

创建会话ID: conv-20250410-12345,包含用户初始消息

添加消息

消息管理 交互

用户操作:

在现有会话中发送"第二天可以安排哪些海滩活动?"

系统结果:

创建消息ID: msg-67890,添加到指定会话,时间戳10:05

查看消息列表

历史记录 查询

用户操作:

请求查看指定会话的完整消息记录

系统结果:

返回按时间排序的消息列表,包含用户提问与智能体回复

修改消息

内容更新 更正

用户操作:

修改消息内容为"第二天可以安排哪些亲子海滩活动?"

系统结果:

更新消息内容,记录修改时间,保持会话上下文连贯

删除消息

内容管理 清理

用户操作:

删除会话中的重复提问消息

系统结果:

成功删除指定消息ID,保持会话记录整洁有序

清除会话上下文

重置 新话题

用户操作:

请求清除当前会话的历史上下文

系统结果:

重置会话上下文,保留会话ID但清空历史消息,可开始新话题

使用场景

智能客服系统

为企业构建智能客服,支持多轮对话,根据用户问题提供精准解答,提升客户服务效率。

智能助手应用

开发个人智能助手,管理日程安排、提供生活建议、解答各类问题,打造个性化助理体验。

在线教育辅导

创建教育类智能体,提供学科答疑、作业辅导、学习规划,实现个性化学习体验。

健康咨询服务

开发健康咨询智能体,提供日常健康建议、症状初步分析、健康管理方案,辅助健康决策。

电商购物助手

构建电商智能导购,根据用户需求推荐商品、解答产品疑问、提供购买建议,提升购物体验。

企业知识库

搭建企业内部知识问答系统,帮助员工快速获取公司政策、流程、产品信息,提高工作效率。

价格信息

价格由API服务商设定,详细的资费标准和套餐信息请到服务商官网查看。

查看火山引擎扣子平台官方定价

常见问题

如何开始使用智能体会话API?

首先需要在火山引擎扣子平台注册账号并创建智能体,获取API访问令牌(Access Token)。然后可以通过调用"创建会话"接口初始化一个对话,之后使用"添加消息"接口实现用户与智能体的交互。详细步骤可参考API文档中的快速入门指南。

会话和消息的存储期限是多久?

根据火山引擎扣子平台的政策,会话数据默认保留30天。如果需要长期保存对话记录,建议在收到API响应后将重要数据存储在您自己的服务器或数据库中。您也可以通过API主动删除不再需要的会话或消息以节省存储空间。

支持哪些类型的消息内容?

API支持多种消息内容类型,包括纯文本(text)和多模态内容(object_string)。多模态内容可以包含文本、图片和文件的组合。此外,智能体回复可能包含卡片(card)类型的内容,用于展示结构化信息。您可以通过content_type参数指定发送的消息类型。

如何处理会话中的上下文管理?

API会自动维护会话的上下文信息,智能体可以基于历史对话内容生成连贯的回复。如果需要开始新话题而不受之前对话影响,可以使用"清除上下文"接口重置当前会话,或者创建一个全新的会话。这两种方式都能确保对话从空白状态开始。

API调用有频率限制吗?

是的,火山引擎扣子平台对API调用实施频率限制,具体限制取决于您的服务套餐。默认情况下,普通用户有每秒钟10次的调用限制。如果您的应用需要更高的并发能力,可以联系火山引擎客服申请提高配额或选择更高级的套餐。建议在实现时添加请求限流和重试机制。