创建Agent
更新时间：2026-07-14
创建Agent
- 创建一个新的 Agent。同一 domain 下 Agent 名称不能重复。
OpenAPI Explorer
去调试
您可以在 OpenAPI Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/agent-identity/agent/create HTTP/1.1
2Host: identity.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| name | String | 是 | RequestBody参数 | Agent 名称，1-64 字符，仅允许字母、数字、下划线和连字符（^[a-zA-Z0-9_-]+$） |
| description | String | 否 | RequestBody参数 | Agent 描述，1-128 字符 |
| allowedResourceOauth2ReturnUrls | List |
否 | RequestBody参数 | OAuth2 回调 URL 白名单列表，最多 10 个，每个最长 512 字符 |
返回状态码
成功返回200；参数缺失或无效返回400；Agent 名称已存在返回409。详见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
AgentDTO 对象
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | Agent ID |
| bceDomainId | String | BCE 账户 ID |
| bceUserId | String | BCE 用户 ID |
| name | String | Agent 名称 |
| description | String | Agent 描述 |
| extra | String | 扩展信息 |
| allowedResourceOauth2ReturnUrls | List |
OAuth2 回调 URL 白名单列表 |
| createdAt | DateTime | 创建时间 |
| updatedAt | DateTime | 更新时间 |
请求示例
Plain Text
1{
2 "name": "my-agent-01",
3 "description": "用于数据处理的智能体",
4 "allowedResourceOauth2ReturnUrls": [
5 "https://my-app.example.com/oauth2/callback",
6 "http://localhost:8080/oauth2/callback"
7 ]
8}返回示例
Plain Text
1{
2 "id": "ag-xxxxxxxxxx",
3 "bceDomainId": "d-xxxxxxxxxx",
4 "bceUserId": "u-xxxxxxxxxx",
5 "name": "my-agent-01",
6 "description": "用于数据处理的智能体",
7 "allowedResourceOauth2ReturnUrls": [
8 "https://my-app.example.com/oauth2/callback",
9 "http://localhost:8080/oauth2/callback"
10 ],
11 "createdAt": "2025-01-01T00:00:00Z",
12 "updatedAt": "2025-01-01T00:00:00Z"
13}评价此篇文章