更新时间:2026-09-14 GMT+08:00
分享

数据上报准备

在上报观测数据前,您需要先在AgentArts平台创建智能体实体,并获取接入所需的凭证信息。API接入和SDK接入均需完成本章节的准备工作。

约束与限制

默认最多接入200个第三方托管智能体。当智能体数量达到上限时,可删除不再使用的智能体释放配额,或提交工单申请提升配额。

步骤一:创建智能体并获取接入凭证

  1. 登录AgentArts智能体平台。
  2. 在左侧导航栏中选择“观测与优化 > 观测”,并进入“智能体列表”页面。
  3. 单击“接入智能体”,填写智能体名称,并选择类型。类型按实际选择(可选值:单智能体、工作流、多智能体)。

    图1 智能体接入

  4. 填写完成后,单击“创建”,平台提示创建成功后,单击“下一步”,进入到接入流程页签。平台会自动创建接入信息。
  5. 根据您选择的接入方式(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
图4 获取domain id、user id

相关文档