文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 观测/ 智能体管理/ 更新智能体信息 - UpdateOpsAgentObservation
更新时间：2026-05-21 GMT+08:00
查看PDF
分享

更新智能体信息 - UpdateOpsAgentObservation

功能介绍

在观测页面查看修改信息后的智能体列表。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts::updateOpsAgentObservation

Write

-

-

-

-

URI

PUT /v1/ops/observation/agents/{agent_id}

表1 路径参数

参数

是否必选

参数类型

描述

agent_id

是

String

参数解释：

智能体ID，用于唯一标识智能体，可在智能体管理页面或通过查询智能体列表接口（ListOpsAgentObservation）获取。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

参数解释：

消息体编码格式。用于告知服务端请求体（Body）所采用的主体数据类型，以便服务端正确解析。

约束限制：

不涉及。

取值范围：

application/json。

默认取值：

application/json。

Authorization

是

String

参数解释：

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制：

SDK自动填充,格式为SDK-HMAC-SHA256。

取值范围：

符合签名规范的字符串。

默认取值：

不涉及。

X-Sdk-Date

是

String

参数解释：

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制：

符合ISO 8601格式。

取值范围：

格式为YYYYMMDDTHHMMSSZ,如20240416T095341Z。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

resource_id

是

String

参数解释：

智能体ID，用于唯一标识智能体，可在智能体管理页面或通过查询智能体列表接口（ListOpsAgentObservation）获取。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

resource_name

是

String

参数解释：

智能体名称，用于标识智能体的显示名称。

约束限制：

长度限制1-128位。

取值范围：

不涉及。

默认取值：

不涉及。

resource_type

是

String

参数解释：

智能体类型。

约束限制：

不涉及。

取值范围：

  • agent：单智能体。

  • multiagents：多智能体。

  • workflow：工作流。

默认取值：

不涉及。

status

否

String

参数解释：

状态。

约束限制：

不涉及。

取值范围：

  • published：发布。

  • draft：草稿。

默认取值：

不涉及。

create_by

否

String

参数解释：

创建人ID，用于标识智能体的创建者，可从用户认证信息或IAM服务获取。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

create_time

否

Integer

参数解释：

创建时间，13位毫秒级时间戳（ms）。

约束限制：

由数字组成，必须为13位毫秒级时间戳。

取值范围：

不涉及。

默认取值：

不涉及。

update_by

否

String

参数解释：

更新人ID，用于标识智能体的最后更新者，可从用户认证信息或IAM服务获取。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

updated_time

否

Integer

参数解释：

更新时间，13位毫秒级时间戳（ms）。

约束限制：

由数字组成。13位毫秒级时间戳。

取值范围：

不涉及。

默认取值：

不涉及。

version

否

String

参数解释：

智能体版本。

约束限制：

长度限制1-64位。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：201

更新成功。

无

请求示例

PUT https://*.com/v1/ops/observation/agents/000b2b01-6279-4c7a-a4e5-08fdca69cc66

Content-Type:application/json
X-Sdk-Date:20240416T095341Z
Authorization:SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************
  {
  "resource_id": "a04413fa-883a-4346-93df-34f49ee85e0c",
  "resource_name": "test2",
  "resource_type": "agent",
  "status": "draft",
  "create_by": "319c74a30677464db04f25ffd55ae3c8",
  "create_time": "1775701216815",
  "update_by": "319c74a30677464db04f25ffd55ae3c8",
  "updated_time": "1775701216815",
  "version": "0.0.1"
}

响应示例

无

状态码

状态码

描述

201

更新成功。

错误码

请参见错误码。

父主题： 智能体管理

相关文档