创建 Agent
更新时间：2026-10-23
接口描述
在指定工作空间下初始化 Data Agent 会话。接口会校验工作空间所需资源，并返回固定业务 Agent ID 和新生成的会话 ID；不会提前创建 Runtime 热状态，也不会写入历史记录。
前置条件
- 工作空间默认资源组已绑定
DATAAGENT_CLUSTER资源； - 工作空间内至少存在一个生成式 AI模型服务。
请求结构
Plain Text
1POST /v2/workspaces/{workspaceId}/dataagent/agents/create路径参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
workspaceId |
string | 是 | 工作空间 ID，如 workspace_9862_0763f283d58a |
请求示例
Bash
1curl -X POST \
2 'https://{host}/databuilder/api/databuilder/v2/workspaces/workspace_9862_0763f283d58a/dataagent/agents/create' \
3 -H 'Content-Type: application/json' \
4 -H 'X-App-Id: dataagent-service' \
5 -H 'Authorization: <签名串>'响应示例
成功（HTTP 200）
JSON
1{
2 "id": "default",
3 "session_id": "session_1735000000000_a3f2b9"
4}| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 业务 Agent ID，当前固定为 default |
session_id |
string | 新生成的会话 ID，后续调用 stream 或 query 时传入 |
错误码
| HTTP 状态码 | 错误码 | 说明 |
|---|---|---|
| 400 | BadRequest |
请求 JSON 格式错误或参数不合法 |
| 400 | DataAgentResourceNotBound |
工作空间默认资源组未绑定 DATAAGENT_CLUSTER 资源，或工作空间内不存在可用的【生成式 AI】模型服务 |
| 500 | InternalServerError |
服务内部错误 |
评价此篇文章