Chat - DAS Agent 交互接口-数据库自治服务(DAS)-阿里云帮助中心

DAS大模型能力异步逻辑接口

接口说明

前提条件：

使用阿里云或 DAS 的 SDK 时，建议使用最新版本。
在使用 SDK 调用 DAS 服务时，需要将地域指定为 cn-shanghai。
仅开通了 DAS 企业版的数据库实例支持创建离线任务。DAS 企业版各个版本支持的数据库和地域请参见 DAS 产品系列及支持的功能。

更多使用 Chat 接口与 DAS Agent 进行交互的方法和示例，请参考 DAS Agent 交互最佳实践（集成 Chat API）。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

hdm:Chat

get

*全部资源

*

无

请求语法

POST /chat HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
Message	string	否	消息	{"id":"68fe0321-37fe-4c75-a118-b61b33156f6a","role":"user","content":[{"type":"text","text":"hello"}]}
SessionId	string	否	可选，会话 ID，格式为 UUID 字符串。如未指定默认创建新的会话。上下文对话需保持同一个会话 ID。	123e4567-e89b-12d3-a456-xxxxxxxxxxxx
AgentId	string	否	可选，用于服务的 Agent ID。可指定为开启 DAS Agent 后生成的 Agent 或主动创建的 Agent。如未指定则使用默认 Agent 进行服务。	ag-472T0DxtmjIxxxxx
Summary	string	否	是否输出摘要信息	false
Resume	string	否	用户交互反馈	[{"metadata":{"a2uiClientDataModel":{"decided":true,"interaction":{"request":{"allowFreeText":true,"question":"question?","options":[{"label":"162 个","value":"162"},{"label":"242 个","value":"242"},{"label":"243 个","value":"243"},{"label":"486 个","value":"486"}]},"kind":"choice","interruptId":"5857955e-4856-4ab3-969e-f8b4c484bda4","status":"pending"},"free_text":""},"a2uiAction":{"name":"das_interaction_response","context":{"value":"162"},"surfaceId":"render-choice-7c03eb4f927f42ff8c30b30a2cc0797d","sourceComponentId":"opts-0","timestamp":"2026-09-15T06:54:15.556Z"}},"payload":{"value":"162"},"interruptId":"5857955e-4856-4ab3-969e-f8b4c484bda4","status":"resolved"}]
ForwardedProps	string	否	转发的属性	{"enableInteractiveTools":true}

返回参数

名称	类型	描述	示例值
	object	Schema of Response
ActivityType	string	心跳	waiting_for_agent_thinking
AgentId	string	代理 ID	agent-7f9c2a81
Content	string	回答内容	I see you have several PolarDB instances, and I will query them for you shortly
Delta	string	是否增量内容	hello
Kind	string	STEP_STARTED 的步骤类型，例如 task	task
Label	string	STEP_STARTED 的子 agent 展示名	SQL性能诊断
MessageId	string	消息 ID	61820b594664275c4429****
Name	string	扩展 Key	summary
OriginatingToolCallId	string	调用工具的原始 ID	ag-xxxx
ParentAgentId	string	父级代理 ID	agent-3a6f1c92
ParentMessageId	string	父消息 ID	76bee207-31ee-4707-8851-6b9d4da033aa
Role	string	对话角色 ID	assistant
RunId	string	运行 ID	ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7
StepName	string	执行步骤名称	sub_agent_performance_diagnose_mysql
StepStatus	string	STEP_FINISHED 的步骤状态，例如 completed	completed
TaskTrackerId	string	回调工具类	das_api
ThreadId	string	线程 ID	8e481be1-21d5-4a92-a2fb-fb54be0ab4f6
Timestamp	integer	事件时间戳	1767225600000
ToolCallError	string	工具调用时发生的错误	error
ToolCallId	string	工具调用 ID	call_edf9cdb69e0e4c9796a6a5a6
ToolCallName	string	工具名称	das_api
Type	string	事件类型	TEXT_MESSAGE_CONTENT
Value	any	扩展 Value	{"CharCount":393,"End":1777428785996,"RequestId":"BE59AED5-D831-5811-BBAD-590B917B2089","SessionId":"123e4567-e89b-12d3-a456-xxxxxxxxxxxx","Start":1777428707927}

示例

正常返回示例

JSON格式

{
  "ActivityType": "waiting_for_agent_thinking",
  "AgentId": "agent-7f9c2a81",
  "Content": "I see you have several PolarDB instances, and I will query them for you shortly",
  "Delta": "hello",
  "Kind": "task",
  "Label": "SQL性能诊断",
  "MessageId": "61820b594664275c4429****",
  "Name": "summary",
  "OriginatingToolCallId": "ag-xxxx",
  "ParentAgentId": " agent-3a6f1c92",
  "ParentMessageId": "76bee207-31ee-4707-8851-6b9d4da033aa",
  "Role": "assistant",
  "RunId": "ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7",
  "StepName": "sub_agent_performance_diagnose_mysql",
  "StepStatus": "completed",
  "TaskTrackerId": "das_api",
  "ThreadId": "8e481be1-21d5-4a92-a2fb-fb54be0ab4f6",
  "Timestamp": 1767225600000,
  "ToolCallError": "error",
  "ToolCallId": "call_edf9cdb69e0e4c9796a6a5a6",
  "ToolCallName": "das_api",
  "Type": "TEXT_MESSAGE_CONTENT",
  "Value": "{\"CharCount\":393,\"End\":1777428785996,\"RequestId\":\"BE59AED5-D831-5811-BBAD-590B917B2089\",\"SessionId\":\"123e4567-e89b-12d3-a456-xxxxxxxxxxxx\",\"Start\":1777428707927}"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParams	The request parameters are invalid.	请求参数错误
500	Timeout	The request processing has failed due to timeout.	由于超时请求处理失败。
403	NoPermission	You are not authorized to do this action.	没有权限执行该操作
404	InstanceNotFound	Requested instance not found.	对应实例id无法找到

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

变更历史

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