DAS大模型能力异步逻辑接口
接口说明
前提条件:
使用阿里云或 DAS 的 SDK 时,建议使用最新版本。
在使用 SDK 调用 DAS 服务时,需要将地域指定为 cn-shanghai。
仅开通了 DAS 企业版的数据库实例支持创建离线任务。DAS 企业版各个版本支持的数据库和地域请参见 DAS 产品系列及支持的功能。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| Type |
string |
事件类型 |
TEXT_MESSAGE_CONTENT |
| MessageId |
string |
消息 ID |
61820b594664275c4429**** |
| Role |
string |
对话角色 ID |
assistant |
| Delta |
string |
是否增量内容 |
hello |
| ActivityType |
string |
心跳 |
waiting_for_agent_thinking |
| ToolCallId |
string |
工具调用 ID |
call_edf9cdb69e0e4c9796a6a5a6 |
| ToolCallName |
string |
工具名称 |
das_api |
| Content |
string |
回答内容 |
I see you have several PolarDB instances, and I will query them for you shortly |
| ParentMessageId |
string |
父消息 ID |
76bee207-31ee-4707-8851-6b9d4da033aa |
| ThreadId |
string |
线程 ID |
8e481be1-21d5-4a92-a2fb-fb54be0ab4f6 |
| StepName |
string |
执行步骤名称 |
sub_agent_performance_diagnose_mysql |
| RunId |
string |
运行 ID |
ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7 |
| TaskTrackerId |
string |
回调工具类 |
das_api |
| Name |
string |
扩展 Key |
summary |
| Value |
any |
扩展 Value |
{"CharCount":393,"End":1777428785996,"RequestId":"BE59AED5-D831-5811-BBAD-590B917B2089","SessionId":"123e4567-e89b-12d3-a456-xxxxxxxxxxxx","Start":1777428707927} |
示例
正常返回示例
JSON格式
{
"Type": "TEXT_MESSAGE_CONTENT",
"MessageId": "61820b594664275c4429****",
"Role": "assistant",
"Delta": "hello",
"ActivityType": "waiting_for_agent_thinking",
"ToolCallId": "call_edf9cdb69e0e4c9796a6a5a6",
"ToolCallName": "das_api",
"Content": "I see you have several PolarDB instances, and I will query them for you shortly",
"ParentMessageId": "76bee207-31ee-4707-8851-6b9d4da033aa",
"ThreadId": "8e481be1-21d5-4a92-a2fb-fb54be0ab4f6",
"StepName": "sub_agent_performance_diagnose_mysql",
"RunId": "ed7cb7b1-ddc8-45d7-9ff3-b315726cb5f7",
"TaskTrackerId": "das_api",
"Name": "summary",
"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无法找到 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。