2026智果AgentArts智能体平台智能体运营运维报告

智果（AgentArts）智能体平台智能体运营运维文档版本01发布日期2026-07-13文档版本01(2026-07-13)版权所有©华为云计算技术有限公司i版权所有⑥华为云计算技术有限公司202非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并HUAWIHUAWI您购买的产品、服务或特性等应受华为云计算技术有限公司商业合同和条款的约束，本文档中描分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为云计算技术有由于产品版本升级或其他原因，本文档内容会不定期进行更地址：贵州省贵安新区黔中大道交兴功路华为云数据中心邮编：550029网址：/智果（AgentArts）智能体平台文档版本01(2026-07-13)版权所有©华为云计算技术有限公司ii 1.1观测介绍 11.2数据上报 1.2.1数据上报概述 71.2.2上报AgentArts中的智能体数据 1.2.3上报高代码智能体数据 131.2.4上报第三方智能体Trace、Metric数据 17功能介绍 17数据上报准备 19Trace数据上报 21Metric数据上报 31OpenTelemetry字段映射 401.3查看应用指标信息 501.3.1查看业务指标信息 501.3.2查看运营指标信息 531.4查看应用调用链信息 561.5查看会话分析信息 63 661.6.1查看高代码智能体运行时数据信息 661.6.2查看沙箱工具数据信息 681.6.3查看网关数据信息 701.7查看第三方智能体上报的Trace、Metric数据 71 761.9数据回流 811.9.1Trace数据回流 81 2.1评估介绍 88 922.3示例：基于离线任务进行评估 100 1122.4.1人工创建单轮评测集 112 1172.4.3AI合成评测集 121智果（AgentArts）智能体平台文档版本01(2026-07-13)版权所有©华为云计算技术有限公司iii 129 133 1382.5评估器 1412.5.1评估器介绍 141 142创建模型判定评估器 142创建自适应判定评估器 1482.5.3维护评估器 1522.5.4预置评估器 154预置评估器概览 154预置评估器 156.1正确性 156.2AI味检查 157.3任务完成度 158.4轨迹质量 159.5不敏感性 162.6争议性 163.7创意性 164.8参考答案遵从度 166.9工具参数正确性 167.10工具选择质量 169.11幻觉现象 170.12性别歧视 172.13恶意性 173.14指令遵从度 174.15拒答检测 175.16格式检查 176.17语种一致性 177.18文本可用性 179.19安全风险漏放 180.20有害性 181.21有用性 183.22深度性 184.23犯罪性 185.24引用相关性 187.25知识问答-指令遵循 188.26知识问答-真实准确 189.27知识问答-精炼性 191.28知识问答-便捷性 192.29知识问答-丰富度 193.30简洁性 195智果（AgentArts）智能体平台文档版本01(2026-07-13)版权所有©华为云计算技术有限公司iv.31细节丰富度 196.32轨迹-工具参数填充正确性 197.33轮次相关性 199.34知识保持 200.35对话完整性 202.36主题遵从 203.37角色遵从 204.38文本等值判断 206.39文本包含判断 207.40文本正则匹配 208.41文本起始子串判断 209.42文本JSON格式校验 210.43数学表达式相等判断 211.44JSON相等判断 212 2132.6.1创建评估任务 213创建离线评估任务 213创建在线评估任务 219维护评估任务 224 2262.6.3对比评估任务结果 231 2342.6.5评估结果回流 239智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司11智能体观测在AI应用的开发与部署过程中，请求调用路径往往复杂交错，难以追踪关键节点，导观测功能通过在请求处理的每个关键节点插入探针，自动信息，构建完整的调用链（Trace并通过可视化界面展示，帮助例如，当用户发起请求时，系统会记录从请求开始到最终返回响应的观测功能覆盖了以下几类关键数据，帮助开发者和运维人员全面掌握Agent的运行状览展示关键业务指标（如Tokens消耗、Trace数、响应），表析一次完整请求的全生命周期记录，呈现了从请求发起到最终返回结果的下图是一次请求的完整数据记录，从请求输入到最终返回结果，智能体运营运维●查看数据流转：在左侧调用树中单击目标Span节点，可在“●排查节点报错：如果调用过程中节点发生报“链路信息”页签将展示相应的报错详情，元数据是运行过程中的键值对集合，用于存储运行实例的补充智果（AgentArts）智能体平台智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司4附加在Span上的自定义信息。可以使用标注对Trace数据进行分类、筛选或标记特殊事件。标注数据支持按场景筛选并回流至评测集，用于对特定场景下的智例如标记某次对话为“优质回答案例”。通过标注筛选，可以快速构测数据集，用于后续的智能体效果验证。如何标注请参考人工标用于反映系统运行的宏观状态和性能健康度，常见类型包括Tokens消耗、请求数、错误数和平均响应时间；您可以通过指标图表查看当前Span的指标。智能体运营运维链中，日志详细记录了智能体的思考过程、工具调用的原始输入输出信●示例问题：调用链路中存在多个耗时环节，导致整体响应时间过长。智能体运营运维●解决思路：通过调用链分析功能，可以在“调用链详情”页面中耗时，定位最长耗时的组件，从而进行优化。例如，发现某个工●示例问题：通过旅游智能助手查询南京的博物馆信息，模型调用博物馆推荐工●解决思路：在“调用链详情”页面，通过查看模型节点的Spa●解决思路：调用链分析发现，模型在多次对话中反复调用高成本的长文本生成服●处理结果：通过增加上下文判断逻辑避免重复生成，引入缓存机制复用常见问题●解决思路：通过观测功能收集特●处理结果：通过评估结果识别高频问题，优化对应的问题以提升智能体响应的准在观测界面展示数据不收取任何费用，但智能体数据上报产生的日志、●调用链：开启后，调用链数据会上报到应用性能管●指标：开启后，指标数据会上报到应用运维管理AOM，费用明细请参考AOM计智能体运营运维智能体应用不同于传统的确定性程序，其运行过程具有高度的动态●“黑盒”运行：难以直观判断智能体为何做出某种决策，或在哪一步骤发生了阻●故障定界难：当智能体输出结果异常时，难以快速定位是模型幻觉、工具调用失●性能瓶颈模糊：无法量化各环节（如模型响应耗时、工具执行时长）的性能分数据采集与分析能力，支持平台原生应用自动上报、高代码应用集成上体，平台会自动上报；如果为本地高代码开发，选择高代码集成上智能体报在观测界面展示数据不收取任何费用，但智能体数据上报产生的日志、智能体运营运维●调用链：开启后，调用链数据会上报到应用性能●指标：开启后，指标数据会上报到应用运维管理AOM，费用明细请参考AOM计AgentArts智能体数据上报●全流程自动采集：智能体发布后，系统将自动上报通过说明●应用调优：开发者可以使用Trace数据实时查看各环节（如模的执行情况。通过可视化的调用链路，快速定位逻辑中断或性能瓶托管的方式，并配置数据上报开关，即可实现运行数据的自动上●运行数据观测：数据上报后，开发者可实时监测本地开发智能体的运行状态。智能体运营运维OpenTelemetry数据上报开发者只需要在平台创建一个智能体实体接入凭证注意智果（AgentArts）智能体平台智能体运营运维3.关闭方式：如需停止数据上报，请在智能体“提交版本”页面据上报开关。关闭数据上报开关后，智能体将不再上报新的数据本文档以单智能体开启数据上报为例进行说明。工作流与多智能体应在观测界面展示数据不收取任何费用，但智能体数据上报产生的日志、●调用链：开启后，调用链数据会上报到应用性能●指标：开启后，指标数据会上报到应用运维管理AOM，费用明细请参考AOM计步骤1登录AgentArts智能体平台。步骤5在“部署智能体”页面，开启“日志记录”、“调用链智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司11除了上述方式外，进入“部署运行>智能体运行时”，并单击“名称/ID”，在“编步骤6开关开启后，可以通过API调用触发一次智能体交互。在“运营运维>观测>调用链分析”页面，如果能查到最新的交互记录，说明数据上报已生效。通过API调用智能体智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司12调用链1.调用链分析：查看信智能体运营运维开关名称开启后展示的观测界面及内容开关名称开启后展示的观测界面及内容●调用链分析：查看请求的完整调用链路，定位性能瓶颈或故障节点。●会话分析：智能体与用户对话的历史数据，为优化对话逻辑与服务质量提供依在本地开发智能体时，由于运行环境缺乏有效的监测手段，开发者往往将转化为可视化的视图与日志详情，实现运行日志的可视化查看与检索智果（AgentArts）智能体平台智能体运营运维了本地运行的信息壁垒，更帮助开发者快速排查运托管智能体的调用链与指标查看功能正在规划中在可观测界面展示数据不收取任何费用，但智能体数据上报至其他服务费，并提供一定量的免费额度，超出免费额度部分按实际使用量计费，步骤1登录AgentArts智能体平台。步骤3在配置界面中，开启“日志记录”开关。其余托管智能面，如果能查到最新的运行日志，说明数据上报已成功。查看智能体运步骤1登录AgentArts智能体平台。智果（AgentArts）智能体平台智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司15步骤3单击右上角“创建代码解释器”，在配置界面中，开配置生效后，您可通过执行相关操作触发日志生成，并在‘运营运维>观测>智能体运行分析’页面验证数据是否上报成功。查看沙箱工具调用过程中的详步骤1登录AgentArts智能体平台。步骤2在左侧导航栏选择“开发中心>组件库”，单击“网关步骤3单击右上角“创建网关”，在配置界面中，开启“日智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司16配置生效后，您可通过执行相关操作触发日志生成，并在‘运营运维>观测>智能体运行分析’页面验证数据是否上报成功。查看网关调用过程中的详细日步骤1登录AgentArts智能体平台。步骤2在左侧导航栏选择“运营运维>观测步骤3在“智能体运行分析”页签中，即可查看智能体运行智能体运营运维智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司18表1-5AgentArts观测数据来源在AgentArts平台内创建的智能体通过API调用后，系AgentArts平台运行的智能体托管至AgentArts平台后上报部署至AgentArts运行时后上报。通过API或AgentArtsSDK调用后，非AgentArts平台开发的第对接观测OpenAPI上报通过对接观测OpenAPI进如果您的智能体不是在AgentArts平台上开发或部署在AgentArts平台，可以通过观测OpenAPI，将智能体的Trace（调用链）和Metric（指标）数据上报至平台。该OpenAPI接收的数据格式遵循OpenTelemetry（OTel）协议（一种开源的可观测性标），典型场景：您已使用LangChain等框架开发了智能体应用，希望借助AgentArts的观测能力监控其调用链路、分析Token消耗和排查异常，此时可通过OpenTelemetry协议将运行数据上报至AgentArts。如果您不熟悉OpenTelemetry，可参考官方文档、OpenTelemetry字段映射进行了解，理解数Trace（调用链）Metric（指标）记录聚合统计信息，如请求次数、Token消耗量、成功率通过观测OpenAPI上报数据时，开发者需要在智能体代码中埋点采集观测数据（例如创建Span、设置Attribute等），并通过OpenAPI将数据发送至AgentArts。这种方式智果（AgentArts）智能体平台智能体运营运维▼▼详细计费规则请参考APM计费说明和AOM计步骤1登录AgentArts智能体平台。步骤3单击“智能体接入”，填写智能体名称，并选择类型智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司20metric_endpointtrace_endpointmetric_endpointtrace_endpointMetric上报metric_tokentrace_tokenproject_idagent_idTrace上报智能体ID。Trace数据接入地址。Trace上报鉴权Token。Metric数据上报地址。Metric上报鉴权Token。上报Metric数据时使用。在AgentArts页面获取。promID上报Metric数据时使用。在AgentArts页面获取。智果（AgentArts）智能体平台智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司21Trace数据用于记录智能体的单次请求详情，包括调用链路、节点耗时、模型输入输出下面以Python语言开发的智能体为例，介绍如何将Trace数据上报至AgentArts观测平第三方智能体上报的Trace数据将直接写入您的华为云应用性能管理APM服务。APM会根据上报的数据量按需计费。为避免在生产环境因大并发测试产生意外费用，请安装OpenTelemetryPythonSDK及相关依赖库。要求Python3.9或以上版本。pippipinstallopentelemetry-distro==0.62b1pipinstallopentelemetry-api==1.41.1pipinstallopentelemetry-exporter-otlp==1.41.1pipinstalltraceloop-sdk==0.60.0步骤1在AgentArts平台左侧导航栏中选择“运营运维>观测”，并进入“智能体列表”页智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司22智能体ID等信息。请妥善保管该信息。agent_id智能体ID。trace_endpointtrace_tokenTrace上报鉴权Token。在上报Trace数据前，需配置环境变量。服务名称（OTEL_SERVICE_NAME）必须遵循AgentArts.{{智能体ID}}.{{版本号}}的格式（版本号默认填写default）。OTELOTEL_SERVICE_NAME=AgentArts.{智能体ID}.defaultOTEL_EXPORTER_OTLP_TRACES_HEADERS=Authentication={trace_token}智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司23OTELOTEL_EXPORTER_OTLP_TRACES_ENDPOINT={trace_endpoint}OTEL_EXPORTER_OTLP_TRACES_INSECURE=true本示例为连通性测试示例，为首次接入AgentArts时，验证上报地址、Token和智能体ID是否配置正确使用，并确认平台能否正常接收数据。此阶段使用手动构造的静态数importosimporttimefromopentelemetryimporttracefromopentelemetry.sdk.traceimportTracerProviderfromto.grpc.trace_exporterimportOTLPSpanExporterfromopentelemetry.sdk.trace.exportimportBatchSpanProcessorAGENT_ID="您的智能体ID"AGENT_NAME="您的智能体名称"TRACE_ENDPOINT="您的Trace接入地址"TRACE_TOKEN="您的Trace鉴权Token"os.environ["OTEL_SERVICE_NAME"]=f"AgentArts.{AGENT_ID}.default"os.environ["OTEL_EXPORTER_OTLP_TRACES_HEADERS"]=f"Authentication={TRACE_TOKEN}"os.environ["OTEL_EXPORTER_OTLP_TRACES_ENDPOINT"]=TRACE_ENDPOINTos.environ["OTEL_EXPORTER_OTLP_TRACES_INSECURE"]="true"tracer_provider=TracerProvider()tracer_provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))trace.set_tracer_provider(tracer_provider)tracer=trace.get_tracer(__name__)deftest_connection():mock_session_id="test_session_12345"mock_user_id="test_user"#创建RootSpan(根节点)withtracer.start_as_current_span("test_user_request")asroot:root.set_attribute("gen_ai.span.type","root")root.set_attribute("gen_ai.resource.id",AGENT_ID)root.set_attribute("gen_",AGENT_NAME)root.set_attribute("gen_ai.resource.type","agent")root.set_attribute("gen_ai.application_name","default")root.set_attribute("gen_ai.environment","default")root.set_attribute("gen_ai.call.type","API")root.set_attribute("gen_ai.conversation.id",mock_session_id)root.set_attribute("gen_ai.user.id",mock_user_id)root.set_attribute("input.value","测试输入")#创建ModelSpan(大模型子节点)withtracer.start_as_current_span("test_llm_call")asmodel_span:model_span.set_attribute("gen_ai.span.type","model")model_span.set_attribute("gen_ai.resource.id",AGENT_ID)model_span.set_attribute("gen_ai.resource.type","agent")model_span.set_attribute("gen_",AGENT_NAME)model_span.set_attribute("gen_ai.conversation.id",mock_session_id)model_span.set_attribute("gen_ai.user.id",mock_user_id)model_span.set_attribute("traceloop.workflow.type","LLM")model_span.set_attribute("gen_ai.request.model","deepseek-v4-pro")#【注意】此处为模拟数据，仅供测试连通性，实际场景需要从真实的响应中time.sleep(0.5)model_span.set_attribute("gen_ai.usage.input_tokens","100")model_span.set_attribute("gen_ai.usage.output_tokens","200")model_span.set_attribute("gen_ai.usage.total_tokens","300")model_span.set_attribute("gen_ai.client.operation.duration","0.5")model_span.set_attribute("input.value","测试输入")智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司24modelmodel_span.set_attribute("output.value","测试输出")root.set_attribute("output.value","测试输出")if__name__=="__main__":test_connection()tracer_provider.shutdown()#刷新数据至服务端print("测试Trace数据已发送，请前往AgentArts控制台查看。")为了保证您的第三方Trace数据能够被AgentArts观测控制台正确识别、解析并展示在各种分析图表中，您在手动埋点上报时，必须严格遵守以下字段命名范。关于所有可设置的Attribute字段及含义，请参考OpenTelemetry字段映射。表1-9Attribute说明Attributegen_ai.span.type是区分节点类型。RootSpan填写节点填"root"，除了RootSpan之外的其余节点填"model"。gen_ai.resource.id是智能体ID，直接作为字符串写入。gen_ai.resource.ty是资源类型，默认填写"agent"。gen_ai.conversation.id是用户本次对话的唯一会话ID。用于在平gen_ai.agent.name是gen_ai.call.type是触发类型固定填写"API"。gen_ai.request.model否调用的模型名称（如"deepseek-v4-pro"）。gen_ai.usage.input_tokens否输入Token消耗量。gen_ai.usage.output_tokens否输出Token消耗量。gen_ai.usage.total_tokens否Token总消耗量。gen_ai.client.operation.duration否traceloop.workflow.type否系统协议标识。对ModelSpan节点必须填充"LLM"字符串。用于在平台“调用链分析”过滤“Modelspan”时，精确input.value是当前节点的原始输入文本（对Root节点为用户提问，对Model节点为模型输智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司25Attributeoutput.value是当前节点的最终输出文本（对Root节点为智能体回答，对Model节点为模型生数据上报后，在“运营运维>观测>智能体列表”页面，单击对应的智能体名称，在本示例中的脚本会启动一个本地交互式终端，您可以像聊天一样在终能体对话。在对话过程中，代码会自动创建RootSpan和ModelSpan两层Span，并在调用模型成功后，动态提取真实的提问、回复、Token消耗以及网络耗时上报给AgentArts。请在你的电脑终端（Windows的CMD或macOS/Linux的Terminal）中执行以下命令，安装所需的Python依赖库：pippipinstallopentelemetry-api==1.41.1pipinstallopentelemetry-sdk==1.41.1pipinstallopentelemetry-exporter-otlp==1.41.1pipinstallopenai==1.14.0pipinstallpython-dotenv==1.0.0安装完成后，在您的代码文件夹下创建一个名为.env的文本文件。填写华为云MaaS服务的模型APlKey和AgentArts平台上获取的真实凭证：##==========================================#1.智能体大模型的APl凭证（以接入MaaS的OpenAl兼容接口为例）#==========================================MODEL_NAME=deepseek-v4-proMODEL_URL=/openai/v1MODEL_APl_KEY=换成在MaaS上申请的模型APl_Key#==========================================智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司26##2.华为云AgentArts观测接入凭证#==========================================AGENT_ID=换成智能体IDDOMAIN_ID=换成华为云账号ID（在控制台右上角“我的凭证”中复制，不要填假数据，否则会被平台隔离过滤）USER_ID=换成华为云IAM用户ID（在控制台右上角“我的凭证”中复制，不要填假数据，否则会被平台隔离过滤）TRACE_ENDPOINT=换成Trace数据接入地址（格式如）TRACE_TOKEN=换成Trace上报鉴权TokenMODEL_NAMEMODEL_NAME华为云MaaS服务的模型名称。取值为OpenAI兼容接口中的model参数。MODEL_URL华为云MaaS服务的模型URL，采用OpenAI兼容接口。取值为：/openai/v1。MODEL_API_KEY华为云MaaS服务的模型APIKey，请登录MaaS服务获取。文档版本01(2026-07-13)版权所有©华为云计算技术有限公司27Trace数据接入地址、Trace上报鉴权Token、智能华为云账号ID、华为云IAM用户ID，图1-30获取domainid、useridTRACE_ENDPOINTTRACE_TOKENAGENT_IDDOMAIN_IDUSER_ID创建一个名为agent_trace.py的代码文件，并填写如下内容：importimportosimporttimeimportuuidfromopenaiimportOpenAIfromdotenvimportload_dotenvfromopentelemetryimporttracefromopentelemetry.sdk.traceimportTracerProviderfromto.grpc.trace_exporterimportOTLPSpanExporterfromopentelemetry.sdk.trace.exportimportBatchSpanProcessorload_dotenv()AGENT_ID=os.getenv("AGENT_ID")AGENT_NAME=os.getenv("AGENT_NAME")TRACE_ENDPOINT=os.getenv("TRACE_ENDPOINT")TRACE_TOKEN=os.getenv("TRACE_TOKEN")智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司28USERUSER_ID=os.getenv("USER_ID")os.environ["OTEL_SERVICE_NAME"]=f"AgentArts.{AGENT_ID}.default"os.environ["OTEL_EXPORTER_OTLP_TRACES_HEADERS"]=f"Authentication={TRACE_TOKEN}"os.environ["OTEL_EXPORTER_OTLP_TRACES_ENDPOINT"]=TRACE_ENDPOINTos.environ["OTEL_EXPORTER_OTLP_TRACES_INSECURE"]="true"#初始化OTelTracer提供者tracer_provider=TracerProvider()tracer_provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))trace.set_tracer_provider(tracer_provider)tracer=trace.get_tracer(__name__)defchat_with_agent(user_query:str,session_id:str):"""模拟与智能体对话，并在执行过程中自动上报Trace链路数据"""#实例化大模型客户端（调用华为云MaaS的接口）client=OpenAI(api_key=os.getenv("MODEL_API_KEY"),base_url=os.getenv("MODEL_URL"))#1.启动最外层RootSpan，记录整个交互会话的生命周期withtracer.start_as_current_span("agent_dialogue_session")asroot_span:root_span.set_attribute("gen_ai.span.type","root")root_span.set_attribute("gen_ai.resource.id",AGENT_ID)root_span.set_attribute("gen_",AGENT_NAME)root_span.set_attribute("gen_ai.resource.type","agent")root_span.set_attribute("gen_ai.call.type","API")root_span.set_attribute("gen_ai.conversation.id",session_id)root_span.set_attribute("gen_ai.user.id",USER_ID)root_span.set_attribute("input.value",user_query)#记录Root节点的原始输入#2.启动大模型子Span，专门记录LLM推理过程withtracer.start_as_current_span("llm_inference_call")asmodel_span:#作用说明：标识当前节点类型为模型调用节点，model_span.set_attribute("gen_ai.span.type","model")#作用说明：模型节点上也必须携带资源ID与类型，防止Umodel_span.set_attribute("gen_ai.resource.id",AGENT_ID)model_span.set_attribute("gen_ai.resource.type","agent")model_span.set_attribute("gen_",AGENT_NAME)model_span.set_attribute("gen_ai.conversation.id",session_id)model_span.set_attribute("gen_ai.user.id",USER_ID)model_span.set_attribute("traceloop.workflow.type","LLM")model_span.set_attribute("gen_ai.request.model",os.getenv("MODEL_NAME"))start_time=time.time()completion=pletions.create(model=os.getenv("MODEL_NAME"),messages=[{"role":"user","content":user_query}])duration=time.time()-start_time#动态捕获模型返回的真实响应数据与Token消耗usage=completion.usageresponse_content=completion.choices[0].message.content#3.将真实捕获的运行时参数动态注入属model_span.set_attribute("gen_ai.usage.input_tokens",mpt_tokens)#作用说明：记录输入Token文档版本01(2026-07-13)版权所有©华为云计算技术有限公司29modelmodel_span.set_attribute("gen_ai.usage.output_tokens",pletion_tokens)#作用说明：记录输出Tokenmodel_span.set_attribute("gen_ai.usage.total_tokens",usage.total_tokens)#作用说明：记录总Token消耗model_span.set_attribute("gen_ai.client.operation.duration",str(duration))#作用说明：记录大模model_span.set_attribute("input.value",user_query)#作用说明：记录真实提问model_span.set_attribute("output.value",response_content)#作用说明：记录模型真#在RootSpan上记录最终输出答案，保证调用链树根节点的输入/输出展示完整root_span.set_attribute("output.value",response_content)returnresponse_contentif__name__=="__main__":#动态生成本轮对话的唯一会话ID，保证在平台“会话分current_session_id=f"sess-{uuid.uuid4().hex[:12]}"print(f"==================================================")print(f"智能体运行时已启动！会话ID:{current_session_id}")print(f"==================================================")whileTrue:user_input=input("\nUser:")ifuser_input.strip().lower()in["exit","quit","q"]:print("正在退出并刷新数据上报...")breakprint("智能体正在思考并上报调用链...")reply=chat_with_agent(user_input,current_session_id)print(f"Agent:{reply}")#刷新Trace缓冲并一键上传tracer_provider.shutdown()print("数据刷新上报完成！")pythonagent_trace.py运行后，可与智能体进行会话，可通过Ctrl+C命令退出会话。退出后，登录AgentArts平台，在“运营运维>观测>智能体列表”页面，单击对应的智能体名称。在“调用智果（AgentArts）智能体平台智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司301.检查接入参数：确认agent_id、trace_endpoint、trace_token是否与数据上报准2.检查服务名称格式：确认OTEL_SERVICE_NAME遵循AgentArts.{智能体ID}.default格式。3.检查网络连通性：确认网络是否能连通Trace接入地址。4.等待数据同步：数据上报后通常需要几分钟才能在观测页面展示，请稍为什么在平台“调用链分析”中，单击模型节点的“指标”页签时报错，或者发现后端API路径中出现了双斜杠（如/agent//span/...）原因：出现该报错是由于您只在最外层的根节点（RootSpan）上设置了智能体URN关联属性，而漏掉了在模型节点（ModelSpan）上设置gen_ai.resource.id和gen_ai.resource.type属性。在AgentArts观测功能中，当您单击不同的节点查看调用链的Span详情时，页面会实时读取该节点上的属性来拼接查询API路径。如果模型节点缺少了这两个属性，路径就会），解决方案：在您的代码中，不仅要给最外层的RootSpan设参，每一个内部创建的子Span（如大模型调用）也必须强制上报withwithtracer.start_as_current_span("test_llm_call")asmodel_span:#必须给子节点也绑定智能体ID和资源类型，保证页面路由拼接正常model_span.set_attribute("gen_ai.resource.id",AGENT_ID)model_span.set_attribute("gen_ai.resource.type","agent")model_span.set_attribute("gen_ai.span.type","model")智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司31Metric数据用于统计聚合信息，如请求次数、Token消耗量、成功率等。下面以Python语言开发的智能体为例，介绍如何将Metric数据上报至AgentArts观测平第三方智能体上报的Metric指标数据将写入您的华为云应用运维管理AOM服务。AOM会根据指标上报的数量按需计费。在生产环境部署前，请仔细阅读AOM计费说明。安装OpenTelemetryPythonSDK及相关依赖库。要求Python3.9或以上版本。pippipinstallopentelemetry-distro==0.62b1pipinstallopentelemetry-api==1.41.1pipinstallopentelemetry-exporter-otlp==1.41.1pipinstalltraceloop-sdk==0.60.0步骤1在AgentArts平台左侧导航栏中选择“运营运维>观测”，并进入“智能体列表”页智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司32智能体ID等信息。请妥善保管该信息。project_project_id华为云项目ID，报Metric数据时使用。在AgentArts页面Metric上报鉴权Token。Metric数据接入地址。metric_endpointmetric_tokenagent_id智能体ID。promID上报Metric数据时使用。在AgentArts页面获取。智果（AgentArts）智能体平台智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司33在上报Metric数据前，需配置环境变量。服务名称（OTEL_SERVICE_NAME）必须遵循AgentArts.{{智能体ID}}.{{版本号}}的格式（版本号默认填写default）。OTEL_EXPORTER_OTLP_METRICS_HEADERS=Authorization=BearerOTEL_EXPORTER_OTLP_METRICS_HEADERS=Authorization=Bearer{metric_token},projectID={project_id},promID={prom_id},Content-Type=application/x-protobufOTEL_EXPORTER_OTLP_METRICS_ENDPOINT={metric_endpoint}OTEL_EXPORTER_OTLP_METRICS_INSECURE=true本示例用于首次接入平台时，验证上报网络、鉴权和配置是否正确。示例中gen_ai.domain.id、gen_ai.user.id的取值请按实际进行替换，请登录“我的凭证图1-36获取domainid、useridimportimportosimporttimefromopentelemetry.sdk.metrics.exportimportPeriodicExportingMetricReaderfromto.grpc.metric_exporterimportOTLPMetricExporterfromopentelemetry.sdk.metricsimportMeterProviderfromopentelemetryimportmetrics智果（AgentArts）智能体平台智能体运营运维文档版本01(2026-07-13)版权所有©华为云计算技术有限公司34AGENTAGENT_ID="您的智能体ID"METRIC_ENDPOINT="您的Metric接入地址"METRIC_TOKEN="您的Metric鉴权Token"PROJECT_ID="您的ProjectID"PROM_ID="您的PromID"#2.配置OTelMetric环境变量(注意Headers格式与Trace不同)os.environ["OTEL_SERVICE_NAME"]=f"AgentArts.{AGENT_ID}.default"os.environ["OTEL_EXPORTER_OTLP_METRICS_HEADERS"]=f"Authorization={METRIC_TOKEN},projectID={PROJECT_ID},promID={PROM_ID},Content-Type=application/x-protobuf"os.environ["OTEL_EXPORTER_OTLP_METRICS_ENDPOINT"]=METRIC_ENDPOINTos.environ["OTEL_EXPORTER_OTLP_METRICS_INSECURE"]="true"#3.初始化MetricProvider，设置上报周期为60000毫秒（60秒）metric_reader=PeriodicExportingMetricReader(OTLPMetricExporter(),export_interval_millis=60000)meter_provider=MeterProvider(metric_readers=[metric_reader])metrics.set_meter_provider(meter_provider)defreport_metrics():meter=metrics.get_meter(__name__)#定义一个计数器(Counter)，用于统计模型请求总数request_counter=meter.create_counter(name="gen_ai.total.requests",unit="1",description="NumberofrequeststoGenAI",)#定义指标的关联维度(Attributes)#【注意】gen_ai.resource.id必须与平台生成的智能体ID严格一致，注意替换gen_ai.domain.id、gen_ai.user.id的值attributes={"gen_ai.resource.id":AGENT_ID,"gen_ai.resource.type":"agent","gen_ai.model.id":"deepseek-v4-pro","gen_ai.session.id":"session-001","gen_ai.domain.id":"your_domain_id","gen_ject.id":PROJECT_ID,"gen_ai.user.id":"your_user_id","gen_ai.call.status":True,"gen_ai.space.id":"default"}request_counter.add(1,attributes=attributes)if__name__=="__main__":print(f"==================================================")print(f"智能体持续指标上报测试已启动！")print(f"我们将持续运行3分钟，每10秒模拟一次调用。")print(f"请保持此窗口运行，2分钟后刷新AgentArts观测控制台。")print(f"==================================================")#模拟持续运行3分钟(180秒)，每10秒调用一次total_duration=180interval=10elapsed=0whileelapsed<total_duration:print(f"[{time.strftime('%H:%M:%S')}]正在模拟第{int(elapsed/interval)+1}次智能体业务调用...")report_metrics()time.sleep(interval)elapsed+=interval智果（AgentArts）智能体平台智能体运营运维1智能体观测文档版本01(2026-07-13)版权所有©华为云计算技术有限公司35meter_provider.shutdown()print("==================================================")print("持续测试结束，指标数据已成功全部推送")print("==================================================")为了保证您上报的Metric指标能够被AgentArts看板正确识别。您在代码中创建Meter时，指标名及关联的维度属性（Attributes）必须与平台标准严格对齐。关于所有可设置的Attribute字段及含义，请参考OpenTelemetry字段映射。gen_ai.total.requestsCounter用于统计智能体/大模型的累计调用总次gen_ai.usage.input_tokensCounter用于累计输入Token的总消耗，支撑平台“Token分析”中的Input消耗趋势图。gen_ai.usage.output_tokensCounter用于累计输出Token的总生成量，支撑平台“Token分析”中的Output消耗趋势表1-13Attribute说明Attributegen_ai.resource.id是智能体ID（agent_id）。直接作为字符gen_ai.resource.ty是资源类型标识，默认写入"agent"。gen_ai.model.id是调用的模型名称（如"deepseek-v4-pro"）。gen_ject.id是华为云的项目ID（project_id直接填gen_ai.call.status是False）。平台以此自动计算响应成功率上述示例代码中，定义了gen_ai.total.requests用于统计模型的请求总数。运行脚本后将触发模拟调用，调用完成后。在“运营运维>观测>智能体列表”页面，单击对应文档版本01(2026-07-13)版权所有©华为云计算技术有限公司36本示例中的脚本创建了一个常驻的智能体服务。在对话的过程中，每后，代码会自动把真实的Token数量累加到计数器中，并且保持后台进程运行，每隔60秒自动把指标打包上报到AgentArts服务中。请在你的电脑终端（Windows的CMD或macOS/Linux的Terminal）中执行以下命令，安装所需的Python依赖库：pippipinstallopentelemetry-api==1.41.1pipinstallopentelemetry-sdk==1.41.1pipinstallopentelemetry-exporter-otlp==1.41.1pipinstallopenai==1.14.0pipinstallpython-dotenv==1.0.0安装完成后，在您的代码文件夹下创建一个名为.env的文本文件。填写华为云MaaS服务的模型APIKey和AgentArts平台上获取的真实凭证：##==========================================#1.智能体大模型的API凭证（以接入MaaS的OpenAI兼容接口为