删除消息

请求地址

权限

deleteMessage
确保调用该接口使用的访问令牌开通了 deleteMessage 权限，详细信息参考鉴权方式。

接口说明

调用接口在指定会话中删除消息。

Authorization

Bearer $Access_Token

用于验证客户端身份的访问令牌。你可以在扣子编程中生成访问令牌，详细信息，参考准备工作。

Content-Type

application/json

解释请求正文的方式。

conversation_id

String

必选

74076802623535*****

待删除的消息所属的会话 ID。

message_id

String

必选

74076856761178****

待删除的消息 ID，你可以选择删除会话中的 question 消息和 answer 消息。

• 待删除消息必须属于 conversation_id 指定的会话。
• 仅支持删除 type=answer 或 question 的消息，不支持单独删除 function_call 等中间态消息。当删除 type=answer 的消息时，系统会同步删除与之关联的 function_call 等中间态消息。

data

Object of OpenMessageApi

{ “bot_id”: “73250261716436*****”, “chat_id”: “74076802623535*****”, “content”: “您好呀！今天感觉怎么样？”, “content_type”: “text”, “conversation_id”: “74076802623535*****”, “created_at”: 1724734970, “id”: “74076802623536*****”, “meta_data”: {}, “role”: “assistant”, “type”: “answer”, “updated_at”: 1724734971 }

已删除的 Message 详情。

detail

Object of ResponseDetail

{ “logid”: “20250106172024B5F60***” }

响应详情。

code

Long

0

调用状态码。0 表示调用成功，其他值表示调用失败，你可以通过 msg 字段判断详细的错误原因。

msg

String

“”

状态信息。API 调用失败时可通过此字段查看详细错误信息。
状态码为 0 时，msg 默认为空。

id

String

738130009748252****

Message ID，即消息的唯一标识。

conversation_id

String

737999610479815****

此消息所在的会话 ID。

bot_id

String

747363834493437****

编写此消息的智能体 ID。此参数仅在对话产生的消息中返回。

chat_id

String

757363834493437****

Chat ID。此参数仅在对话产生的消息中返回。
不同的对话中，系统会生成新的chat_id。同一个用户在第一次对话和第二次对话时，chat_id不一样。

meta_data

JSON Map

{“source”:“mobile_app”,“location”:“Beijing”,“custom_flag”:“high_priority”}

创建消息时的附加信息，以键值对形式存储，获取消息时会原样返回。可用于存储与业务相关的自定义数据。

role

String

user

发送这条消息的实体。取值：

• user：代表该条消息内容是用户发送的。
• assistant：代表该条消息内容是 Bot 发送的。

content

String

早上好，今天星期几？

消息的内容，支持纯文本、多模态（文本、图片、文件混合输入）、卡片等多种类型的内容。

content_type

String

text

消息内容的类型，取值包括：

• text：文本。
• object_string：多模态内容，即文本和文件的组合、文本和图片的组合。
• card：卡片。此枚举值仅在接口响应中出现，不支持作为入参。

created_at

Long

1718592898

消息的创建时间，格式为 10 位的 Unixtime 时间戳，单位为秒（s）。

updated_at

Long

1718592898

消息的更新时间，格式为 10 位的 Unixtime 时间戳，单位为秒（s）。

type

String

question

消息类型。

• question：用户输入内容。
• answer：智能体返回给用户的消息内容，支持增量返回。如果工作流绑定了 messge 节点，可能会存在多 answer 场景，此时可以用流式返回的结束标志来判断所有 answer 完成。
• function_call：智能体对话过程中调用函数（function call）的中间结果。
• tool_response：调用工具 （function call）后返回的结果。
• follow_up：如果在 Bot 上配置打开了用户问题建议开关，则会返回推荐问题相关的回复内容。
• verbose：多 answer 场景下，服务端会返回一个 verbose 包，对应的 content 为 JSON 格式，content.msg_type =generate_answer_finish 代表全部 answer 回复完成。

section_id

String

757363834493437****

上下文片段 ID。每次清除上下文都会生成一个新的 section_id。

reasoning_content

String

好的，我现在需要给一个13岁的大学生提供学习建议。首先，我得考虑用户的情况……

模型的思维链（CoT），展示模型如何将复杂问题逐步分解为多个简单步骤并推导出最终答案。仅当模型支持深度思考、且智能体开启了深度思考时返回该字段，当前支持深度思考的模型请参考模型能力差异。

logid

String

20241210152726467C48D89D6DB2****

本次请求的日志 ID。如果遇到异常报错场景，且反复重试仍然报错，可以根据此 logid 及错误码联系扣子团队获取帮助。详细说明可参考获取帮助和技术支持。