数据上报准备
在上报观测数据前,您需要先在AgentArts平台创建智能体实体,并获取接入所需的凭证信息。API接入和SDK接入均需完成本章节的准备工作。
约束与限制
默认最多接入200个第三方托管智能体。当智能体数量达到上限时,可删除不再使用的智能体释放配额,或提交工单申请提升配额。
步骤一:创建智能体并获取接入凭证
- 登录AgentArts智能体平台。
- 在左侧导航栏中选择“观测与优化 > 观测”,并进入“智能体列表”页面。
- 单击“接入智能体”,填写智能体名称,并选择类型。类型按实际选择(可选值:单智能体、工作流、多智能体)。 图1 智能体接入
- 填写完成后,单击“创建”,平台提示创建成功后,单击“下一步”,进入到接入流程页签。平台会自动创建接入信息。
- 根据您选择的接入方式(API接入或SDK接入),在对应的页签中获取所需的接入参数。请妥善保管这些信息。
- API接入:选择"API接入"页签,根据上报类型(Trace上报 / Metric上报 / Log上报)分别获取对应参数。
- SDK接入:选择"SDK接入"页签,选择对应的框架类型,获取接入参数。
表1 API接入信息说明 类别
参数
说明
Trace上报
agent_id
智能体ID。
trace_endpoint
Trace数据接入地址。
trace_token
Trace上报鉴权Token。
Metric上报
metric_endpoint
Metric数据上报地址。
metric_token
Metric上报鉴权Token。
project_id
上报Metric数据时使用。在AgentArts页面获取。

promID
上报Metric数据时使用。在AgentArts页面获取。

Log上报
接入地址
Log数据完整接入地址,平台自动生成,直接复制使用。

__label__.task_name、__label__.task_type
智能体ID与智能体类型。

表2 SDK接入信息说明 参数
说明
agent_resource_id(智能体ID)
可在平台页面获取各参数取值。

resource_type(智能体类型)
agentarts_agentops_apm_token(API接入凭证Token)
agentarts_agentops_apm_exporter_endpoint(APM数据上报地址)
agentarts_agentops_aom_access_code(AOM接入凭证)
agentarts_agentops_aom_exporter_endpoint(AOM数据上报地址)
agentarts_agentops_aom_prometheus_id(Prometheus实例ID)
图2 记录接入地址、鉴权信息、智能体ID等信息
如果忘记获取该信息,单击智能体名称,在“接入指南”中重新获取。
图3 接入指南
步骤二:获取华为云账号信息
除平台接入凭证外,还需要获取华为云账号相关信息。登录“我的凭证 > API凭证”页面,记录以下信息:
- domain id:华为云账号ID
- user id:华为云IAM用户ID