通过SendChatMessage发送或取消指定会话的消息-数据管理 DMS-阿里云

向指定会话发送用户消息或取消会话。

接口说明

请求说明

agent_id 和 session_id 是必填字段。
message_type 默认为 primary，当需要追加信息或取消会话时，请设置为 additional 或 cancel。
reply_to 字段用于表示这条消息是对哪条 Agent 消息的响应，默认值为 0。
当 message_type 为 additional 时，question 字段是必须的。
quoted_message 可以用来引用用户之前的消息内容。
data_source, dms_user, db_metadata, session_config 等字段均为可选，但提供了更详细的上下文信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dms:SendChatMessage

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
DMSUnit	string	否	您当前所在的 DMS 单元。若您选择分析数据库，该信息将用于后续通过 DMS 正确连接到您的 DMS 实例。您可前往 DMS 控制台查看您当前所在的 DMS 单元，若您是阿里云中国站用户，可以直接填入 cn-hangzhou。	cn-hangzhou
SessionId	string	是	会话 ID，必须字段。您可以通过 CreateAgentSession 获取 SessionId。	sess_***
AgentId	string	是	AgentId，必填。您可通过 CreateAgentSession 接口的返回值获取当前的 AgentID。Agent 资源存在生命周期，因此您每次请求需要填入的 AgentID 可能变化。	agent_***
Message	string	是	本次向 Agent 发送的消息内容	what can you do?
MessageType	string	否	消息类型，默认为 `[primary]`。当该消息为响应 Agent 的 Human-in-Loop 问题时，类型应当是`[additional]`；当该消息是要取消当前会话时，类型应当是`[cancel]`。	primary
ReplyTo	string	否	表示这条消息是对哪条 Agent 消息的响应。该字段应当传入当前收到的最大的 Checkpoint 序号，若是首条消息则填入 0。该字段会用于偶发网络问题或者消息重复发送时的消息去重。	0
QuotedMessage	string	否	传入当前引用内容，通常在与 Agent 交互时使用。	{"version":"v0"}
Question	string	否	当消息类型为`additional`时为必须字段，传入 Agent 通过 Human-in-Loop 向用户提问的具体问题。	请提供计算GMV的口径。
DataSource	object	否	数据源信息，可为空
DataSourceType	string	否	数据源类型。可取值`[remote_data_center, database]`，分别表示本次分析是文件或者数据库。	remote_data_center
DataSourceId	string	否	已废弃，无需填入	123
Location	string	否	已废弃，无需填入	localhost
Database	string	否	已废弃，无需填入	test_db
Engine	string	否	数据库类型	mysql
Tables	array	否	需要分析的表名称的列表
	string	否	需要分析的表名	my_table
FileId	string	否	文件 ID	35****
RegionId	string	否	地域 ID。	cn-hangzhou
DbName	string	否	数据库名称。	******
DmsInstanceId	string	否	实例在 DMS 的 ID	12******
DmsDatabaseId	string	否	数据库在 DMS 的 ID	23******
SessionConfig	object	否	本次会话的特殊配置。同一个 Session 只有第一次 SendMessage 的时候带下来的配置才会生效。
Language	string	否	当前只支持中英文，默认是中文，只支持大写	ENGLISH
CustomAgentId	string	否	已废弃，以 CreateAgentSession 入参为准	null
CustomAgentStage	string	否	已废弃，以 CreateAgentSession 入参为准	null
ReportWaterMark	string	否	可填入 64 字符以内的文本，会用于在生成的 PDF 格式的报告中添加水印。	示例水印

返回参数

名称	类型	描述	示例值
	object	Jarvis Web 应用收到请求并缓存之后，会直接响应 200。
RequestId	string	请求 ID	FE65CE1F-**---****
ErrorCode	string	错误码	Success
ErrorMessage	string	错误信息	""
Data	object	响应数据
Message	string	Message	success
SessionId	string	SessionId	6zbqbho********
AgentId	string	AgentId	3jqqdiuxun******
Success	string	Success	true

示例

正常返回示例

JSON格式

{
  "RequestId": "FE65CE1F-****-****-****-******",
  "ErrorCode": "Success",
  "ErrorMessage": "\"\"",
  "Data": {
    "Message": "success",
    "SessionId": "6zbqbho********",
    "AgentId": "3jqqdiuxun******"
  },
  "Success": "true"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。