j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ 观测/ / 将智能体信息同步至观测页面 - createopsagent
更新时间：2026-07-15 gmt 08:00
查看pdf

将智能体信息同步至观测页面 -j9九游会登录

功能介绍

通过此接口可以在观测页面查看该智能体上报的数据信息。

调用方法

请参见如何调用api。

授权信息

当前api调用无需身份策略权限。

uri

post /v1/ops/observation/agents

请求参数

表1 请求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位。

取值范围：

不涉及。

默认取值：

不涉及。

source

否

string

参数解释：

智能体类型。

约束限制：

不涉及。

取值范围：

  • studio

  • agentrun

  • api

默认取值：

默认为studio

apm_app_id

否

string

参数解释：

apm的app_id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

aom_prom_id

否

string

参数解释：

aom的app_id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

apm_app_token

否

string

参数解释：

apm token，加密存储。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

aom_access_code

否

string

参数解释：

aom access_code，加密存储。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

lts_group_id

否

string

参数解释：

lts日志组id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

lts_stream_id

否

string

参数解释：

lts日志流id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

lts_label_name

否

string

参数解释：

用于过滤lts日志标签的，key是 labels.task_name，对于需要查询日志上报的应用，必填，studio发布的应用必填，否则无法查询到应用日志。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表2 响应body参数

参数

参数类型

描述

resource_id

string

参数解释：

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

取值范围：

不涉及。

resource_name

string

参数解释：

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

取值范围：

不涉及。

resource_type

string

参数解释：

智能体类型。

取值范围：

  • agent：单智能体。

  • multiagents：多智能体。

  • workflow：工作流。

status

string

参数解释：

状态。

取值范围：

  • published：发布。

  • draft：草稿。

created_at

string

参数解释：

该合成条目生成的精确时间戳。

取值范围：

日期时间字符串。

updated_at

string

参数解释：

该合成条目生成的精确时间戳。

约束限制：

符合iso8601标准。

取值范围：

日期时间字符串。

默认取值：

不涉及。

version

string

参数解释：

智能体版本。

取值范围：

不涉及。

source

string

参数解释：

智能体类型。

取值范围：

  • studio

  • agentrun

  • api

apm_app_id

string

参数解释：

apm的app_id。

取值范围：

不涉及。

aom_prom_id

string

参数解释：

aom的app_id。

取值范围：

不涉及。

apm_app_token

string

参数解释：

apm token，加密存储。

取值范围：

不涉及。

aom_access_code

string

参数解释：

aom access_code，加密存储。

取值范围：

不涉及。

lts_group_id

string

参数解释：

lts日志组id。

取值范围：

不涉及。

lts_stream_id

string

参数解释：

lts日志流id。

取值范围：

不涉及。

lts_label_name

string

参数解释：

用于过滤lts日志标签的，key是 labels.task_name，对于需要查询日志上报的应用，必填，studio发布的应用必填，否则无法查询到应用日志。

取值范围：

不涉及。

apm_exporter_endpoint

string

参数解释：

apm上报地址。

取值范围：

不涉及。

aom_exporter_endpoint

string

aom上报地址

请求示例

post https://api.example.com/v1/ops/observation/agents
{
  "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"
}

响应示例

无

状态码

状态码

描述

200

同步响应

错误码

请参见错误码。

父主题：

相关文档

网站地图