# 智果（AgentArts）智能体平台

> 一站式企业级智能体平台

## 产品介绍

- [什么是智果（AgentArts）智能体平台？](https://support.huaweicloud.com/productdesc-agentarts/agentarts_03_0002.md): 随着企业大模型应用从“原型试验”走向“核心生产场景”，如何保障智能体在复杂业务环境下的安全运行、高效运维与精准资产调用，成为企业规模化部署的挑战。AgentArts正是为此而生的企业级智能体平台。智果（AgentArts）智能体平台是面向企业级核心业务场景打造的智能体平台，基于Harness最佳实践构建标准化的开发与治理框架，专注于解决智
- [订阅套餐](https://support.huaweicloud.com/productdesc-agentarts/agentarts_03_0003.md): AgentArts目前推出体验版、团队标准版、团队高级版、企业专业版、企业旗舰版五个版本，超出套餐包部分，可使用CU按需和CU包年套餐包计费，满足多样化业务需求，其中体验版为免费版本。当前AgentArts团队标准版、团队高级版、企业专业版、企业旗舰版未开放，如果需要购买，请提交工单咨询购买相关事宜。体验版与付费套餐（团队标准版、团队高级
- [资产广场](https://support.huaweicloud.com/productdesc-agentarts/agentarts_03_0028.md): 资产广场是AgentArts的资源库，提供开箱即用的应用模板和标准化的组件资产，赋能开发者以“搭积木”的方式高效构建智能体。在资产广场中，您可以根据构建需求，灵活选择并复用核心资产：应用模板、模型、MCP、插件、提示词、Skill。“应用模板”页面汇集了官方预置的高频场景应用模板，预置的模板覆盖多个行业领域，如图2所示。预置的应用模板可以
- [基本概念](https://support.huaweicloud.com/productdesc-agentarts/agentarts_03_0010.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 开始使用

- [开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.md): AgentArts目前处于公测阶段，用户需要先申请公测，才能免费体验或购买使用。当前仅体验版可开通，付费套餐请提交工单咨询购买相关事宜。公测申请通过后，如果未开通AgentArts服务，您还需要参考以下操作开通AgentArts服务，否则仅可查看平台相关内容。请确保登录用户为实名认证的华为账号或IAM用户。华为账号：华为账号是您访问华为各
- [搭建第一个智能体](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0002.md): 本章节将引导您手动搭建一个“百科资讯助手”。通过全流程的实操讲解，带您探索如何在AgentArts上从零开发单智能体并了解其开发逻辑，直观感受AgentArts的敏捷构建能力。在信息获取日益碎片化的今天，用户常有快速查询实时资讯与专业百科知识的复合需求。该“百科资讯助手”通过集成Daily News（全球动态）与《本草纲目》百科等多项技能
- [搭建知识库问答工作流](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0003.md): 在实际业务中，经常需要创建一个带有知识库的AI助手来回答特定领域的问题（如企业规章、行业报告），通过引入知识库功能，可以解决大模型在面对垂直领域或私有数据时出现的知识缺失与事实性错误问题。本章节的案例中，构建一个“旅游景点介绍知识库”，随后编排知识库问答工作流，并通过大模型进行内容总结。搭建知识库问答工作流流程如下，仅需四步即可完成知识库
- [使用模板搭建智能体](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0001.md): AgentArts资产广场为您提供了丰富的应用模板，涵盖了单智能体、工作流等多种形态的成熟资产，旨在帮助用户快速复用热门应用方案。本章节将引导您使用AgentArts资产广场中的“城市文旅推荐”单智能体应用模板，带您在零代码环境下体验从一键复制到关键配置的全流程。针对旅行规划中信息零散、方案编制繁琐的挑战，该智能体能基于用户偏好，快速生成

## 计费说明

- [免费套餐](https://support.huaweicloud.com/price-agentarts/agentarts_08_0001.md): 在AgentArts智能体平台的“资源与订阅”页面，查看套餐包费用。AgentArts提供体验版供开发者体验，该版本为免费版本，体验版的明细如表1所示。体验版包含AgentArts自身的功能额度，超出部分会按需收费；部分底层资源（如模型、日志等）由关联服务提供，可能产生费用，具体说明请参考关联服务计费说明。AgentArts平台大模型赠送
- [计费概述](https://support.huaweicloud.com/price-agentarts/agentarts_08_0002.md): 通过阅读本文，您可以快速了解AgentArts服务的计费模式、计费项等主要计费信息。计费模式AgentArts服务提供免费、包年/包月、按需计费模式，以满足不同场景下的用户需求。关于计费模式的详细介绍请参见计费模式概述。免费是用户无需付费即可使用的资源。包年/包月是一种预付费模式，即先付费再使用，按照订单的购买周期进行结算，因此在购买之前
- [计费项](https://support.huaweicloud.com/price-agentarts/agentarts_08_0003.md): 在AgentArts智能体平台的“资源与订阅”页面，查看套餐包费用。AgentArts服务根据开通的套餐包计费或按需计费。具体内容如表2所示。套餐包包含AgentArts自身的功能额度，超出部分会按需收费；部分底层资源（如模型、日志等）由关联服务提供，可能产生费用，具体说明请参考关联服务计费说明。当前AgentArts团队标准版、团队高级
- [计费模式概述](https://support.huaweicloud.com/price-agentarts/agentarts_08_0005.md): 在AgentArts智能体平台的“资源与订阅”页面，查看套餐包费用。AgentArts服务提供免费、包年/包月、按需计费模式，以满足不同场景下的用户需求。免费：用户无需付费即可使用的资源。适用于了解、试用AgentArts服务。包年/包月：是一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。适合长期
- [包年/包月](https://support.huaweicloud.com/price-agentarts/agentarts_08_0006.md): 在AgentArts智能体平台的“资源与订阅”页面，查看套餐包费用。包年/包月是一种先付费再使用的计费模式，适用于对资源需求稳定且希望降低成本的用户。通过选择包年/包月的计费模式，您可以预先购买AgentArts服务资源并获得一定程度的价格优惠。本文将介绍包年/包月AgentArts套餐包的计费规则。包年/包月计费模式需要用户预先支付一定
- [按需计费](https://support.huaweicloud.com/price-agentarts/agentarts_08_0014.md): 在AgentArts智能体平台的“资源与订阅”页面，查看套餐包费用。按需计费是一种先使用再付费的计费模式，适用于无需任何预付款或长期承诺的用户。本文将介绍按需计费AgentArts资源的计费规则。AgentArts按需计费不是独立开通形态，仅用于超出套餐包额度的CU结算。按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务，例如电
- [计费样例](https://support.huaweicloud.com/price-agentarts/agentarts_08_0015.md): 小王是一名独立开发者，首次开通AgentArts体验版，系统一次性赠送20CU供其调试智能体。他持续调用运行时接口，耗尽赠送额度后继续使用，产生了超额按需费用。阶段一：消耗赠送额度（前20CU）小王在2025/11/01 09:00:00 ~ 11:00:00（共2小时）调用运行时接口，资源消耗如下：经过多次调试，至2025/11/10累
- [变更计费模式](https://support.huaweicloud.com/price-agentarts/agentarts_08_0007.md): 在AgentArts智能体平台的“资源与订阅”页面，查看套餐包费用。开通任意套餐包后，系统会自动开通CU按需计费。此外，AgentArts还支持购买CU包年套餐包，以节省开支。CU按需计费变更为CU包年套餐包会生成新的订单，用户支付订单后，CU包年套餐包将立即生效。假设用户于2026/08/01 15:30:00购买了团队标准版，用了一段
- [续费概述](https://support.huaweicloud.com/price-agentarts/agentarts_08_0009.md): 包年/包月套餐包到期后会影响AgentArts正常运行。如果您想继续使用，需要在指定的时间内为AgentArts服务续费。续费操作适用于包年/包月套餐包，只需要保证账户余额充足即可。套餐包在到期前续费成功，所有资源得以保留，且AgentArts的运行不受影响。套餐包到期后的状态说明，请参见到期后影响。包年/包月云套餐包续费相关的功能如表1
- [手动续费](https://support.huaweicloud.com/price-agentarts/agentarts_08_0010.md): 包年/包月套餐包从购买到被自动删除之前，您可以随时在费用中心进行续费，以延长套餐包的使用时间。可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源，对资源进行手动续费。所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动续费。单个续费：在资源页面找到需要续费的资源，在“操作
- [自动续费](https://support.huaweicloud.com/price-agentarts/agentarts_08_0011.md): 自动续费可以减少手动续费的管理成本，避免因忘记手动续费而导致AgentArts资源被自动删除。自动续费的规则如下：以AgentArts套餐包的到期日计算第一次自动续费日期和计费周期。AgentArts自动续费周期以您选择的续费时长为准。例如，您选择了3个月，AgentArts即在每次到期前自动续费3个月。在AgentArts到期前均可开通
- [费用账单](https://support.huaweicloud.com/price-agentarts/agentarts_08_0012.md): 您可以在“费用中心 > 账单管理”查看资源的费用账单，以了解该资源在某个时间段的使用量和计费信息。包年/包月计费模式的资源完成支付后，会实时上报一条账单到计费系统进行结算。按需计费模式的资源按月结算，结算完毕后上报账单。用户如果需要查看AgentArts服务的费用明细，可以参考账单管理的“流水与明细账单”进行查看。
- [欠费说明](https://support.huaweicloud.com/price-agentarts/agentarts_08_0016.md): 用户在使用云服务时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响云服务资源的正常运行，请及时充值。已购套餐包，但使用量超出套餐包额度，进而产生按需费用，同时账户中的余额不足以抵扣产生的按需费用。请参考已购买资源包，为什么仍然产生按需计费识别产生按需计费的原因，并重新选择正确的资源包或保证账户中的余额充足。已购套餐
- [停止计费](https://support.huaweicloud.com/price-agentarts/agentarts_08_0013.md): 用户在购买时会一次性付费，服务将在到期后自动停止使用。如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭

## 低代码开发

- [应用选型指南](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0279.md): 为满足从简单对话到复杂业务自动化的多样化需求，AgentArts提供了三种核心应用开发模式：单智能体、工作流和多智能体。在开始搭建AI应用之前，您需要回答一个核心问题："我的任务，应该交给一个人做，一条流水线做，还是一个团队做？"平台提供了三种核心开发模式，它们的关系如表1所示。单智能体单智能体是最基础的AI应用形态，一个单智能体能独立完
- [低代码应用开发流程](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0001.md): 智果（AgentArts）智能体平台是面向企业级核心业务场景打造的智能体平台，基于Harness最佳实践构建标准化的开发与治理框架，专注于解决智能体在企业复杂环境下落地难、运行不可靠、运维无抓手等痛点，致力于降低应用门槛，助力企业将AI能力与实际业务深度融合，实现规模化落地。
- [单智能体应用介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0012.md): 单智能体（Single Agent）是一个独立运作的AI实体，能自主感知环境、规划决策并执行任务，全程无需其他智能体协作。其核心特点是集中化处理，适用于目标明确、复杂度较低的场景（如客服机器人、游戏NPC）。单智能体应用适合处理简单独立任务，如果有固定的任务执行流程，高准确率要求，可以选择工作流应用，具体请参见开发工作流应用；如果需要处理
- [示例：搭建一个医疗问诊助手智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0013.md): 随着人工智能技术的不断进步，大模型在医疗领域的应用逐渐成熟。通过结合医学知识库、自然语言处理和智能交互技术，医疗问诊助手智能体能够为患者提供初步的健康咨询、症状分析和诊断建议，同时减轻医生的工作负担，提升医疗服务效率。本教程将指导你如何在AgentArts智能体平台上搭建一个医疗问诊助手，用于获取健康建议。与医疗问诊助手进行对话时，可以模
- [创建单智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0016.md): 通过创建单智能体，您可以快速构建一个高效、灵活的自动化解决方案，满足用户的特定需求。无论是处理复杂任务还是简化日常操作，智能体都能帮助用户实现目标。AgentArts支持创建单智能体应用的方式如表1所示。不同套餐包允许创建的应用数量限制不同，具体可参考计费说明。已开通AgentArts服务。模型已接入AgentArts平台，接入指导请参考
- [选择并配置模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0017.md): 在AgentArts中，创建智能体后配置模型是构建和优化智能应用的关键操作，用户可以通过可视化配置页面选择和集成多种大语言模型，如DeepSeek、千问等。通过灵活选择和配置不同大语言模型，确保智能体能够根据业务需求高效、稳定地提供强大的AI能力。AgentArts已接入模型。接入模型服务详见模型。您可以在智能体的编排页面为智能体选择一个
- [配置提示词](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0018.md): 在搭建Agent应用的过程中，设置提示词是至关重要的一步。提示词是一种自然语言指令，用于指导大语言模型（LLM）如何完成特定任务。例如，在写作小说的场景中，提示词可以是请生成一个悬疑小说的开篇，营造紧张的氛围，描述主角在雨夜进入一座废弃的别墅。提示词的作用在于为模型提供明确的任务目标，规范输出格式，优化生成内容，并支持个性化需求。通过精心
- [添加MCP服务](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0021.md): Agent工具调用支持MCP协议，并提供了一个丰富的MCP服务生态系统，以增强智能体的功能。MCP是一种开放协议，它规范了应用程序向大语言模型提供上下文的方式，平台集成了“高德地图”、“必应搜索”等多种实用MCP服务，开通后可以一键集成调用。此外，平台还支持创建自定义MCP服务，开发者可依据MCP服务地址快速创建MCP服务。在AgentA
- [添加插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0022.md): AgentArts提供了一个丰富的插件生态系统，以增强智能体的能力。插件是一种工具集，一个插件即是一个API工具。目前，AgentArts集成了类型丰富的插件，包括OCR识别、文件处理、代码解释器、全网热搜榜、高德地图等工具，这些插件能够帮助开发者快速为智能体添加特定功能。此外，平台还支持创建自定义插件，允许开发者将已有的API能力通过参
- [添加工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0023.md): 工作流是AgentArts中用于设计和实现复杂任务自动化的核心工具。通过任务编排、条件判断以及多种组件的协同功能，工作流帮助开发者高效处理复杂任务。工作流中包含大模型节点、知识检索节点、意图识别节点、判断节点、代码节点等多种节点，每个节点都具有特定的功能，能够处理数据、执行任务和运行算法。通过可视化设计，开发者可以清晰地看到数据的流转过程
- [为应用添加知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0025.md): 知识库是Agent中用于存储、管理和检索领域知识的核心组件，它通过结构化存储、智能检索以及动态更新机制，为Agent提供高匹配的信息支持。为智能体添加知识库，能够提供准确的知识支持，增强大模型回答的可靠性和专业性。知识库有助于智能体减少错误信息的生成，提高对复杂查询的处理能力。知识库支持doc、pdf、pptx、xlsx、csv等多种格式
- [为应用添加记忆](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0026.md): 在多轮对话场景中，用户往往期望智能体能够记住自己的偏好、身份和交互习惯，从而获得连贯且个性化的服务体验。在单智能体配置中，支持通过配置变量为应用开启“记忆”功能。AgentArts提供以下记忆类型，满足不同场景下的记忆需求：入参变量： 如果需要通过API传入外部业务参数（如“订单ID”），请选择入参变量。通过API调用向智能体动态注入外部
- [提升应用对话体验](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0027.md): 开场白是用户进入智能体应用后首先看到的引导信息，能够帮助用户迅速了解智能体应用的功能和用途，明确如何与智能体应用进行有效交互。开场白需要简洁明了，语气友好并且表述清晰。在“对话体验 > 开场白”中，可填写开场白，也可单击“智能添加 > 确定”按钮智能添加开场白。推荐问题是用户首次与应用互动时，应用主动展示的一些问题或话题建议，提供预设选项
- [调试应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0028.md): 开发者可以在智能体应用搭建完成后，直接与智能体应用进行对话，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。平台全链路调试功能，允许开发者查看每个用户请求从输入到响应的完整流程，包括意图识别、知识检索等详细信息，从而准确定位问题并快速调整配置。调试过程会消耗模型推理资源及关联服务资源（如语音识别、文件解析等），请关注您的资源
- [配置触发器](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0029.md): 触发器是Agent中实现任务自动化的关键功能，它能够在特定条件下自动启动任务执行，无需人工干预。可以利用触发器灵活设置任务的启动条件，触发器能确保任务按时按需完成，从而提高Agent应用的自动化水平和响应速度。通过定时任务调用应用按照触发指令要求执行任务。
- [发布并部署应用为API服务](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0031.md): 将Agent应用发布为API服务后，可以通过调用OpenAPI的方式使用Agent程序。本文介绍如何将开发完成的Agent应用发布并部署为API服务。提交版本是将当前单智能体应用配置保存为一个不可变的版本快照；部署是将指定版本发布为可调用的API接口，创建一个独立的运行实例。智能体发布后通过API接口调用时，会产生tokens消耗。如果需
- [发布应用为网页应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0032.md): AgentArts支持将Agent应用发布为网页应用，这一功能适用于多种场景。例如，在客户服务领域，可以将智能客服Agent部署为网页应用，提供全天候的在线咨询服务，提升客户满意度。在教育和培训中，可以将教学助手Agent部署为网页应用，为学生提供个性化的学习指导和互动体验。在智能问答系统中，可以将知识库查询Agent部署为网页应用，为用
- [发布应用至云商店](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0034.md): 华为云云商店是面向企业和开发者的数字化商品交易平台，支持将 API 能力以标准化商品形式对外售卖。通过将 AgentArts 智能体发布至云商店，您可以：实现能力变现：将构建好的智能体封装为可购买的 API 商品，按调用次数向买家收费。扩大服务覆盖：借助云商店的流量和分发能力，让更多企业用户发现并使用您的智能体服务。标准化交付：通过 AP
- [通过API调用单智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0038.md): AgentArts提供OpenAPI请求方式，可通过调用路径发送请求，程序将调用应用并返回预期结果。AgentArts的API调用是应用开发中的强大工具，可以帮助用户快速集成功能和服务，同时支持与其他系统或服务进行交互，提升应用性能和用户体验。合理设计和管理API是确保应用安全和稳定的关键。通过API，用户可以构建功能丰富、高效的应用，满
- [管理应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0039.md): 在AgentArts中创建应用之后，可以管理单智能体应用界面中的应用，可执行删除、复制创建的应用、复制应用ID、导入、导出及查看调用路径等。只有应用的所有者可以删除应用。删除应用时虽然不会同步删除应用资源库中的所有资源，但不可恢复，请谨慎操作。对于Agent应用除了具有页面操作的能力之外，还具有Chat API调用能力，因此获取AppID
- [工作流介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0041.md): 工作流是一系列相互关联的步骤，用于实现业务逻辑或完成特定任务。它为应用/智能体的数据流动和任务处理提供了一个结构化框架。工作流的核心是一个由人工设计和编排的智能系统，由多个AI Agent通过利用自然语言处理（NLP）和大型语言模型（LLM）协作完成任务。这些智能体在预设的逻辑框架下工作，能够根据既定规则自主感知、推理和行动，以追求特定目
- [对话型工作流和任务型工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0042.md): 平台提供了两种类型的工作流，即对话型工作流和任务型工作流，用户可以针对不同的任务或场景选择适合的工作流进行搭建。对话型工作流：面向多轮交互的开放式问答场景，基于用户对话内容提取关键信息，输出最终结果。适用于客服助手、工单助手、娱乐互动等场景。任务型工作流：面向自动化处理场景，基于输入内容直接输出结果，无中间的对话交互过程。适用于内容生成、
- [工作流使用限制](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0043.md): 工作流是一系列相互关联的步骤，用于实现业务逻辑或完成特定任务。在使用过程中注意以下限制。
- [工作流搭建范式简介](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0325.md): 工作流的搭建范式，是指在AgentArts工作流编排中，节点之间的连接与协作方式所形成的固定模式。不同的范式决定了数据如何在节点间流转、任务如何被拆解执行、以及最终结果如何汇聚输出。理解搭建范式，有助于在面对复杂业务场景时，能够快速选择合适的编排结构，而不是凭直觉随意连线。AgentArts工作流编辑器提供了开始节点、结束节点、大模型节点
- [顺序链式执行](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0326.md): 顺序链式执行是最基础的工作流结构。节点之间形成一条有向的执行链，前一节点的输出作为后一节点的输入，逐步完成一个完整任务。这种范式适用于任务可以被自然地拆解为若干顺序步骤的场景：每一步的结果是下一步的前提，整体流程方向固定，不存在分叉或循环。相比将所有事情塞进一个大模型节点的单步提示，顺序链式执行的优势在于：每步职责单一，中间结果可审计。不
- [条件路由执行](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0327.md): 条件路由执行是指工作流在运行过程中，根据某个条件的判断结果，将执行流程导向不同的处理分支。这种范式解决了“不同输入需要不同处理逻辑”的问题：同一个工作流入口，根据运行时的实际情况，流向完全不同的执行路径，每条路径针对其场景做最合适的处理。AgentArts提供了两种路由节点，分别适用于不同的判断场景：路由节点的核心逻辑：判断节点：依次检查
- [并行聚合执行](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0328.md): 并行聚合执行是指工作流通过判断节点拆分为多个并行分支，每个分支独立处理，最终由变量聚合节点将所有分支的输出合并为统一变量，供下游节点统一引用。这种范式的核心价值在于：解决多分支执行后下游需要统一接口的问题。在工作流中，判断节点将请求导入不同分支后，同一时刻只有一条分支会执行并产生有效输出，其他分支的输出为空。变量聚合节点按照预设的优先级顺
- [循环迭代执行](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0329.md): 循环迭代执行是指工作流中的某一组节点被重复执行多次，每次迭代处理数组中的一个元素或完成一轮任务，直到遍历完所有数据或达到指定次数为止。这种范式解决了批量处理问题：当需要对一组数据逐条执行相同操作，或需要某个任务重复运行 N 轮时，循环迭代能够替代人工逐一触发，实现自动化批量处理。AgentArts 的循环节点支持两种模式：数组循环：遍历一
- [嵌套编排执行](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0330.md): 嵌套编排执行是指将一个已发布的工作流作为子程序，嵌入到另一个主工作流中调用。主工作流充当总调度角色，将特定任务委派给子工作流处理，子工作流完成后将结果返回主流程继续执行。这种范式解决了大型工作流的模块化管理问题。当业务流程涉及多个相对独立的功能模块，且这些模块未来可能被多个流程复用时，嵌套编排能够：让主工作流保持简洁，只关注总体流程调度。
- [反思精炼循环](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0331.md): 反思精炼循环是一种闭环自我优化的搭建范式：工作流不满足于大模型的第一次输出，而是引入一个独立的评估环节对结果进行审查，若结果未达标则触发修订，如此循环，直到输出质量满足要求或达到最大迭代次数为止。这种范式解决了单次大模型调用不够可靠的问题，特别适用于：输出需要满足明确可检验标准的场景（格式、字数、关键信息完整性）。对输出质量有较高要求、需
- [创建工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0047.md): 工作流是一系列相互关联的步骤，用于实现业务逻辑或完成特定任务。可以在智能体和应用搭建中通过工作流实现特定的任务或指令。无论是在智能体还是应用中使用工作流，都需要先创建一个可运行的工作流。AgentArts支持创建工作流应用的方式如表1所示。选型建议：如果您是初次使用或希望快速体验，推荐“使用预置应用创建”。如果您有明确的复杂业务逻辑且需要
- [试运行工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0051.md): 开发者可以在工作流创建完成后，直接与工作流进行交互，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。平台提供的全链路调试功能，允许开发者查看每条用户请求从输入到响应的完整流程，包括意图识别、知识检索等详细信息，从而能够高效定位问题并快速调整配置。AgentArts支持对整个工作流进行调试，也支持对工作流的单个节点进行调试。试
- [配置触发器](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0052.md): 触发器是工作流中实现任务自动化的关键功能，它能够在特定条件下自动启动任务执行，无需人工干预。可以利用触发器灵活设置任务的启动条件，触发器能确保任务按时按需完成，从而提高工作流应用的自动化水平和响应速度。仅任务型工作流支持配置触发器，对话型工作流不支持。通过定时任务调用工作流，使其按照触发指令执行任务。删除触发器后，该自动化任务将立即停止，
- [发布并部署工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.md): 工作流试运行成功后，可对其进行发布及部署，便于后续使用，如在单智能体应用中使用工作流，请参考添加工作流。工作流发布后通过API接口调用时，会产生tokens消耗。如果需要使用平台预置的MaaS模型即服务的模型，需要先开通模型并设置鉴权。具体操作请参考接入预置的付费模型，计费规则请参考MaaS模型即服务价格。如果使用自定义接入的第三方模型，
- [通过API调用工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0055.md): 工作流发布成功后，可以使用API调用该工作流。当您需要将开发好的工作流集成到外部业务系统（如企业网站、公众号后台）或通过脚本进行批量自动化处理时，可以通过调用API的方式使用工作流。通过API调用工作流将消耗资源（如Token用量），可能产生相关费用。请在调用前确认账户额度充足，具体计费规则请参考计费项。须确保工作流已发布，详情可参考发布
- [在单智能体应用中使用工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0056.md): 工作流功能是实现单智能体应用业务逻辑的核心部分。它定义了应用的输入和输出数据结构、数据接收与处理规则，以及决策流程。通过工作流，单智能体应用能够支持添加工作流技能，允许用户通过画布编排的方式，组合使用插件、大模型等不同节点，从而实现复杂且稳定的业务流程编排。简单业务：应用中至少有一个试运行通过的工作流，作为应用的业务处理流程。复杂任务：如
- [在多智能体应用中使用工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0057.md): 可通过工作流功能来实现多智能体应用的业务逻辑部分。工作流决定了应用的输入和输出的数据结构、接收和处理数据的规则以及决策流程，是智能体应用的核心部分。多智能体应用通过添加工作流技能，对用户的会话进行意图分析，路由到不同的子工作流执行编排好的任务。须确保工作流已发布，详情可参考发布并部署工作流。起始工作流：在会话开始时首先执行，常用于初始化参
- [管理工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0058.md): AgentArts平台致力于提供高效、灵活的工作流管理解决方案。除了支持AgentArts工作流的导入导出，为了提升用户体验，AgentArts现支持Dify工作流的导入功能。用户可以轻松将现有的Dify工作流文件导入平台，在导入工作流时，将同步导入与工作流关联的插件等配置，实现无缝对接和高效管理。无论是复杂业务流程还是简单任务自动化，A
- [开始节点](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0060.md): 开始节点用于触发一个工作流，结束节点用于返回一个工作流的最终结果。开始节点是工作流的“感知边界”与“数据入口”。它定义了工作流启动时需要接收哪些外部信息（是接收一段文字、一个文件，还是一个特定的参数）。节点定位：它决定了工作流如何理解用户的意图。如果开始节点定义不清晰，后续的大模型节点或其他节点将无法正常传参。默认参数：系统预置了quer
- [结束节点](https://support.huaweicloud.com/lowcode-agentarts/end_node.md): 结束节点是工作流的“交互出口”。它决定了工作流执行完一系列复杂逻辑后，最终以何种形式将结果反馈给用户或下游系统。对话型反馈：直接回复一段自然的文字。例如：为您找到的结果是{{result}}。任务型反馈：返回结构化的数据（JSON），让工作流的返回结果从“自然语言对话”升级为“程序可调用的标准化数据格式”，满足系统对接、跨流程调用、数据复
- [大模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0062.md): 大模型节点是工作流的“大脑”。它不仅能进行对话生成，还能基于上下文进行逻辑推理、任务拆解和非结构化数据提取。通过配置提示词和模型参数，可以控制其输出风格与格式，为下游节点提供决策依据或结构化数据。核心能力：内容生成：撰写文案、代码、翻译、创意写作。逻辑决策：分析用户意图，判断下一步调用哪个插件。信息提取：从自然语言中提取JSON格式的关键
- [工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0063.md): 在复杂的业务编排中，工作流节点允许您将另一个已发布的工作流作为“子程序”嵌入当前流程。通过嵌套，您可以将常用的、标准化的任务处理流程（如“用户鉴权”、“发票OCR识别”）封装为不同的子工作流，并在主工作流中调用这些子工作流。通过工作流嵌套，可以实现复杂任务的模块化拆分和处理，从而使工作流编排逻辑更加灵活、清晰和易于管理。运行工作流节点将触
- [判断](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0066.md): 判断节点是工作流中的逻辑路由器。它基于前置节点的输出变量，通过预设的条件表达式（IF/ELSE），将工作流导向不同的执行分支。需要根据结构化数据做精确判断（如：订单金额 > 1000、状态 == 成功），使用判断节点。要理解用户自然语言的意图（如：我想退款）→ 使用意图识别节点。当向该节点输入参数时，节点会依次检查各分支的条件，并执行第一
- [代码](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0067.md): 代码节点是工作流中用于执行自定义代码逻辑的节点。当工作流中需要进行数据处理、格式转换、数学计算、逻辑判断等操作，而这些操作用其他节点难以实现或用大模型处理不够准确时，可以通过代码节点编写代码来完成。代码执行的结果是确定的，相同的输入必然得到相同的输出。对于计算、格式转换等任务，代码比大模型更准确、更快、且不消耗Token。代码节点在平台托
- [循环](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0068.md): 循环节点用于在工作流中重复执行一系列任务，直到满足特定条件为止。当你需要批量处理数据、逐一遍历列表元素或按固定次数重复执行某个操作时，可以使用循环节点来实现。循环是一种常见的工作流控制机制，它让一组操作能够被重复执行，而不需要手动复制粘贴相同的节点。在实际业务场景中，循环节点可以帮助您：逐条处理列表数据：对一组数据中的每一条逐一执行相同的
- [意图识别](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0069.md): 意图识别节点用于识别用户自然语言表达的意图或目的，适用于需要对用户问题进行分类，或者综合类功能需要不同分支处理的场景。通过对用户输入进行推理分析，匹配预定义的意图类别，并根据匹配结果引导至相应的处理流程，该节点通常位于工作流的前置位置。意图识别节点支持普通模式或高级模式运行。普通模式：适用于对少量意图进行分类的场景，当意图数量小于或等于2
- [高级意图识别](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0070.md): 高级意图识别节点是普通意图识别节点的增强版本，专为需要管理20个以上意图的复杂场景设计。它通过意图包集中管理大量意图分类，并使用子工作流为每个意图分支提供独立的处理逻辑，实现主工作流的模块化编排。当意图数量在20个左右时，如未来有扩展需求，建议直接选用高级意图识别节点，避免后续迁移成本。高级意图识别节点的执行流程如下：接收输入：接收用户输
- [插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0072.md): 插件节点是工作流中实现第三方能力调用的核心组件之一，允许工作流通过调用插件来执行特定功能任务。尽管大语言模型（LLM）具备强大的自然语言处理与推理能力，但存在两大局限：信息滞后（无法获取训练截止日期之后的实时信息）和行动力缺失（无法直接与外部系统交互）。插件节点正是突破这些局限的关键桥梁，每个插件本质上是经过标准化封装的API或者函数功能
- [MCP服务](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0073.md): MCP服务节点是工作流中实现第三方能力调用的核心组件之一，允许工作流通过调用MCP服务来执行特定功能任务。MCP服务与插件的关系：两者都是为工作流引入外部能力的方式。插件采用平台定义的封装规范，开发者可将外部API或自定义函数封装为插件使用；MCP服务则基于业界标准协议，能够接入更广泛的第三方工具生态。在功能上两者互补，开发者可根据实际需
- [HTTP请求](https://support.huaweicloud.com/lowcode-agentarts/http_node.md): HTTP请求节点用于在工作流中调用外部服务的API接口，支持POST、GET请求。通过该节点，可以向指定的服务器地址发送请求，获取数据或提交信息，从而将工作流与外部系统打通，实现查询第三方平台的信息、向业务系统写入处理结果、调用外部模型服务等功能。HTTP请求节点执行时，平台服务器根据配置的URL和请求方式，将输入参数拼装为HTTP请求并
- [消息](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0077.md): 消息节点是工作流中的即时反馈机制。与“结束节点”不同，消息节点允许工作流在执行过程中，向用户界面主动推送中间结果，而无需等待整个流程结束。核心价值降低等待焦虑：在执行耗时任务（如联网搜索、生成长文）前，先发送“正在搜索中...”的提示。分步输出：将复杂的推理过程拆分为多个消息气泡，提升阅读体验。调试与监控：在开发阶段输出变量的中间状态，用
- [输入](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0078.md): 输入节点用于在工作流执行过程中暂停流程，向用户收集额外信息。当下游节点需要某些参数，而这些参数在之前的流程中尚未获取时，您可以插入一个输入节点来主动追问用户。输入节点使用场景：支持配置一个或多个输入参数，且输入参数可被后置节点引用。当单击图标时，可新增输入参数。参数名称：变量标识符，下游节点通过此名称引用，只允许输入字母、数字、下划线，且
- [提问器](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0079.md): 提问器节点在工作流执行过程中主动向用户发起提问，从自然语言对话中提取完成任务所需的结构化参数。它会循环追问，直到收集到所有必需信息或达到最大交互轮数。提问器的执行流程如下：分析用户对话内容，提取已提供的参数；判断是否所有必需参数均已提取；如果有缺失，生成追问继续收集；重复1~3，直到所有参数提取完成或达到最大回复轮数。提问器节点仅适用于对
- [问答](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0080.md): 问答节点用于在工作流执行过程中向用户提出预设问题。根据配置模式的不同，它既可以暂停工作流等待用户回答（需要回答模式），也可以仅发送问题后继续执行（无需回答模式）。问答节点使用场景：配置问答节点的详细参数说明如下：问答策略：需要回答：工作流执行到问答节点时暂停，向用户展示问题，等待用户回答后将回答内容作为输出参数传递给下游节点。无需回答：工
- [异常](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0082.md): 异常节点功能，当工作流运行遇到业务异常时，通过本节点中断当前分支逻辑并抛出异常信息，最终由结束节点完成流程的终止，便于定位问题和后续处理。核心价值与适用场景：使用异常节点，是为了在遇到不可恢复的错误时，快速失败并明确告知原因，避免产生脏数据。配置异常节点的详细参数说明如下：异常节点会中断当前分支逻辑并抛出异常信息，但仍需连接结束节点来完成
- [变量赋值](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0084.md): 变量赋值节点是工作流中用于修改和存储变量值的节点。通过变量赋值节点，将特定的值赋给变量，可以实现数据的动态更新和传递，使工作流能够根据实时数据做出相应的处理和决策。变量赋值节点支持在循环节点内部和外部使用，两种场景下可操作的目标变量不同。变量赋值节点应用广泛，例如：存储中间结果：在工作流中，将中间计算或处理的结果通过变量赋值节点存储到变量
- [变量聚合](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0085.md): 变量聚合节点将多个分支的输出变量汇聚为一个统一变量，供下游节点引用。它的核心能力是：从多个分支的输出中，按照用户指定的优先级顺序，返回第一个非空值。在工作流中使用条件分支时，同一时刻只有一个分支会执行并产生输出，其他分支的输出为空。下游节点如果直接引用分支输出，需要处理空值判断。变量聚合节点将这些分支的输出汇聚为统一变量，自动返回第一个非
- [知识检索](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0086.md): 知识检索节点是工作流的“外部知识存储器”。它通过RAG（检索增强生成）技术，从预先上传的知识库中根据用户意图匹配相关片段。核心作用：解决大模型无法掌握的私有领域数据，实时信息以及易产生幻觉的问题。RAG工作流数据运行机制如下：用户原始问题 → 知识检索节点 → 进行知识检索 → 匹配到的切片 → 大模型总结 → 生成回答在工作流编辑页面，
- [意图管理](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0095.md): 意图包是意图分类的集中管理单元，用于将一组相关意图类别及其样例统一封装。在工作流的高级意图识别节点中直接引用预定义的意图包，即可高效实现大规模意图分类与智能路由。意图包基于大模型语义理解能力，通过匹配意图名称、描述、样例、关联词等多维度特征，将用户输入映射到最匹配的意图分类。核心优势：一次定义，多处复用：同一意图包（如“通用闲聊包”“银行
- [消息模板](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0099.md): 消息模板是预定义的标准化JSON消息结构，通过定义模板，可以规范工作流在特定场景（如系统异常、业务阻断）下的输出格式，实现统一错误处理与交互标准。消息模板主要与工作流中的异常节点配合使用，异常节点被触发时，根据节点配置引用对应的消息模板，将模板中定义的JSON结构作为节点输出返回给用户或下游节点，确保多个工作流、多个节点之间的消息输出格式
- [对象管理](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0100.md): 对象是可复用的变量定义模板，将业务中常用的数据结构（如用户信息、订单详情、收货地址等）预先定义为对象，可在工作流全局配置中的记忆变量、开始节点中直接引用，无需重复定义相同的变量，显著提升开发效率与数据一致性。每个对象包含一个对象名称和一个对象变量（变量名称 + 变量类型 + 描述）。当变量类型为Object时，支持定义多层嵌套的结构化字段
- [多智能体应用介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0103.md): 在AgentArts中，单智能体应用能够处理基本任务。但在面对复杂任务时，单智能体往往需要编写冗长的提示词，并挂载多种插件、知识库或MCP服务。这不仅增加了调试的复杂性，且任意一处改动都可能影响整体功能，导致最终结果与预期存在较大偏差。为解决这一问题，AgentArts提供了多智能体应用。多智能体应用通过中央控制器对用户意图进行识别与分发
- [多智能体执行范式](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0105.md): AgentArts多智能体采用“多Agent控制器+子智能体”调度架构，适用于企业业务场景。一次完整的多智能体交互，按图1所示顺序执行。多智能体执行流程基于多Agent控制器的三种执行动作（继续/终止/等待输入）、生命周期工作流（起始/默认/结束）、全局意图和嵌套能力，AgentArts的多智能体支持如表1所示的三种执行范式和一种贯穿机制
- [创建并配置多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0106.md): 多智能体应用根据用户意图，将请求路由分发至对应的子工作流或子智能体执行，实现多场景的统一调度。多智能体应用的更多介绍请参考多智能体应用介绍。本节介绍配置多智能体应用的流程。不同套餐包允许创建的应用数量限制不同，具体可参考计费说明。已开通AgentArts服务。已发布并部署工作流。创建多智能体的基础信息。创建后，进入“多智能体配置”页面，初
- [调试多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0107.md): 开发者可以在多智能体应用创建完成后，直接与多智能体进行对话，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。创建多智能体应用后，AgentArts支持对应用进行预览与调试。试运行时，系统将按照多智能体的正式配置逻辑执行请求，通过中央控制器进行意图识别与路由分发，调用对应的子智能体或工作流。调试过程中产生的调用链信息与正式运行
- [部署多智能体应用为API](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0108.md): 虽然多智能体应用已试运行成功，但目前仍局限于开发环境，无法直接对外提供服务。为了实现应用的落地与对接，用户提交版本并完成部署后，即可通过API接口进行调用。提交版本是将当前多智能体应用配置保存为一个不可变的版本快照；部署是将指定版本发布为可调用的API接口，创建一个独立的运行实例。典型场景：多智能体应用试运行验证通过后，需要将其集成到企业
- [通过API调用多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0109.md): 多智能体应用部署为API后，您可以通过标准HTTP请求调用智能体，将其集成到企业业务系统、客服平台、聊天机器人等场景中。API支持流式（实时返回生成内容）和非流式（等待全部内容生成后返回）两种响应模式，满足不同的实时性需求。典型场景：将智能客服多智能体集成到银行APP中。用户发送问题后，系统自动调用多智能体API，中央控制器识别意图并路由
- [管理多智能体](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0284.md): 不同套餐包允许创建的应用数量限制不同，具体可参考计费说明。AgentArts支持将多智能体应用从一个环境中导出，导入至另一个环境中，无需用户重复构建，快速完成多智能体应用跨环境构建或复用。适用的业务场景如下：从测试环境导出多智能体，导入到生产环境中部署。在不同的开发环境之间迁移多智能体应用。将多智能体应用下载到本地进行代码归档。作为模板提
- [插件介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0123.md): 在Agent（智能体）中，插件是大语言模型（LLM）与外部世界交互的一系列工具。尽管LLM具备强大的自然语言处理与推理能力，但其本质是基于训练数据的静态系统，存在两大局限：信息滞后：无法获取训练截止日期之后的实时信息。行动力缺失：无法直接与现实世界的软件或硬件系统交互（如读写数据库、发送请求）。插件的引入，使Agent具备了实时信息检索、
- [示例：创建联网搜索插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0124.md): 本示例将介绍如何通过AgentArts智能体平台创建联网搜索插件，并进行插件的调试、发布，最终应用到Agent中。已开通AgentArts服务。本示例使用联网搜索API实现联网搜索功能，其API接口调用示例如下。请提前创建API Key，获取到的API Key用于替换下方代码中的<AppBuilder API Key>。调用该接口可能会产
- [基于API创建插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0126.md): 在AgentArts智能体平台中，当官方预置插件无法满足特定业务需求时，开发者需要自主创建插件。已开通AgentArts服务。API类型插件是将现有的RESTful API（HTTP/HTTPS接口）封装为Agent可调用的工具。它本身不承载业务逻辑，而是作为桥梁将指令“翻译”为API请求，交由外部系统执行逻辑并返回结果。典型适用场景：数
- [基于JSON文件导入API插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0128.md): AgentArts支持通过JSON文件形式导入API插件，可以直接将API插件中定义的接口、入参、出参、鉴权等信息编辑为一份JSON文件，再导入平台创建API形态的插件。JSON导入功能允许您通过配置文件而非手动单击界面来创建插件，平台解析该文件后，会自动完成插件注册、工具定义及鉴权配置，实现插件的即插即用。该功能特别适用于批量迁移（如将
- [调试发布插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0129.md): 插件创建完成后，需对其中的工具进行调试，确保插件能够正确调用。调试完成后，可对插件进行发布。只有处于发布状态的插件，才能被智能体正常使用。已创建插件，并已完成工具的参数配置，操作方法参考创建插件。调试成功后，页面会显示API的返回结果（如API的响应参数数据），且状态码通常显示200。工具调试网络连接失败/超时请检查API服务的域名是否正
- [在单智能体中使用插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0131.md): 如果把大模型（LLM）比作智能体的“大脑”，那么插件就是它的“眼睛”和“手”。通过集成插件，单智能体可以突破仅基于文本生成的局限，获得以下能力：连接外部世界：实时查询天气、搜索网页、读取数据库。执行具体操作：发送邮件、预定会议、生成图表。私有数据交互：调用企业内部API获取业务数据。在单智能体中，大语言模型能够理解用户意图，并主动调用插件
- [在工作流中使用插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0132.md): 相比于单智能体使用插件的“概率性调用”（由大模型决定是否用），工作流使用插件是“确定性调用”（流程走到这一步必须执行）。因此，设置的重心必须从“提示词设置”转移到“参数映射”和“数据流转”上。适用场景：固定业务逻辑：必须先查询订单状态，再根据状态回复用户。精确数据处理：需要调用计算器、汇率转换、数据库查询等不容许出错的操作。连接外部系统：
- [管理插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0133.md): AgentArts服务支持对插件进行版本管理、各版本历史记录查看、引用查询、删除、导出/导入插件的JSON文件等操作，确保插件全生命周期管理的规范性。核心功能包括：版本管理：发布新插件版本并记录版本信息，按时间顺序查看所有插件版本的发布详情。引用查询：定位使用该插件的智能体与工作流，支持手动更新版本。插件删除：移除不再使用的插件（高危操作
- [Skill介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_01301.md): 在AgentArts平台上，Skill可以将过去分散在不同文档、代码片段或零散笔记中的隐性知识，以显性化和结构化的方式组织起来，使AI能够按需、稳定地执行专业任务。您可以将Skill看作是开发者的工具箱，将积累的技术经验和最佳实践打包成技能包，使AI成为您专业领域的专家。与一次性使用的提示词不同，Skill是可以保存、复用和优化的任务解决
- [示例：导入旅游规划Skill](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0388.md): 本文档介绍的旅游规划Skill，旨在根据用户提供的主题内容，智能推荐并导入合适的旅游规划方案。用户可以选择手动指定规划风格，或由系统根据输入内容自动匹配适合的模板，适用于商务考察旅游、休闲度假旅游、自然生态旅游、文化体验、红色旅游等多种应用场景。该Skill能够灵活适配不同需求，提供结构清晰、内容丰富的旅游规划支持，提升整体规划效率与用户
- [导入Skill](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0367.md): AgentArts支持导入压缩包和导入OBS资源。选型建议：如果您的资源包存储在本地且大小不超过10MB，推荐使用“导入压缩包”；如果资源包已存储在OBS中，或体积较大、或需要通过CI/CD流水线集成，推荐使用“导入OBS资源”。导入压缩包：在AgentArts平台中，用户可以通过“导入压缩包”功能，将本地开发完成的资源包上传至平台，平台
- [管理Skill](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_01307.md): AgentArts服务支持对Skill进行引用查询、删除、导出、导入Skill文件等操作，确保Skill全生命周期管理的规范性。核心功能包括：引用查询：定位使用该Skill的智能体。Skill删除：移除不再使用的Skill（高危操作，需谨慎）。导出/导入Skill文件：实现Skill本地备份等。登录平台后，在左侧导航栏选择 “开发中心 >
- [Skill常见问题](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_01308.md): 本文档汇总了用户在使用AgentArts平台上传和使用Skill过程中可能遇到的常见问题及解决方案，帮助用户快速定位并解决问题。问题：文件格式校验不通过原因：提交的文件不是ZIP格式。ZIP文件解压后包含多个文件夹。文件夹名称与SKILL.md中定义的Skill名称不一致。SKILL.md文件未放置在文件夹根目录。解决方案：提交的文件必须
- [MCP介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0135.md): MCP（Model Context Protocol）是一个开放协议，旨在打通大语言模型（LLM）应用与外部数据源、工具之间的交互壁垒。在传统的开发场景中，由于每个数据源、工具或服务都有独立的格式规范、对接协议和认证体系，开发者往往需要为每个API单独编写代码、处理文档、配置认证方式和错误处理，这不仅效率低下，也大大增加了开发和维护的成本
- [示例：使用模板创建搜索MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0317.md): 本示例将介绍如何使用资产广场的预置MCP，并以必应搜索MCP为例介绍预置MCP的安装和使用方法。已开通AgentArts服务。一般平台展示的MCP配置，无论是表单编辑还是JSON编辑，均不需要改动，只需要关注是否填写鉴权信息即可。MCP是否需要鉴权取决于其所对接的后端服务本身的要求。不需要鉴权：有些MCP服务本身是公开开放的，任何人都可以
- [示例：快速接入ModelScope魔塔社区MCP工具集](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0318.md): 本示例将介绍如何在AgentArts智能体平台中接入来自ModelScope魔塔社区的开源MCP工具集，通过接入MCP工具集，智能体可以调用外部工具能力（如网页抓取、联网搜索等），扩展智能体的功能边界。已开通AgentArts服务。AgentArts智能体平台支持Stdio（本地进程，含NPX、UVX） 和HTTP（远程网络，含Strea
- [自定义接入MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0136.md): 自定义接入是最灵活的MCP创建方式。您可以通过填写MCP服务的连接地址，将任意MCP服务接入平台供智能体调用。该方式支持接入开源社区中的MCP（如GitHub、ModelScope上的开源MCP），也支持接入用户自主开发的MCP服务，适用于有特定业务系统对接需求、或需要使用社区开源MCP能力的场景。操作示例请参见示例：快速接入ModelS
- [基于模板创建MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0320.md): 如果您不想手动配置MCP服务的连接地址和参数，可以直接使用平台精选的MCP模板。平台精选MCP是由官方筛选并预置到资产广场的标准化MCP服务，已完成适配和验证，您只需安装即可使用（部分MCP需要填写鉴权信息后方可正常调用），无需额外的配置开发。当您的需求恰好在平台精选的覆盖范围内，这是最快捷的接入方式。操作示例请参见示例：使用模板创建搜索
- [调试MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0322.md): MCP创建完成后，建议先进行调试验证，确认MCP服务连接正常、工具已正确识别、调用结果符合预期后，再将其关联到智能体中使用。调试阶段是发现和排查问题的最佳时机，直接跳过调试，将问题带入智能体运行环节，会大幅增加排查难度。调用和调试MCP服务可能产生费用。平台预置的第三方MCP服务（如高德地图）可能需要您在对应平台申请API Key并承担相
- [在单智能体中使用MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0138.md): MCP创建并调试通过后，即可将其添加到智能体中使用。平台支持在单智能体和工作流两种模式下使用MCP，工作流中使用方法请参见在工作流中使用MCP。两者的核心差异在于工具的调用方式不同：简单理解：单智能体模式下，MCP工具是大模型的“自选动作”；工作流模式下，MCP工具是流程中的“规定动作”。调用MCP服务可能产生费用。平台预置的第三方MCP
- [在工作流中使用MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0139.md): MCP创建并调试通过后，即可将其添加到工作流使用。平台支持在单智能体和工作流两种模式下使用MCP，单智能体中使用方法请参见在单智能体中使用MCP。两者的核心差异在于工具的调用方式不同：简单理解：单智能体模式下，MCP工具是大模型的“自选动作”；工作流模式下，MCP工具是流程中的“规定动作”。调用MCP服务可能产生费用。平台预置的第三方MC
- [管理MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0140.md): MCP服务创建完成后，您可以在组件库中对其进行全生命周期管理。例如，当服务配置变更时需编辑配置，或重新部署。您可以通过服务名称或搜索关键字功能来查找MCP服务。也可根据需要执行表1所示的操作。
- [故障排除](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0323.md): 当MCP安装失败时，平台会返回特定的错误码以及错误信息提示。针对服务创建过程中可能遇到的网络连通性、环境配置冲突及协议错误，本章节提供了典型错误码的诊断流程与解决方案。多数MCP服务安装失败源于MCP的安装方式选择错误。在您深入排查网络问题、配置问题前，请先确认MCP的安装方式是否选择正确。平台支持Stdio（本地进程，含NPX、UVX）
- [知识库介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0148.md): 知识库是组织、存储及管理知识的系统，涵盖文档、图片等信息的分类整理，可以帮助用户高效管理大量的信息。在智能体中添加知识库，使其能够利用知识库中的信息与用户进行交互，可以显著提升智能体的准确度和专业度。AgentArts支持管理平台知识库和第三方知识库。平台知识库功能对文本文档、FAQ（Frequently Asked Questions，
- [知识库类型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0244.md): 平台知识库：不同套餐包的知识库存储空间容量不同，具体可参考计费说明。第三方知识库：AgentArts侧不计费，但第三方系统的部署与运维费用需用户自行承担，具体计费以第三方为准。AgentArts支持以下两种类型知识库的管理：平台知识库：在AgentArts内直接创建并管理的知识库。支持上传文本文档、FAQ文档等文件，设置文档标签，并对其进
- [知识库使用限制](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0149.md): 为保障平台资源合理分配和系统稳定性，知识库功能设有以下使用限制。当前AgentArts团队标准版、团队高级版、企业专业版、企业旗舰版未开放，如果需要购买，请提交工单咨询购买相关事宜。达到上述限制时，相关操作将失败并提示限制信息。如需提升配额，请购买团队标准版、团队高级版、企业专业版或企业旗舰版。如果您有以下需求，建议选择团队标准版、团队高
- [创建知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0152.md): AgentArts提供的知识库功能对文本文档、FAQ等数据进行向量化存储、知识检索，支持为应用、工作流提供检索增强能力。本文将详细介绍如何创建知识库，包含模型配置、解析配置和拆分配置等。创建知识库及上传文档会占用知识库存储容量，知识库存储容量具体可参考计费说明。文档导入过程中的向量化处理可能会产生模型调用费用，请关注配额及计费详情。Age
- [上传文档](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0153.md): 在创建知识库时，您可以选择本地上传知识文档，或通过对象存储服务（Object Storage Service, OBS）接入知识文档。本文将详细说明如何选择本地上传知识文档。上传文档适用于文件数量少、单次上传的场景。在创建知识库后，需上传文档至知识库，平台支持知识文档、FAQ问答对、FAQ文档三种形态的文档。上传知识文档：知识文档上传并解
- [知识库命中测试](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0157.md): AgentArts支持对创建的知识库进行命中率测试，以评估知识库的效果和准确性。建议在知识库创建完成后、正式用于智能体调用前，先进行命中测试验证效果。本文将详细介绍知识库创建完成后如何执行命中测试操作。在智能客服场景中，通过命中测试验证知识库能否准确召回用户常见问题的相关文档，确保正式上线后检索效果符合预期。知识库检索召回依赖于创建知识库
- [知识库分段](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0158.md): 对知识库进行分段设置主要是为了提高信息的组织性、可读性和检索效率。具体来说，分段设置的优势包括：提高可读性：将长篇内容分成多个段落，每个段落集中讨论一个主题或一个方面，可以使读者更容易理解和消化信息。长篇大论往往会让读者感到疲惫，而分段则可以提供自然的停顿点，帮助读者更好地吸收信息。增强组织性：通过分段，可以将相关的信息归类在一起，使知识
- [第三方知识库分类](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0286.md): 当您的企业数据已存储在现有的知识库系统中时，无需将数据迁移至AgentArts，通过接入第三方知识库可直接调用现有数据，实现知识复用。接入完成后，AgentArts智能体在运行时可通过标准接口调用第三方知识库中的数据，无需数据迁移。调用时，AgentArts将检索请求发送至第三方知识库，获取检索结果后返回给智能体使用。支持将第三方系统中的
- [连接General知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0245.md): 适用于企业已有现成知识库系统（如自研知识库、RAGFlow等），希望直接对接复用，避免数据迁移的场景。目前业界有诸多知识库种类，但并没有一个统一的规范。对于用户自开发的知识库平台，AgentArts提供了第三方通用知识库接入规范。知识库的开发者参考此规范进行适配后，即能够作为第三方知识库接入AgentArts平台。本文将介绍如何在Agen
- [连接KooSearch知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0169.md): 为什么要连接外部知识库？当企业已在KooSearch等平台构建了成熟的知识库，通过外部知识库连接可直接复用现有数据，无需重复上传，同时可利用KooSearch的联网增强能力获取公域知识。AgentArts支持连接外部知识库平台，以便用户访问和利用外部的知识资源。KooSearch可以帮助企业搭建企业级RAG，提升用户获取企业私有知识的效率
- [连接RAGFlow知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0166.md): AgentArts支持连接外部知识库，通过连接外部知识库，可以显著地扩展内部知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。RAGFlow适用于已自建开源RAGFlow知识库系统的场景。本文将介绍如何在AgentArts中对接第三方RAGFlow知识库。工作原理：连接成功后，AgentArts智能体在检索知
- [知识库命中测试](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0171.md): AgentArts通过对创建的知识库进行命中率测试，以评估知识库的效果和准确性。本文将详细介绍第三方知识库创建完成后如何执行命中测试操作。命中测试通过语义检索技术，将用户输入的问题与知识库中的文档片段进行语义相似度计算，返回相似度最高的多条结果。验证知识库是否正确导入：输入已知存在的文档内容关键词，检查是否能召回。评估检索质量：输入用户实
- [第三方通用知识库接入规范](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0246.md): 当您拥有企业内部已有的知识库系统（如内部Wiki、私有文档库），且不希望将数据迁移至AgentArts平台时，可遵循本规范开发适配接口。企业智能体需要检索内部保密文档，通过实现本规范定义的API接口，AgentArts可直接调用您的知识库服务进行问答增强。您需开发并部署两个标准HTTP接口，AgentArts智能体在对话过程中，当需要检索
- [在单智能体中使用知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0173.md): 支持在AgentArts中添加引用知识库，以根据用户意图来检索召回对应的知识切片。通过关联知识库，智能体可在回答用户问题前，先从私有知识库中检索相关信息，从而基于私有数据生成准确回答，有效减少模型幻觉。典型使用场景：企业内部知识问答：员工可通过智能体查询公司制度、流程规范等。产品文档查询：基于产品手册回答用户技术问题。私有数据问答：基于企
- [在工作流中使用知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0174.md): 支持在AgentArts中添加引用知识库，以根据用户意图来检索召回对应的知识切片。在工作流中，“知识检索”节点作为独立的处理单元，将检索结果输出给下游的“LLM”节点，使大模型能够基于检索到的私有知识生成回答。适用于需要结合工具调用、多轮复杂逻辑的场景。工作原理：知识检索节点接收用户问题，通过向量嵌入或关键词匹配在知识库中检索相关内容，按
- [管理知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0287.md): 知识库创建完成后，在“知识库”界面，您可以通过分类筛选或搜索功能来查找知识库。支持的其他操作请参考表1。知识库支持以列表和卡片形式展示。单击搜索框右侧按钮，知识库将以列表形式展示。单击搜索框右侧按钮，知识库将以卡片形式展示。
- [提示词介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0176.md): 提示词（Prompt）是用户输入给大语言模型的文本指令，用于引导模型生成符合预期的输出。提示词的设计影响模型的响应质量和逻辑准确性，是优化智能体表现的重要工具。通过精心设计的提示词，可以系统性地测试模型在语义理解、逻辑推理、常识判断、多轮对话等场景中的表现，帮助发现并修正其潜在的常识错误、逻辑漏洞或回答偏差。智能优化：通过自然语言与AI交
- [撰写提示词规范](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0177.md): 明确且清晰的提示词能够显著提升大模型的输出质量和稳定性。建议在编写前，先掌握相关技巧。示例：如何改善睡眠质量系统提示词（角色设定）你是一个专业且友好的健康生活顾问，专注于为用户提供基于科学依据的健康建议。你的回答应基于权威医学常识，避免夸大或误导性内容。所有建议都需注明仅供参考，不构成医疗诊断或治疗建议。在回答中，请使用通俗易懂的语言，避
- [创建提示词](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0178.md): 在构建Agent的过程中，提示词（Prompt）是决定输出质量与用户体验的关键因素，可帮助智能体明确任务目标、规范输出格式、控制内容风格、实现个性化响应。撰写提示词时，可在内容中添加变量实现动态响应。变量使用{{变量名}}格式，模型运行时根据实际传入的变量值动态生成文本。撰写规范的详细说明请参考撰写提示词规范。为什么要在提示词中设置变量？
- [优化提示词](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0179.md): 提示词优化，是让智能体从“机械应答”走向“懂场景、懂用户、懂规则”的关键一步，它不仅提升回答质量，更构建了可复用、可迭代、可扩展的智能服务基础。提示词优化任务的三大关键设计：为什么要进行提示词优化？因为提示词是智能体“理解用户、执行任务、生成回答”的第一道指令。它决定了智能体是否“听得懂”问题、是否“想得清”逻辑、是否“说得对”内容。如果
- [管理提示词](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0180.md): 提示词可以作为一种可复用的资源保存在资源库中。团队成员通过共享这一资源库，能够统一并提升对大语言模型（Large Language Model, LLM）的调用效率和效果。本文档将详细介绍如何在资源库中对提示词/提示词优化任务进行删除、编辑等操作，以确保资源库的持续更新和优化。已开通AgentArts服务。已创建提示词。已创建优化提示词任
- [在单智能体中使用提示词](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0181.md): 在搭建Agent应用的过程中，设置提示词是至关重要的一步。提示词是一种自然语言指令，用于指导大语言模型（LLM）如何完成特定任务。例如，在写作小说的场景中，提示词可以是请生成一个悬疑小说的开篇，营造紧张的氛围，描述主角在雨夜进入一座废弃的别墅。提示词的作用在于为模型提供明确的任务目标，规范输出格式，优化生成内容，并支持个性化需求。通过精心
- [在工作流中使用提示词](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0112.md): 在实际业务开发中，单纯依靠大语言模型（LLM）的通用能力往往难以直接满足复杂的业务逻辑需求，容易出现输出不准确或偏离预期的情况。为了解决这一问题，开发者需要在工作流的编排过程中，针对各个关键节点的具体职能，配置高度定制化的提示词，将泛化的模型能力转化为确定性的业务执行能力。如果您需要快速构建标准节点，推荐使用引用模板；如果需要定制化逻辑，
- [模型介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0183.md): 模型服务为智能体提供核心推理能力，是智能体实现自主决策和任务执行的基础。在AgentArts中，您可以通过模型服务为智能体接入大语言模型，使其具备文本对话、图像理解、向量化等能力。为满足不同用户的技术能力、业务场景及需求，AgentArts提供了多样化的模型服务模式。以下从模型来源对各类模型服务进行介绍，具体如表1所示。
- [免费模型与使用额度](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0186.md): AgentArts平台已对接MaaS模型即服务的模型，旨在为用户提供开箱即用的大模型核心能力支持。开通AgentArts后，平台默认提供2,000,000Tokens的免费使用额度，无需额外配置，可用于模型调测、智能体试运行。如果免费额度用完或通过API接口调用智能体，您需要开通MaaS对应的模型服务并完成鉴权配置，此时将按照MaaS模型
- [接入预置的付费模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0185.md): 本章节适用于以下场景：平台提供的2,000,000Tokens免费额度已在模型调测、智能体试运行中用完，或通过API接口调用智能体。接入预置的付费模型后，将按照MaaS模型即服务实际调用量（Token）进行计费，计费相关信息详见MaaS模型即服务价格。AgentArts平台预置的模型服务基于MaaS模型即服务提供。当免费额度耗尽后，您需开
- [自定义模型接入流程](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0189.md): AgentArts支持接入由用户或第三方部署在外部环境的模型服务API。相比使用平台预置模型，接入自定义模型服务具有以下优势：优化个性化体验：根据业务特点接入定制化模型，减少用户的搜索和选择时间，提供更加流畅高效的使用体验。例如，搜索引擎可根据用户的搜索历史和偏好，提供更精准的搜索结果。增强特定领域的准确性：接入专业领域的模型服务，可显著
- [接入模型供应商](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0190.md): 模型供应商提供的模型服务使企业和个人能够快速获取和使用高质量模型。在AgentArts中接入外部模型服务API前，需先接入模型供应商，用于对模型来源进行统一管理与标识。完成供应商接入后，您可在该供应商下继续接入具体的模型服务。已开通AgentArts服务。新建的模型供应商将显示在“自定义模型”供应商卡片列表中，默认状态为“已配置鉴权”。处
- [接入模型服务](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0191.md): 本章节介绍如何在已接入的模型供应商下接入模型服务API。为满足用户对模型的个性化与专业化需求，AgentArts支持接入由用户自建或第三方在外部环境部署的模型服务API。模型服务接入后，您可以在AgentArts中进行调测和发布，并在智能体中选择使用。当前支持接入的模型类型如下：文本对话（Chat）文本向量化（Embeddings）文本排
- [模型API接口规范](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0192.md): 本章节介绍标准OpenAI协议和AI引擎标准协议的接口规范。接入自定义模型服务前，请确保模型API符合对应的接口协议规范。当前模型网关支持接入以下四种类型的模型API：文本对话（Chat）文本向量化（Embeddings）文本排序（Rerank）图像理解各模型类型支持的接口协议如下表所示。本章节适用于以下场景：需要将第三方模型服务（如De
- [调测模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0187.md): 模型调测是指在平台侧对模型服务进行真实调用，并结合参数调整与效果观测，验证模型在特定场景下的可用性、稳定性与效果表现的过程。通过调测，您可以在模型正式发布或接入业务流程前，提前发现并定位常见问题（如鉴权失败、接口协议不匹配、响应超时、输出不符合预期等），确保模型在真实业务场景中能够稳定、高效地运行。调测时，平台将您的输入参数封装为标准AP
- [配置模型路由策略](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0194.md): 通过配置模型路由策略，您可以将多个已接入的模型服务按规则进行编排，实现模型故障自动切换能力。当主模型因故障、超时或不可用等原因无法正常响应时，系统将根据路由策略自动切换到其他可用模型继续提供服务，从而提升业务的稳定性与可用性。当模型出现以下情况时触发切换：返回HTTP 5xx错误、响应超时（超过策略总超时时间）、返回空响应等。路由策略工作
- [管理使用AgentArts的成员](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0280.md): AgentArts套餐包有成员使用限制，默认采用先到先得的自动许可机制，新成员加入时，系统自动授予访问许可，自动占用可用席位，席位不够将无法访问。如果套餐变更导致超额，将自动禁止最后加入的成员许可。当登录AgentArts平台成员数量达到上限时，会提示“成员数已达套餐上限，暂无法加入”。具有“agentarts::updateMember
- [管理云服务授权信息](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0218.md): 如果需要使用预置的MaaS模型，平台提供2,000,000tokens的免费额度，可用于模型调测、智能体试运行，免费额度用完或通过API接口调用智能体，则需要开通预置的MaaS模型即服务并设置鉴权，否则会导致功能不可用。如果需要对日志进行集中管理和分析，则需要开通云日志服务 LTS，否则会导致功能不可用。如果需要追踪和分析应用的性能问题，
- [管理模型授权信息](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0219.md): 如果未开通MaaS模型即服务，则可以在“授权管理 > 模型”页面开通。如果已开通MaaS模型即服务，则在“授权管理 > 模型”页面，显示已开通的模型服务，可以查看模型列表、模型版本信息、模型详情，调测模型。开通服务授权不会产生费用，使用后按实际使用量计费，实际扣费以各服务的账单为准。将默认开通MaaS模型即服务以及选择开通的模型。模型服务
- [资源与订阅](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0220.md): 资源与订阅界面，显示订阅管理及订购服务。订阅管理显示生效的套餐包、套餐资源剩余数量及资源总数量、购买CU的入口，可以查看计费说明、购买记录。资源剩余量从左至右、从上至下依次为：展示当前正在使用的套餐信息。单击“计费说明”，可打开计费说明帮助文档。单击“购买记录”，显示订购的套餐包。展示“购买CU”的入口。当账号欠费且CU按需计费订单资源被
- [支持云审计的关键操作](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0225.md): 平台提供了云审计服务（Cloud Trace Service，简称CTS）。通过云审计服务，可记录与AgentArts相关的操作事件，便于日后的查询、审计和回溯。已开通云审计服务。
- [在CTS事件列表查看云审计事件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0226.md): 云审计服务能够为您提供云服务资源的操作记录，记录的信息包括发起操作的用户身份、IP地址、具体的操作内容的信息，以及操作返回的响应信息。根据这些操作记录，您可以很方便地实现安全审计、问题跟踪、资源定位，帮助您更好地规划和利用已有资源、甄别违规或高危操作。本节介绍如何在云审计服务控制台查看或导出最近7天的操作记录。事件即云审计服务追踪并保存的
- [开发常见报错](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0228.md): AgentArts包括智能体管理、组件库、开发配置、运营运维、资源与订阅等模块。详细展开来说包括：单智能体、工作流、多智能体、公共、组件（插件、MCP、卡片、提示词、知识库）、模型接入、配置管理(意图、数据源)、提示词工程、环境管理、License控制、记忆管理、导入导出管理等，下面我们将针对各个模块的错误码进行说明。
- [更换密钥的加密方式](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0288.md): 在AgentArts中，创建插件、MCP、连接第三方知识库或模型供应商时，需要对访问凭证进行加密存储，AgentArts提供了对访问凭证的加密方式。如果您的业务对数据存储的安全性和合规性有较高要求，可使用AgentArts提供的服务端加密功能，对上传到AgentArts存储的数据进行加密保护。服务器端加密将对存储在AgentArts中的静

## 高代码开发

- [高代码开发概述](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_001.md): AgentArts高代码开发为专业开发者提供了一条从代码到生产的完整链路——在熟悉的本地环境中使用主流框架开发，通过标准化SDK接入平台能力，以镜像形式一键部署至云端托管环境，并享受生产级的可观测与安全隔离保障。核心价值：开发自由度高：使用LangChain/LangGraph等主流框架，代码完全自主可控。平台能力即插即用：记忆、MCP网
- [高代码开发流程](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_002.md): 在使用高代码开发智能体的过程中，您可以根据具体需求选择合适的构建方式：“从零开始构建高码Agent”和“代码云上托管”。从零开始构建高码Agent：开发者在本地使用LangChain、LangGraph等框架开发Agent核心逻辑，并集成AgentArts平台提供的记忆、网关、沙箱工具等云上能力组件，实现会话持久化、外部系统集成和安全隔离
- [基础示例：创建基础对话智能体](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_056.md): 传统开发Agent的方式，是用户在本地使用LangChain或LangGraph等编写智能体脚本，但当需要将其推向生产环境时，往往会卡在繁琐的工程化步骤上：需要手动编写路由、处理请求、构建Docker镜像，并自行寻找服务器部署。AgentArts提供了一条从代码到生产的完整链路。本示例作为高代码开发的入门第一课，将暂时剥离复杂的外部工具，
- [进阶示例：构建全能出行助手（集成模型/记忆/沙箱/网关/高德mcp）](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_057.md): 在基础示例中，我们已创建一个简易对话智能体，并将其托管部署至云上AgentArts环境。但在真实生产环境下，企业级智能体需要具备持久化记忆、安全沙箱执行、外部系统无缝对接等能力。本示例将基于LangGraph框架构建一个出行规划智能体，核心实现agent.py的TravelAgent类。该类封装LangGraph ReAct工作流（age
- [沙箱工具介绍](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_008.md): 沙箱工具是我们为Agent提供的在安全的沙箱环境中运行的技能增强包。通过代码解释器等原生工具，Agent能够超越纯文本对话，具备处理复杂逻辑计算 、实时信息获取乃至跨系统操作的能力。所有工具均运行在受控的沙箱环境中，确保执行过程的高效与安全。为Agent提供在安全、隔离的代码执行环境中运行的内置工具，使其能够调用安全隔离的运行环境，完成代
- [示例：基于控制台的工具开发与应用实践](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_009.md): 本示例演示如何创建AgentArts平台的沙箱工具（代码解释器），并通过该工具构建一个能够执行Python代码解决复杂问题的智能体。本示例共分为两个阶段。阶段一：创建代码解释器。在AgentArts平台创建代码解释器（沙箱）并完成基础配置，获取域名、API Key。阶段二：构建Agent并调用沙箱。在Linux服务器上准备Python环境
- [示例：基于SDK的工具开发与应用实践](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_010.md): 本示例介绍如何完全通过编写代码脚本，一次性自动完成沙箱的创建与Agent的开发。示例中分为两个阶段，先通过agentarts sdk创建沙箱，再创建Agent并调用沙箱完成任务。一、使用agentarts sdk创建沙箱。大多数Linux发行版（如Ubuntu）都预装了Python，您可以先通过python3 --version检查。如未
- [创建沙箱工具](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_011.md): 创建沙箱工具允许用户在安全的环境中测试和验证智能体的功能，确保在实际部署前能够发现和解决问题。当前仅支持创建代码解释器。代码解释器能够理解并解释代码的逻辑，帮助用户更好地理解代码的运行机制和功能。创建代码解释器有两种方式：通过控制台创建代码解释器通过SDK创建代码解释器使用沙箱工具前需要先开通AgentArts服务并进行服务授权，请在“授
- [在智能体中集成沙箱工具](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_012.md): 创建沙箱工具后，您需要将沙箱工具集成到智能体代码中，以便智能体可以调用隔离环境来完成代码运行等复杂任务。已创建代码解释器工具，具体请参见创建沙箱工具。已安装Python，且版本不低于3.10。已安装agentarts-sdk包。配置访问端点：通过AGENTARTS_CODEINTERPRETER_DATA_ENDPOINT设置环境变量 ，
- [管理工具](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_013.md): 工具创建完成后，您可以在工具列表按名称或标签筛选，单击名称进入工具详情页，可查看运行日志及管理标签。已开启日志记录，如未启用日志功能，可在工具详情页“日志”页签单击“去启用”开启日志记录。添加标签：单击“添加标签”，可选择TMS中的预定义标签，或自定义输入标签键与值。修改标签：直接修改已有标签内容即可。删除标签：单击目标标签后的“删除”即
- [记忆库概述](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_015.md): 记忆库是智能体的记忆中枢，可以通过控制台创建记忆库并配置短期和长期记忆策略，有效抽取并整合上下文信息，完成记忆数据的全生命周期管理。使用优势：开箱即用：短期记忆 + 长期记忆：支持短期记忆（7~365天）和长期记忆（持久化存储），满足不同时间跨度的记忆需求。多种记忆策略：支持语义记忆、用户偏好、会话摘要、情景记忆等策略，满足不同场景的记忆
- [示例：构建记忆库并集成SDK进行对话管理](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_016.md): 本示例描述了如何在AgentArts智能体平台上创建记忆库，并通过SDK与记忆库进行交互。记忆库用于存储和管理智能体与用户之间的对话历史，以便于后续的对话管理和个性化服务。操作系统：Linux ARM64，服务器可访问公网。需使用ARM64系统制作的Agent镜像，使用X86系统制作的镜像在调用智能体运行时时会调用失败。可以使用华为云EC
- [创建记忆库](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_017.md): 创建记忆库用于存储和管理用户信息、历史交互和偏好，以便智能体能够提供更个性化、高效和情境适应的响应。支持在控制台上通过配置长期记忆提取策略、短期记忆等参数来创建记忆库。使用记忆库前需要先开通AgentArts服务并进行服务授权，请在“授权管理”页面进行云服务开通及授权，详细信息请参考授权管理。如需通过私有网络VPC访问记忆库，请确保已开通
- [记忆检索](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_018.md): 从记忆库中快速检索已有的记忆，帮助智能体迅速获取用户的历史信息、偏好和过往交互。已创建记忆库并已集成记忆库。
- [在智能体中集成记忆库](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_019.md): 在智能体中集成记忆库，实现智能体与记忆库的快速对接。已创建记忆库，并获取记忆库的API Key。已安装Python，且版本不低于3.10。执行以下命令安装SDK（建议在Python虚拟环境中安装，以避免与系统包产生冲突）。# 安装依赖包 apt install python3.12-venv # 创建并激活虚拟环境 (linux) p
- [支持的观测指标](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_062.md): 本节定义了上报云监控服务（CES）的监控指标的命名空间，监控指标列表和维度定义，用户可以通过云监控服务提供管理控制台来检索产生的监控指标和告警信息。SYS.AgentArts
- [查看观测指标](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_058.md): 您可以通过以下指导，查看记忆库的观测指标。具体可查看指定时间段内的记忆访问QPS、记忆访问流控、记忆访问失败、记忆响应时延、短期记忆访问QPS和短期记忆访问失败等使用数据信息。时间选择：可以选择查看最近15分钟、30分钟、1小时、3小时、12小时、1天、3天、7天的数据。统计周期：可以选择数据的统计周期，选择1分钟可以看到每分钟的QPS（
- [创建告警规则](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_059.md): 云监控服务（CES）提供使用告警模板创建告警规则的功能，当您需要监控云服务资源的使用情况或关键操作时，可以创建告警规则。告警规则添加完成后，当监控指标触发设定的阈值或者指定的事件发生时，云监控服务会在第一时间通过消息通知服务实时告知您云上资源异常，以免因此造成业务损失。关键参数配置如下：配置告警规则基本信息。名称：告警规则的名称。系统会随
- [管理标签](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_076.md): 记忆库创建完成后，您可以通过标签在记忆库列表中进行过滤查询。在记忆库详情页面，也可以管理标签。添加标签：单击“添加标签”，可选择TMS中的预定义标签，或自定义输入标签键与值。修改标签：直接修改已有标签内容即可。删除标签：单击目标标签后的“删除”即可。
- [网关介绍](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_022.md): 网关是连接AgentArts与外部系统/服务的统一接口层，负责数据交互与安全访问控制。通过提供标准化入口，实现AI能力与存量系统的快速对接，并支持多协议、多认证方式的集成。使用优势：通过API自动转换能力，可快速将企业内部系统对接至AgentArts，减少开发工作。多层身份认证（如APIKey、OAuth认证）与网络隔离（公网/私网访问配
- [示例：集成高德的MCP服务实现旅行攻略制定](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_023.md): 本示例介绍如何通过集成高德的MCP服务来实现旅行攻略的制定。高德MCP如下，使用前，请参考高德开放平台文档，创建获取API Key。{ "mcpServers": { "amap-maps-streamableHTTP": { "url": "https://mcp.amap.com/mcp?key=您在高德官网上
- [创建网关](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_024.md): 网关作为智能体与外部系统之间的通信中介，不仅负责双向通信和协议转换，还提供了日志记录的功能，确保系统的安全、高效和可扩展性。创建网关有两种方式：通过控制台创建和通过SDK创建。如果您选择使用SDK创建网关，可以参考Gateway SDK，本章节主要介绍通过控制台创建网关。使用网关前需要先开通AgentArts服务并进行服务授权，请在“授权
- [MCP协议版本介绍](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_074.md): MCP（模型上下文协议）是智能体连接外部工具与数据的通用开放标准。为保障协议兼容性，AgentArts在创建网关时支持配置一个或多个MCP协议版本。网关创建后，调用接口时网关会校验请求中携带的协议版本是否在已配置的支持列表中。当前网关MCP支持的协议版本及官方文档如下：2025-11-252025-06-182025-03-26MCP协议
- [创建Target](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_025.md): 创建网关时，可以创建并绑定Target。创建Target用于定义和配置一个目标端点或服务，网关将接收到的请求转发到该服务进行处理。已完成创建网关。创建Target时，选择REST API类型的Target，且从OBS中获取文件时，用户除了需要具备网关的FullAccessPolicy权限外，还需包含以下身份策略权限：授权项授权项功能介绍o
- [REST API](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_072.md): OpenAPI 是用于描述REST API的广泛使用标准。Gateway支持通过OpenAPI 3.0与 Swagger 2.0规范来定义 API Targets。OpenAPI Targets使Gateway对接后端REST服务，该后端接口由导入的OpenAPI规范进行描述。Gateway将传入的MCP请求转换为这些API的HTTP请求
- [MCP](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_063.md): 当网关Target配置为MCP类型时，网关遵循标准 MCP 协议（基于 JSON‑RPC 2.0 消息格式）与后端 MCP Server 进行交互，无需额外适配转换逻辑，可原生兼容MCP Server的工具调用能力。网关会统一接收智能体与大模型下发的结构化指令及上下文请求，转发至对应的后端MCP Server，由MCP Server完成工
- [APIG](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_083.md): API网关（APIG）是为企业和开发者提供的高性能、高可用、高安全的云原生网关服务，帮助企业快速构建、管理和部署API。当网关Target配置为APIG类型时，将以APIG上注册的API作为目标服务。此时，需从APIG导出API文档，并补充完善请求体的详细定义后，方可调用后端服务。仅支持OpenAPI 3.0 和Swagger 2.0 规
- [云服务](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_081.md): 当网关Target配置为云服务类型时，目标服务指向华为云服务的开放接口。当前支持50余个华为云服务，通过调用注册在APIE（API Explorer）上的接口实现对接。出站认证支持IAM以及无认证方式。使用IAM出站认证时，需确保创建的出站身份认证中，IAM信任委托包含如下Action权限：sts::setContext：获取 STS5 
- [调测网关](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_064.md): 网关创建完成后，支持在控制台调测网关，用于验证网关配置的正确性和连通性。已创建网关并关联Target。网关 URL：创建网关后生成的网关URL，系统默认写入，无需添加。Access token（可选）：当网关的入站身份认证配置为“OAuth 2.0认证”时，可配置Access token，用于验证调用者的身份。如果未设置Access to
- [使用网关](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_026.md): 创建网关后，您需要将已经创建的网关集成到智能体的代码中或添加到已有的智能体，以便后续调用网关能力。已完成创建网关。网关提供入站认证鉴权和出站身份认证两层安全机制，保障调用方与后端工具之间的安全通信。调用网关或调用网关Target需要获取对应凭证：入站身份认证：调用方访问网关时的认证和鉴权，用于验证调用方身份并控制访问权限。详情请参见认证鉴
- [管理网关](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_027.md): 网关创建完成后，在“网关”界面，您可以通过网关状态、名称、ID或标签筛选网关，在网关详情页面，您可以查看网关在使用过程中产生的日志以及管理网关标签。已开启日志记录，如未启用日志功能，可在网关详情页“日志”页签单击“去启用”开启日志记录。添加标签：单击“添加标签”，可选择TMS中的预定义标签，或自定义输入标签键与值。修改标签：直接修改已有标
- [智能体运行时介绍](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_029.md): 智能体运行时是一个安全隔离、框架无关的托管执行环境，专为生产级智能体设计，提供企业级的弹性伸缩与权限治理能力，帮助开发者专注于业务逻辑，无需关心底层基础设施的运维。安全隔离运行环境安全沙箱：基于安全沙箱技术实现microVM隔离，提供企业级运行时可靠性及安全保障。框架无关性：支持基于Agent框架（LangChain、LangGraph、
- [HTTP](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_070.md): 介绍代理应用中 HTTP 协议的实现要求，基于 HTTP 搭建 REST API 接口以适配传统请求响应模式，同时部署 WebSocket 接口实现实时双向流式通信。HTTP（/invocations）和WebSocket（/ws）端点可部署在同一个容器中并使用8080端口，单个代理服务可同时兼容传统 API 交互与实时双向流式通信。需满
- [MCP](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_069.md): MCP（Model Context Protocol） 是一套标准化协议，用于让AI模型安全、高效地对接外部工具、数据源与服务，统一上下文交互与能力调用规范。MCP服务器可实现以下协议要求：传输：流式 HTTP 传输，默认情况下，使用无状态模式（ stateless_http=True）以兼容AgentArts的会话管理和负载均衡。会话管
- [制作Agent镜像](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_079.md): 本文介绍如何手动制作符合AgentArts智能体运行时规范的Docker镜像，并将其上传至华为云容器镜像服务（SWR），用于后续通过控制台部署智能体运行时。参考环境准备做好环境准备工作。参考本地开发完成Agent本地代码的编写。在 Dockerfile 所在目录执行以下命令：（可选）如果遇到拉取python:{version}-slim包
- [制作MCP Server镜像](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_080.md): 一个最小化的MCP Streamable HTTP计算器服务器示例，基于官方MCP SDK的FastMCP实现。适合作为学习MCP协议，快速搭建Streamable HTTP服务的起点。Model Context Protocol (MCP) 是由Anthropic提出并开源的协议标准，用于标准化大型语言模型（LLM）应用与外部工具、数据
- [通过控制台部署智能体运行时](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_031.md): 将本地构建的高代码智能体部署至运行时上，为智能体提供一个安全隔离、与框架和模型无关的托管运行环境，确保智能体在独立、受控的条件下运行。本文为您介绍如何在控制台上创建智能体运行时，定义智能体的基本信息、来源方式、权限与访问控制等。使用智能体运行时前需要先开通AgentArts服务并进行服务授权，请在“授权管理”页面进行云服务开通及授权，详细
- [通过SDK部署智能体运行时](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_030.md): 本文以预置Agent模板为例，介绍如何在本地使用AgentArts SDK的Toolkit工具将本地代码部署到云上AgentArts智能体运行时。AgentArts SDK包含一套命令行工具，用于简化Agent应用的全生命周期管理，包括初始化、配置、构建、部署和运维。当前Toolkit已预置以下Agent示例模板供您选择，您也可以使用自研
- [创建智能体运行时访问方式](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_048.md): 智能体运行时的访问方式用于与已经部署好的智能体运行时进行通信和交互，可以通过创建的访问方式访问指定的智能体运行时版本，如未创建访问方式，则默认使用智能体运行时的Latest访问方式。Latest默认访问无法编辑与修改，且“Latest访问方式”默认关联运行时的最新版本。详细请参考调用智能体运行时中的endpoint参数。访问方式创建完成后
- [配置入站网关](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_068.md): 为了通过互联网或者VPC内网访问智能体运行时，需要在AgentArts智能体开发平台中创建和配置网关，并在创建智能体运行时的时候选择已创建的网关。最多可配置5个入站网关。默认网关可编辑修改描述、是否开启公网访问和关联VPC，不可删除。VPC提供了逻辑隔离的网络环境，确保网关和其关联的资源在一个独立的网络中运行，在VPC中，可以创建多个子网
- [调用智能体运行时](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_066.md): AgentArts提供Open API请求方式，可通过调用路径发送请求，程序将调用应用并返回预期结果。在调用智能体运行时前，须确保已部署智能体运行时，具体请参考通过控制台部署智能体运行时。用于检测智能体运行时实例是否正常运行。系统会默认使用智能体运行时配置的协议（如HTTP）和监听的端口（如8080）来发送探活请求，检查实例是否响应。也可
- [调用MCP服务](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_067.md): 智能体运行时支持部署和运行MCP服务器。本章节介绍如何创建、测试并部署MCP服务器。步骤1：创建MCP服务器步骤2：在本地测试MCP服务器步骤3：将MCP服务器部署到AgentArts步骤4：调用已部署的MCP服务器操作系统：Linux ARM64，服务器可访问公网。需使用ARM64系统制作的Agent镜像，使用X86系统制作的镜像在调用
- [管理智能体运行时](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_032.md): 智能体运行时创建完成后，您可以管理并查看运行时过程中的日志以及查看智能体运行时版本。如未启用日志功能，可在“日志”页签单击“去启用”开启日志记录。当修改智能体运行时的基本信息、权限与访问控制，或者智能体代码更新并打包成新镜像重新上传后，运行时版本均可更新。添加标签：单击“添加标签”，可选择TMS中的预定义标签，或自定义输入标签键与值。修改
- [更新运行时镜像](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_033.md): 智能体的代码修改后，可以重新打包成新的镜像，将新的镜像上传，确保智能体的更新过程有序、可控。已创建智能体运行时，具体操作请参见通过控制台部署智能体运行时。
- [观测智能体](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_034.md): AgentArts智能体开发平台提供了完善的可观测性能力，支持将智能体运行过程中的对话数据自动上报至运营运维平台。通过分析这些数据，开发者可以实时监控智能体运行状态、排查故障。在创建智能体运行时、网关、沙箱工具时开启日志，即可在“观测 > 智能体运行分析”展示智能体运行时、网关、沙箱工具的日志。详情请参见查看高代码应用运行数据。
- [SDK简介](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_037.md): 在开发智能代理应用时，开发者经常面临接口不统一、开发工具链缺失、最佳实践缺乏封装以及扩展性不足等问题，导致开发效率低下。AgentArts SDK通过以下方式解决上述痛点：标准化接口：提供统一的API规范，简化平台集成。开发工具链：内置CLI工具，支持快速创建、调试和部署。最佳实践封装：内置错误处理、日志记录、性能优化等最佳实践。灵活扩展
- [SDK应用框架](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_038.md): SDK应用框架基于Starlette Web框架实现，采用装饰器模式将用户函数封装为HTTP端点。这种设计使得开发者无需关心底层网络通信，只需专注于业务逻辑的实现。AgentArtsRuntimeApp是SDK的核心类，继承自Starlette框架，提供AI代理部署所需的所有Web服务功能。文件位置：src/agentarts/sdk/r
- [快速开始](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_040.md): 操作系统：Linux ARM64，服务器可访问公网。需使用ARM64系统制作的Agent镜像，使用X86系统制作的镜像在调用智能体运行时时会调用失败。可以使用华为云ECS服务购买服务器，购买时需要选择鲲鹏架构（ARM64）。需使用ARM64系统制作的Agent镜像，使用X86系统制作的镜像在调用智能体运行时时会调用失败。可以使用华为云EC
- [CLI](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_039.md): AgentArts Starter toolkit是SDK提供的命令行工具，用于在终端中管理Agent的部署、调用、状态查询和资源销毁等操作。操作系统：Linux ARM64，服务器可访问公网。需使用ARM64系统制作的Agent镜像，使用X86系统制作的镜像在调用智能体运行时时会调用失败。可以使用华为云ECS服务购买服务器，购买时需要选
- [Runtime SDK](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_041.md): Runtime SDK是SDK的核心组成部分，提供Agent运行时所需的所有功能，包括请求处理、响应生成、上下文管理等。开箱即用，一键部署零配置部署：一行命令即可将本地Agent部署到云端Runtime，无需手动构建镜像、配置网络。CLI工具完备：agentarts dev本地运行、agentarts launch一键部署、agentar
- [Tools SDK](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_042.md): 支持CodeInterpreter生命周期管理和Session生命周期管理。用户空间已存在代码解释器时，SDK支持快速拉起代码解释器会话已开通AgentArts。登录控制台获取AK/SK，和API_KEY信息，详情请参考如何获取华为云AK/SK和如何获取沙箱工具的API_KEY。已安装Python，且版本不低于3.10。查看Python版
- [Memory SDK](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_043.md): Memory SDK提供两种使用模式：Client模式：功能完整的客户端，适合需要控制所有操作的应用场景。Session模式：基于绑定的会话进行记忆管理，适合特定用户/对话场景。Client模式完整案例#!/usr/bin/env python3 """ Client模式完整使用案例 创建Space -> 创建Session -> 发送M
- [Identity SDK](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_044.md): Identity SDK提供华为云身份认证服务的管理能力，支持工作负载身份、凭证提供者、访问令牌等管理功能。IdentityClient是身份认证服务的高级客户端。文件位置：src/agentarts/sdk/services/identity/identity_client.pyAPI Key凭证提供者provider = client
- [Gateway SDK](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_045.md): Gateway SDK提供管理网关及相关操作的命令行工具，支持网关和Target的创建、查询、更新、删除等功能。已开通AgentArts。登录控制台获取AK/SK，详情请参考认证鉴权。export HUAWEICLOUD_SDK_AK="your-access-key" export HUAWEICLOUD_SDK_SK="your-se
- [认证鉴权](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_047.md): AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送
- [如何获取沙箱工具的API_KEY](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_050.md): API_KEY认证就是在请求时将API_KEY信息添加到消息头，从而通过身份认证。
- [如何获取记忆库ID和API Key](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_051.md): API_KEY认证就是在请求时将API_KEY信息添加到消息头，从而通过身份认证。在创建记忆库后，需要复制或下载API Key，以便在SDK客户端进行鉴权使用。API Key如丢失，需重新申请更新，请根据以下操作执行。
- [如何使用记忆库的API Key](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_082.md): 在调用数据面接口涉及鉴权时，请求的Header中需要包含对应记忆库的API-Key。传入Header的鉴权方式如下：使用Authorization头部进行鉴权。Authorization头部的内容格式为 Bearer <api-key>，其中 <api-key> 是您的API密钥，如Bearer sk-f6855361556a4a5488
- [获取华为云MaaS服务模型API Key](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_053.md): MaaS服务提供基于昇腾适配的主流大模型，覆盖DeepSeek、GLM、Kimi、Qwen等模型。
- [Dockerfile参数在智能体运行时中如何使用](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_052.md): 如果您了解容器引擎的使用，明白定制镜像时，一般使用Dockerfile来完成。Dockerfile是一个文本文件，其内包含了一条条的指令，每一条指令构建镜像的其中一层，因此每一条指令的内容，就是描述该层应该如何构建。本章节将介绍Dockerfile文件的一些配置如何对应到智能体运行时中去使用。下面通过一个例子来说明它们之间的关系，这样您就
- [执行pip install agentarts-sdk命令安装AgentArts SDK时速度较慢或下载超时](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_055.md): 在使用pip install agentarts-sdk命令安装AgentArts SDK时，可能会遇到下载速度较慢或下载超时的问题。通常是由于网络连接问题或没有使用国内镜像源导致的。检查网络连接确保您的网络连接正常，可以尝试访问其他网站或使用其他网络环境进行测试。确保您的网络连接正常，可以尝试访问其他网站或使用其他网络环境进行测试。使用
- [执行pip install agentarts-sdk命令安装AgentArts SDK时出现externally-managed-environment报错](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_061.md): 执行pip install agentarts-sdk命令安装AgentArts SDK时出现externally-managed-environment报错。建议使用虚拟环境进行安装，以避免与系统全局环境发生冲突。

## 智能体运营运维

- [观测介绍](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0002.md): 在AI应用的开发与部署过程中，请求调用路径复杂交错，难以追踪关键节点，导致问题定位困难、性能瓶颈难以发现。为解决这一痛点，观测功能应运而生。观测功能通过在请求处理的每个关键节点插入探针，自动采集处理时间、调用路径等信息，构建完整的调用链（Trace），并通过可视化界面展示，帮助开发者快速定位问题。例如，当用户发起请求时，系统会记录从请求开
- [数据上报概述](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0004.md): 智能体应用不同于传统的确定性程序，其运行过程具有高度的动态性和复杂性。在单次任务执行中，往往涉及大模型推理、外部工具调用等多个环节的链式组合。在开发与运维过程中，开发者常面临以下挑战：“黑盒”运行：难以直观判断智能体为何做出某种决策，或在哪一步骤发生了阻塞。故障定界难：当智能体输出结果异常时，难以快速定位是模型幻觉、工具调用失败还是上下文
- [上报AgentArts中的智能体数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0005.md): AgentArts智能体平台提供了完善的可观测性能力，支持将智能体运行过程中的数据自动上报至运营运维平台。通过分析这些数据，开发者可以实时监测智能体运行状态、排查故障以及优化模型性能。数据上报机制平台采用默认开启的上报策略，具体流程如下：默认行为：智能体创建后，系统默认开启数据上报开关，用户可选择开启或手动关闭。用户通过API调用智能体运
- [上报高代码智能体数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0006.md): 在本地开发智能体时，由于运行环境缺乏有效的监测手段，开发者往往难以洞察内部状态，面临异常排查困难、根因定位模糊等挑战。AgentArts支持将本地开发的智能体接入平台运行时。通过该机制，不可见的运行数据将转化为可视化的视图与日志详情，实现运行日志的可视化查看与检索。这不仅打破了本地运行的信息壁垒，更帮助开发者快速排查运行异常与定位错误根因
- [功能介绍](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0123.md): AgentArts观测功能支持统计三类数据来源：本章节介绍第三类：第三方智能体的观测数据上报。如果您的智能体不是在AgentArts平台上开发或部署在AgentArts平台，可以通过观测OpenAPI，将智能体的Trace（调用链）、Metric（指标）和Log（日志）数据上报至平台。其中Trace和Metric数据格式遵循OpenTel
- [数据上报准备](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0124.md): 外部智能体需要在AgentArts平台创建一个智能体实体，获取该智能体的接入地址、鉴权信息、智能体ID信息。如果忘记获取该信息，单击智能体名称，在“接入指南”中重新获取。
- [Trace数据上报](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0125.md): Trace数据用于记录智能体的单次请求详情，包括调用链路、节点耗时、模型输入输出等。下面以Python语言开发的智能体为例，介绍如何将Trace数据上报至AgentArts观测平台。第三方智能体上报的Trace数据将直接写入您的华为云应用性能管理APM服务。APM会根据上报的数据量按需计费。为避免在生产环境因大并发测试产生意外费用，请在部
- [Metric数据上报](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0126.md): Metric数据用于统计聚合信息，如请求次数、Token消耗量、成功率等。下面以Python语言开发的智能体为例，介绍如何将Metric数据上报至AgentArts观测平台。第三方智能体上报的Metric指标数据将写入您的华为云应用运维管理AOM服务。AOM会根据指标上报的数量按需计费。在生产环境部署前，请仔细阅读AOM计费说明。安装Op
- [Log数据上报](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0133.md): Log数据用于记录智能体运行过程中产生的日志信息，便于排查异常、追踪运行状态。日志最终写入华为云的LTS（云日志服务）。AgentArts支持通过API方式接入日志采集：上报的日志数据将写入华为云LTS（云日志服务），LTS会根据日志数量按需计费，详细计费规则请参考LTS计费说明。通过调用LTS REST API，在代码中主动上报日志数据
- [OpenTelemetry字段映射](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0127.md): 在AgentArts观测看板中，您看到的每一个图表（如用户数趋势、Token消耗排行、平均耗时等），底层均依赖于您通过OpenTelemetry(OTel) SDK上报的数据。为了方便您快速对照，下表将AgentArts观测看板上的业务指标与您在代码探针中需要上报的底层字段进行了统一映射。当您了解了字段的映射关系后，如需在代码中进行具体集
- [查看业务指标信息](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0010.md): 应用上线运行后，可能会面临Tokens消耗异常飙升、响应成功率下降或模型调用耗时突增等问题。如果缺乏数据支撑，开发者往往难以定位根因，只能盲目调整提示词或工具配置。通过“业务指标”页签，您可以监测智能体的关键运行表现，如Tokens消耗、响应成功率、模型请求成功率、模型调用平均耗时等。通过实时监测这些核心指标，可及时发现性能瓶颈、异常波动
- [查看运营指标信息](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0011.md): 运营指标页面为您提供当前租户下智能体应用和工作流应用的关键使用数据。通过这些数据，您可以了解智能体应用的总数、新增数量、活跃数以及资源消耗情况，帮助您优化资源分配，提高使用效率，并及时发现和解决问题。数据来源：运营指标数据来源于通过API方式调用智能体所产生的交互记录。控制台页面内的调试对话、编排预览等操作不计入运营指标统计。典型应用场景
- [查看应用调用链信息](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0012.md): 调用链分析界面通过可视化展示请求的完整生命周期，支持查看各节点的详细信息，包括响应时间、Token消耗等关键指标。当智能体响应缓慢或回答不符合预期时，您可以通过调用链分析各个节点的执行情况，快速定位性能瓶颈或报错环节。例如，当智能体回答延迟超过10秒时，通过调用链查看哪个Span耗时最长，定位瓶颈；当智能体回答内容错误时，通过调用链查看M
- [查看会话分析信息](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0013.md): 会话分析功能记录了智能体与用户对话的历史数据。通过查看会话信息，您可以追踪对话上下文、分析模型响应耗时、统计Token消耗，从而快速定位对话异常问题，优化智能体效果。会话记录了用户与智能体的交互上下文，每次对话交互背后会生成一条或多条调用链数据，用于记录具体的执行轨迹。调用链记录了智能体执行过程中的各子步骤，包括模型推理、工具调用、知识检
- [查看高代码智能体运行时数据信息](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0015.md): AgentArts平台支持主流开源Agent框架的托管与运行，可将本地开发的智能体托管至云上运行。具备企业级安全隔离、秒级启动和海量弹性能力，并通过记忆、MCP网关和工具增强功能，全面提升智能体运行效率与安全性。高代码智能体部署后会生成运行时实例，运行时数据包括该实例的调用状态和运行日志，可用于故障排查与运行监测。已开通AgentArts
- [查看沙箱工具数据信息](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0016.md): 沙箱工具是AgentArts为Agent运行提供的安全环境，所有工具均运行在受控的沙箱环境中，确保执行过程的高效与安全。沙箱工具当前支持代码解释器一种工具类型。您可以查看沙箱工具在调用过程中产生的运行时日志，包含调用时间、调用状态、输入输出摘要、错误信息等字段。已开通AgentArts服务。已创建沙箱工具并开启日志上报开关。创建沙箱工具请
- [查看网关数据信息](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0017.md): 网关是连接AgentArts与外部系统/服务的统一接口层，负责数据交互与安全访问控制。通过提供标准化入口，实现AI能力与存量系统的快速对接，并支持多协议、多认证方式的集成。您可以查看网关在调用过程中产生的运行时日志，包含调用时间、调用状态、请求路径、响应状态码等字段，帮助您排查网关调用异常。已开通AgentArts服务。已创建网关并开启日
- [查看智能体上报的数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0132.md): 通过OpenTelemetry协议上报的Trace、Metric和Log数据，与AgentArts平台内智能体自动上报的数据共享同一套观测页面。上报成功后，您可以在"智能体列表"页面查看以下数据：第三方托管智能体：筛选"第三方托管智能体"，查看通过OpenTelemetry协议上报的Trace、Metric和Log数据。AgentArts
- [人工标注Trace数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0019.md): 调用链数据记录了业务运行的完整过程（如调用链路、输入输出及执行状态）。通过本功能，您可以创建自定义标注，对调用链数据进行分类（例如标记异常或关键事件），从而快速定位问题、识别业务规律，有效提升业务评估与迭代效率。例如，在对话类应用中，您可以标注“幻觉”或“语气不当”的回复，以便后续筛选出劣质案例进行模型优化。在开始标注前，请先创建所需的标
- [Trace数据回流](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0021.md): 当您的智能体上线运行后，平台的观测模块会通过Trace（调用链追踪）记录下每一次交互的底层埋点数据。面对海量的Trace和几十个生涩的字段，我们该如何挑选？又该在什么场景下将它们回流到数据集？在操作之前，请先了解底层的核心概念与平台的评测机制。把智能体处理用户请求的过程想象成一次“快递运输”，Trace就是这趟运输的完整物流总单，而Spa
- [评估介绍](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0023.md): 随着大模型技术快速发展与广泛应用，智能体评估已成为AI应用开发的关键环节。传统评估依赖人工操作，从评测集构建、任务执行到报告输出，流程繁琐、效率低、易出错，且难以覆盖全场景、缺乏标准化评测能力，影响评估准确性与可靠性。AgentArts智能体开发平台提供评估功能，内置开箱即用的预置评估器；如果预置评估器无法满足业务需求，也支持自定义评估器
- [示例：快速完成一次智能体评估](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0024.md): 本场景以“科学知识问答”为例，演示如何通过AgentArts平台完成智能体的在线评估与调优。该场景旨在解决智能体上线前可能存在的幻觉、答非所问等问题，通过量化评估确保服务质量。主要流程包括：构建智能体：创建“科学知识问答”，配置包含人设、任务描述及约束条件的提示词，并发布版本以开启调用链数据采集。配置在线评估：基于智能体产生的真实调用链数
- [示例：基于离线任务进行评估](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0025.md): 智能体开发完成后，直接上线面临幻觉多（编造虚假内容）、工具调用错误、答非所问等风险。如何在上线前量化它的能力？如何知道修改了一句Prompt后，智能体变聪明了还是变笨了？这就是智能体评估的核心价值所在。为了方便理解，可以将“智能体评估”看作一次“模拟考试”：评测对象（考生）：开发好的智能体。评测集（考卷）：要考查智能体的哪些边界问题。评估
- [人工创建单轮评测集](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0027.md): 评测集是用于评估Agent回复效果的数据集，通常包含两部分：输入数据（input）和预期输出（reference_output）。输入数据作为评估对象的输入，预期输出则是期望的结果，用于作为评估的基准。通过将Agent的实际输出与预期输出进行对比，可以准确评估其准确性，从而发现潜在的问题。已开通AgentArts服务。登录AgentArt
- [人工创建多轮评测集](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0028.md): 多轮对话是通过模拟用户与智能体连续、交互式的沟通场景，记录完整的对话上下文历史。它旨在解决智能体在长对话中的上下文记忆保持、意图切换理解、逻辑连贯性等核心能力的评估难题。在AgentArts平台中，一个完整的多轮评测集由一个或多个“数据项”组成，每个数据项代表一次独立的对话会话，而每个会话内则包含了一组连续的“输入”与“期望输出”。已开通
- [AI合成评测集](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0029.md): 智能合成评测数据功能旨在解决应用在评估过程中评测样本“质低量少”的瓶颈。通过大模型技术，平台能够对原始种子样本进行泛化与强化，帮助用户快速、低成本地构建出符合特定业务需求的高质量验证数据集。工作原理智能合成评测数据功能基于大模型技术，通过对原始种子样本进行语义理解、风格迁移和场景扩展，生成符合特定业务需求的高质量验证数据集。具体工作流程如
- [回流Trace数据至评测集](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0030.md): 在应用开发过程中，难以完全模拟真实用户复杂多变的行为模式。这导致人工创建的评测集评估的结果可能与线上实际表现存在偏差，开发者需要通过真实的线上数据来完善评测与训练体系。Trace数据回流功能旨在解决上述痛点。它支持将应用上线后、在真实场景下产生的Trace数据进行回流与标注，并将其沉淀到数据集中。这一机制将“线上实战”转化为“数据资产”，
- [回流评估结果至评测集](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0031.md): 支持将评估任务产出的结果回流至评测集。通过配置回流规则，可以将得分较高或较低的数据进行分类回流，帮助您利用线上真实数据构建“高质量数据集”与“问题数据集”，从而实现评测集的持续迭代与优化。通过回流线上真实数据，可以显著提升评测质量，具体体现在以下几个方面：构建“黄金评测集”：通过筛选高分的线上真实对话，沉淀出一套标准的“黄金评测集”。该集
- [维护评测集](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0032.md): 完成评测集数据的添加后，发布评测集版本。已经发布的评测集，修改后再次发布，显示为“更新版本”。如果评测集已发布，修改后再次发布时，操作列的按钮将显示为“更新版本”。版本格式为a.b.c，其中每段数字的范围为0-999。同一个评测集发布的版本号应大于之前的历史版本号。导出全部数据到XLSX导出已选中数据到XLSX导出全部数据到jsonl导出
- [评估器介绍](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0034.md): 在评估过程中，评估器扮演着“裁判”的角色，通过量化分析Agent输出结果的准确性，或数据集本身质量。在启动评估任务前，必须配置合适的评估器。本章节将详细介绍评估器的概念、类型及评估规则，帮助您在智能体平台中高效创建与管理评估器。评估器是一种自动化或半自动化的评估工具，能够依据预设的规则对Agent的输出进行多维度分析，生成可量化的评估结果
- [创建模型判定评估器](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0035.md): 使用和调试评估器时会产生模型调用费用，具体计费请参考MaaS模型即服务价格。已开通AgentArts服务。已配置模型鉴权，配置模型鉴权请参考设置模型鉴权。发布完成后，在评估器列表页面即可查看已发布的评估器。建议将轨迹类的多轮对话评估器用于在线评估任务。由于轨迹数据手动构造难度较大，在线评估时系统将自动从调用链中提取变量值，无需手动构造。发
- [创建自适应判定评估器](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0130.md): 自适应判定评估器旨在降低评估器的编写门槛。与模型判定评估器需要编写复杂的Prompt不同，自适应判定评估器仅需输入自然语言规则描述，系统即可自动将其转化为结构化的评估步骤。适用于非技术运营人员快速构建评估标准，或对评估逻辑要求相对简单、无需精细控制Prompt的场景。使用和调试评估器时会产生模型调用费用，具体计费请参考MaaS模型即服务价
- [维护评估器](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0036.md): 为了适应业务需求的不断演进以及评估策略的持续优化，AgentArts平台提供了完善的评估器管理能力，支持对评估器进行全生命周期的维护。本章节将详细介绍评估器的管理操作，主要包括以下功能：发布成功后，评估器列表中该评估器的最新版本号将更新为最新发布的版本号。提交新版本版本格式为a.b.c，其中每段数字的范围为0-999。同一个评估器发布的版
- [预置评估器概览](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0040.md): AgentArts智能体平台提供了丰富的预置评估器，用于智能体和工作流的质量评估。这些评估器根据不同的使用场景和评估需求进行了分类，支持离线评估、在线评估或同时支持两者。用户可根据具体的评估目标和数据来源选择合适的评估器，确保评估结果的准确性和有效性。离线评估：在应用上线前，使用预设的评测集对智能体进行效果测试。在线评估：应用上线后，系统
- [正确性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0042.md): 正确性评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好input（用户问题）和reference_output（标准参考答案）。评估时平台会自动将智能体的实际输出填入agent_output，三项数据共同传入评估Prompt进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [AI味检查](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0043.md): AI味检查评估器评估器参数说明：输入格式示例：输出格式示例：
- [任务完成度](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0044.md): 任务完成度评估器评估器参数说明：输入格式示例：输出格式示例：
- [轨迹质量](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0045.md): 轨迹质量评估器评估器参数说明：输入格式示例：输出格式示例：
- [不敏感性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0046.md): 不敏感性评估器评估器参数说明：输入格式示例：输出格式示例：
- [争议性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0047.md): 争议性评估器评估器参数说明：输入格式示例：输出格式示例：
- [创意性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0048.md): 创意性评估器评估器参数说明：输入格式示例：输出格式示例：
- [参考答案遵从度](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0049.md): 参考答案遵从度评估器评估器参数说明：输入格式示例：输出格式示例：
- [工具参数正确性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0050.md): 工具参数正确性评估器评估器参数说明：输入格式示例：输出格式示例：
- [工具选择质量](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0051.md): 工具选择质量评估器评估器参数说明：输入格式示例：输出格式示例：
- [幻觉现象](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0052.md): 幻觉现象评估器评估器参数说明：输入格式示例：输出格式示例：
- [性别歧视](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0053.md): 性别歧视评估器评估器参数说明：输入格式示例：输出格式示例：
- [恶意性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0054.md): 恶意性评估器评估器参数说明：输入格式示例：输出格式示例：
- [指令遵从度](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0055.md): 指令遵从度评估器评估器参数说明：输入格式示例：输出格式示例：
- [拒答检测](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0056.md): 拒答检测评估器评估器参数说明：输入格式示例：输出格式示例：
- [格式检查](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0057.md): 格式检查评估器评估器参数说明：输入格式示例：输出格式示例：
- [语种一致性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0058.md): 语种一致性评估器评估器参数说明：输入格式示例：输出格式示例：
- [文本可用性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0059.md): 文本可用性评估器评估器参数说明：输入格式示例：输出格式示例：
- [安全风险漏放](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0060.md): 安全风险漏放评估器评估器参数说明：输入格式示例：输出格式示例：
- [有害性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0061.md): 有害性评估器评估器参数说明：输入格式示例：输出格式示例：
- [有用性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0062.md): 有用性评估器评估器参数说明：输入格式示例：输出格式示例：
- [深度性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0063.md): 深度性评估器评估器参数说明：输入格式示例：输出格式示例：
- [犯罪性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0064.md): 犯罪性评估器评估器参数说明：输入格式示例：输出格式示例：
- [引用相关性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0065.md): 引用相关性评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-指令遵循](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0066.md): 知识问答-指令遵循评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-真实准确](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0067.md): 知识问答-真实准确评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-精炼性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0068.md): 知识问答-精炼性评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-便捷性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0069.md): 知识问答-便捷性评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-丰富度](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0070.md): 知识问答-丰富度评估器评估器参数说明：输入格式示例：输出格式示例：
- [简洁性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0071.md): 简洁性评估器评估器参数说明：输入格式示例：输出格式示例：
- [细节丰富度](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0072.md): 细节丰富度评估器评估器参数说明：输入格式示例：输出格式示例：
- [轨迹-工具参数填充正确性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0073.md): 轨迹-工具参数填充正确性评估器评估器参数说明：输入格式示例：输出格式示例：
- [轮次相关性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0074.md): 轮次相关性评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识保持](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0075.md): 知识保持评估器评估器参数说明：输入格式示例：输出格式示例：
- [对话完整性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0076.md): 对话完整性评估器评估器参数说明：输入格式示例：输出格式示例：
- [主题遵从](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0120.md): 主题遵从评估器评估器参数说明：输入格式示例：输出格式示例：
- [角色遵从](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0121.md): 角色遵从评估器评估器参数说明：输入格式示例：输出格式示例：
- [角色违规](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0134.md): 角色违规评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好input（用户输入，包含角色设定和对话内容）和actual_output（模型实际输出）。评估时平台会自动将数据传入评估Prompt进行评分，判断模型输出是否违背了设定的角色身份。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [Skill完整度](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0135.md): Skill完整度评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好skill_package（JSON字符串，包含skill_name、skill_manifest、instruction_body、task_description）。评估时平台会自动将数据传入评估Prompt，从步骤完整性、输入输出定义、前置条件和
- [Skill相关性](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0136.md): Skill相关性评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好skill_package（JSON字符串，包含skill_name、skill_manifest、instruction_body、task_description）。评估时平台会自动将数据传入评估Prompt，从能力覆盖度、能力精确度和能力冗余度三
- [Skill威胁分析](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0137.md): Skill威胁分析评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好skill_package（JSON字符串，包含skill_name、skill_manifest、instruction_body、task_description）。评估时平台会自动将数据传入评估Prompt，使用AITech分类体系检测Skil
- [Skill声明对齐](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0138.md): Skill声明对齐评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好skill_package（JSON字符串，包含skill_name、skill_manifest、instruction_body、task_description）。评估时平台会自动将数据传入评估Prompt，检测SKILL.md声明与实际脚本行
- [Skill设计质量](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0139.md): Skill设计质量评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好skill_package（JSON字符串，包含skill_name、skill_manifest、instruction_body、task_description）。评估时平台会自动将数据传入评估Prompt，从知识增量、思维模式、规范合规性、渐
- [Rubric评估](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0140.md): Rubric评估评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好input（用户输入）和actual_output（智能体实际输出）。rubric_set（用户自定义的评分准则）为可选参数，如果不传则平台会根据输入内容自动生成评分准则。评估时平台会自动将数据传入评估Prompt，严格按照评分准则中定义的维度、等级和
- [文本等值判断](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0077.md): 文本等值判断评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好reference_output（标准参考答案）。评估时平台会自动将智能体的实际输出填入actual_output，两项数据共同传入评估器进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [文本包含判断](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0078.md): 文本包含判断评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好reference_output（标准参考答案）。评估时平台会自动将智能体的实际输出填入actual_output，两项数据共同传入评估器进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [文本正则匹配](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0079.md): 文本正则匹配评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好reference_output（标准参考答案）。评估时平台会自动将智能体的实际输出填入actual_output，两项数据共同传入评估器进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [文本起始子串判断](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0080.md): 文本起始子串判断评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好reference_output（预设的起始子串）。评估时平台会自动将智能体的实际输出填入actual_output，两项数据共同传入评估器进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [文本JSON格式校验](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0081.md): 文本JSON格式校验评估器评估器参数说明：评估时平台会自动将智能体的实际输出填入actual_output，传入评估器进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [数学表达式相等判断](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0082.md): 数学表达式相等判断评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好reference_output（标准参考答案）。评估时平台会自动将智能体的实际输出填入actual_output，两项数据共同传入评估器进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [JSON相等判断](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0083.md): JSON相等判断评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好actual_output（实际JSON对象）和reference_output（参考JSON对象）。评估时平台会自动将智能体的实际输出填入actual_output，几项数据共同传入评估器进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例
- [创建离线评估任务](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0086.md): 评估任务旨在对智能体或工作流的回复质量进行多维度综合评估。该过程通过评测集、评估对象与评估器的协同工作来实现：评测集：提供输入对话数据，驱动智能体或工作流生成实际回复。评估器：依据设定的评估规则，将实际回复与评测集中的预期输出进行比对。最终生成的评分结果将量化反映智能体在准确性、安全性、流畅性等方面的综合表现。如果需评估特定智能体版本的质
- [创建在线评估任务](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0087.md): 应用上线运行后，会持续上报大量的调用链数据。如果采用传统的离线评测方式，往往需要经历繁琐的数据回流、导出与清洗过程，不仅操作链路长，且难以快速响应业务验证需求。AgentArts平台提供了高效的在线评估能力，支持对指定时间范围内的调用链数据进行自动拉取与评估。该功能打破了离线评测的局限，实现了数据采集的自动化闭环。已开通AgentArts
- [维护评估任务](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0088.md): 评估任务创建后，在“评估任务”界面，您可以通过属性筛选或关键字搜索来查找评估任务。删除评估任务后，将永久删除该任务及其评估结果数据，且不可恢复。请谨慎操作。删除成功后，该任务将从评估任务列表中移除。删除评估任务当您需要基于历史任务的配置快速创建新的评估任务时，可以使用克隆功能。仅运行中的评估任务支持终止操作，终止后任务将立即停止且无法恢复
- [查看评估结果](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0089.md): 已开通AgentArts服务。评估结果页面是评估任务执行结果的详细视图，旨在帮助您从宏观统计深入到微观案例，进行深度复盘。数据分析该页面涵盖了从输入到评估的完整过程。您不仅可以查看原始输入、智能体实际输出和设定的预期输出，还能获取评估器给出的具体得分以及详细的评分理由。通过直观对比“实际输出”与“预期输出”，您可以快速判断智能体的回答质量
- [对比评估任务结果](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0131.md): 在智能体的开发与迭代过程中（如调整Prompt指令、更换底层模型或增删工具插件），单次评估结果往往无法直观回答核心诉求：新版本真的比旧版本更好吗？优化了A能力，是否导致了B能力的退化？为此，平台提供评估任务结果的对比功能，采用控制变量的实验思路，帮助您精准定位优化效果。在“对比报告”页签中，您可以全面、直观地查看对比评估任务的总览结果。页
- [标注评估结果](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0090.md): 在任务评估完成后，可对评估结果进行人工标注，以补充判断、提升结果的可解释性与实用性。通过标注，您可以：为每条评估结果添加定制化的标注（如“正确”“错误”“模糊”“不相关”等），明确其质量等级或问题类型。对异常或争议样本进行归类，便于后续分析与复盘。为模型优化、数据治理和报告撰写提供高质量的标注依据。在开始标注前，请先创建所需的标注。标注创
- [评估结果回流](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0091.md): 评估结果回流功能允许您将评估任务的执行结果回流到评测集中，实现评估数据的沉淀和复用。通过字段映射机制，确保数据结构的一致性和完整性。适用场景：数据迭代：将表现优秀的智能体回复沉淀为新的标准答案，扩充评测集。问题归档：将评分较低的问答对保存回评测集，便于后续针对性优化。结果留存：将评估结果作为评测集的扩展，用于后续分析或对比。例如：在完成一

## 最佳实践

- [AgentArts最佳实践汇总](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0001.md): 本文汇总了AgentArts常见场景的操作实践，为每个实践提供详细的方案介绍和操作指导，帮助您深入了解AgentArts的功能。
- [一键为AgentArts接入模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0094.md): AgentArts支持一键接入华为云MaaS服务的模型，并提供200万Tokens的免费额度。免费额度用完后，如果需要继续使用华为云MaaS服务提供的模型，需要配置模型API Key，该操作请参考接入华为云MaaS服务付费模型。重要提示：开通AgentArts后，平台默认提供2,000,000Tokens的免费使用额度，无需额外配置，可用
- [接入华为云MaaS服务付费模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0095.md): 当您在AgentArts上用完了200万免费Tokens，或通过API接口调用智能体时，就需要接入华为云MaaS服务的付费模型。只需简单几步即可完成该操作：开通模型服务和配置API Key鉴权。本文将逐步指导您完成。以下任一情况出现时，就需要完成MaaS付费模型接入：在MaaS服务创建模型API Key时，权限范围选择“全部”便于访问全部
- [接入和使用DeepSeek模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0005.md): AgentArts支持接入兼容OpenAI接口规范的第三方大语言模型。本实践以自定义接入和使用DeepSeek模型为例，指导您完成从获取API密钥、接入自定义模型到创建问答助手智能体的完整流程。完成本实践后，您将获得一个基于DeepSeek大模型的问答助手智能体，并可参考相同流程接入其他兼容OpenAI接口的第三方模型（如Moonshot
- [手动接入和使用OpenAI协议模型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0096.md): 当您需要使用AgentArts平台未预置的模型，或者使用自建部署的模型服务时，就需要通过“自定义模型”方式接入。AgentArts支持接入兼容OpenAI接口规范的第三方大语言模型。本实践以GLM模型为例，指导您完成从获取API密钥到接入自定义模型的操作。平台中预置的模型，可以在AgentArts智能体平台“资产广场”中查看。如果平台预置
- [认识插件及类型](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0058.md): 在 AgentArts智能体中，插件是大语言模型（LLM）与外部世界交互的工具。尽管LLM具备强大的自然语言处理与推理能力，但其本质是基于训练数据的静态系统，存在两大核心局限：信息滞后：无法获取训练截止日期之后的实时信息。行动力缺失：无法直接与外部软件或硬件系统交互，如读写数据库、调用第三方服务、触发业务流程等。插件的引入弥补了上述缺陷，
- [插件创建方法](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0059.md): 在AgentArts中创建一个完整的自定义插件，需要依次完成插件和工具的创建。其中插件负责定义连接目标与鉴权方式，工具负责定义具体的接口与参数，二者共同构成一个可被智能体调用的完整插件能力。在 AgentArts 中，插件和工具是“集合”与“个体”的关系：插件：是一个功能集合，定义了一组工具共用的基础属性，包括服务域名、基准路径和鉴权方式
- [示例：创建联网搜索插件](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_05_0124.md): 本示例将介绍如何通过AgentArts智能体平台创建联网搜索插件，并进行插件的调试、发布，最终应用到Agent中。已开通AgentArts服务。本示例使用联网搜索API实现联网搜索功能，其API接口调用示例如下。请提前创建API Key，获取到的API Key用于替换下方代码中的<AppBuilder API Key>。调用该接口可能会产
- [搭建文件解析工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0191.md): 大模型本身不具备直接读取和解析文件的能力，无法处理文件字节流等原始数据。为弥补这一限制，支持工具调用（Function Calling）的模型可以通过插件接入外部工具API，从而拓展能力边界。资产中心提供了丰富的插件，例如文件解析插件能够将指定链接对应的文件内容解析为纯文本，供大模型进一步理解和处理。本文将演示如何在工作流中配置文件解析插
- [搭建数据格式转换工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0192.md): 企业日常运营中经常需要处理CRM、ERP等系统导出的JSON或CSV格式业务数据。这类数据包含大量重复的计算和清洗工作（如汇总销售额、筛选有效订单、按区域分组统计等），大模型虽然擅长文本理解和表达，但不适合进行精确的数学计算和复杂的数据操作。为弥补这一不足，可以在工作流中引入代码节点，利用其执行Python或Node.js代码的能力来处理
- [搭建识别用户意图工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0194.md): 意图识别是指通过大模型准确理解并判断用户表达的真实目的。尽管大语言模型具备强大的自然语言处理能力，但在面对复杂多变的用户指令时，如果仅依靠单一的提示词进行回复，往往会导致响应不够精准、任务处理混淆等问题；而依靠人工去逐一判断和分发任务，不仅效率低下，也难以实现自动化的工程落地。为弥补这一不足，可以借助AgentArts低代码工作流的流程定
- [搭建图像理解工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0200.md): 大语言模型在文本理解与生成方面表现优异，但面对图片、截图、文档扫描件等视觉信息时，单纯依靠文本交互无法完成对图像内容的提取与分析。如果用户仅凭手动描述图片内容再交给模型处理，不仅耗时费力，还容易遗漏关键细节，导致理解结果不完整或不准确；而在实际业务场景中，如证件信息提取、图表数据解读、产品质检图片审核等，图像理解的需求却日益频繁且对准确度
- [使用API调用单/多智能体](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0021.md): 在AgentArts平台上开发完成智能体后，其最终目的是要融入企业的核心业务流中。为了实现上述集成，AgentArts提供了标准的RESTful API。完整的调用架构分为两步：认证鉴权：在AgentArts平台获取鉴权参数Authorization（新版AgentArts部署区域为西南-贵阳一，使用Authorization参数鉴权，而
- [使用API调用工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0022.md): 在AgentArts平台上开发完成工作流后，其最终目的是要融入企业的核心业务流中。为了实现上述集成，AgentArts提供了标准的RESTful API。完整的调用架构分为两步：认证鉴权：在AgentArts平台获取鉴权参数Authorization（新版AgentArts部署区域为西南-贵阳一，使用Authorization参数鉴权，而
- [使用API调用图像理解工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0134.md): 本案例中搭建一个图像理解工作流，实现通过多模态模型进行图像识别，并通过标准的RESTful API进行调用。工作流部署时采用API Key认证，API调用也采用该方法。图像理解工作流的搭建、参数配置和文本类工作流存在差异，详见步骤一：搭建图像理解工作流。使用API调用图像理解工作流时，图片约束如下：上传格式：.png、.jpg、.jpeg
- [使用API调用文档解析智能体](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0135.md): 在AgentArts平台上开发单智能体时，部分业务场景需要智能体具备文档理解能力，例如：合同审核场景中智能体需读取用户上传的合同文件并提取关键条款；技术文档分析场景中需对产品手册、接口文档进行结构化解析；报告生成场景中需先读取参考文档再进行内容总结。文档理解能力依赖智能体中挂载的文档解析插件或MCP实现。用户上传文档后，插件先完成文档解析
- [使用API调用文档解析工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0136.md): 在AgentArts平台上开发工作流时，部分业务场景需要工作流具备文档理解能力，例如：合同审核场景中需读取用户上传的合同文件并提取关键条款。文档理解能力依赖工作流中的插件节点、MCP节点或代码节点等方式实现。工作流支持在开始节点定义File或Array<File>类型的文档参数，单文档时使用File类型；多文档时使用Array<File>
- [使用API调用单/多智能体（IAM认证）](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0025.md): 本案例介绍如何通过IAM认证（AK/SK签名）的方式，调用智能体的API接口。与API Key认证的主要区别：IAM认证使用您华为云账号的访问密钥（AK/SK）进行请求签名，无需在平台单独管理API Key，更适合企业级应用集成场景，权限管控由统一的IAM服务管理。根据华为云API网关（APIG）与AgentArts平台的认证鉴权规范，智
- [使用API调用观测/评估/沙箱/网关/记忆库/运行时接口](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0024.md): 此类接口与单/多智能体、工作流的调用方式有所差异。认证鉴权信息中的Authorization、X-Sdk-Date的值需要通过一个API签名SDK获取。这类接口的域名地址为：agentarts.cn-southwest-2.myhuaweicloud.com接口Header由三个参数构成：Authorization、X-Sdk-Date、
- [常见问题](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0023.md): 调用API时出现{"code":401,"data":null,"message":"Authorization failed!"}报错，表示Authorization失效，请重新获取。调用智能体/工作流接口：请参考步骤二：获取API调用凭证（获取Authorization）重新获取Authorization。调用观测/评估/沙箱/网关等
- [智能体评估方法](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0089.md): 在智能体开发的早期，最常见的做法是“开发-预览-发布”模式：开发者编写好提示词（Prompt），挂载了知识库和各类工具，在预览聊天框中手动输入5~10个典型问题。如果AI回答得不错，便认为开发完成，直接发布上线。然而对于面对真实业务场景、需要长期稳定运行的智能体而言，这种“抽样聊天”的人工测试存在致命的局限性，往往很快就会遇到这些崩溃时刻
- [评测集设计实践](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0090.md): 在智能体评估体系中，评测集就是发给智能体的那份“考卷”。如果随便导入几十条日常聊天的问答对作为评测集，那么无论评估器多么先进，最终得出的高分也毫无参考价值。高质量的评测集设计不仅要求“考题覆盖全面”，更要求“数据结构精准对齐评估器”。不同的评估器（如幻觉检测、工具参数校验）需要截然不同的上下文背景作为输入。因此，设计评测集的第一步是明确您
- [评估器最优组合实践](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0091.md): 在AgentArts平台中预置了40+不同维度的评估器，很多新手开发者在发起评估任务时往往会犯“选择困难症”，最后为了省事挑选一个最基础的“正确性”评估器。看到评估满分时，即认为智能体已经满足了上线条件。但在真实的业务投产中，往往会面临：回答风格不符：智能体给出的答案确实“正确”，但是内容生硬，排版结构混乱。答案对，但过程错误：订票智能体
- [企业知识问答助手（RAG）智能体评估](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0092.md): 在企业级AI落地中，RAG（检索增强生成）智能体是最普遍、也是最容易让开发者“翻车”的场景。很多开发者随手问了几个文档里的问题，看着回答流畅就直接发布上线了。RAG智能体虽然解决了大模型知识滞后的问题，但引入了新的复杂性。真实的生产环境充满了不可控的边缘场景。缺乏系统性评估的RAG智能体，往往面临着：幻觉：当询问知识库中没有的信息时，或者
- [复杂工具调用智能体评估](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0093.md): 在企业级AI落地中，具备工具调用能力的智能体是大模型执行复杂业务逻辑的核心组件。无论是联网搜索、查询新闻，还是查询数据库，它们都需要自主进行多步推理并调用外部工具实现对应的能力。然而，对于包含工具调用的智能体，传统的“测试智能体回答结果”的测试方法无法有效验证其底层逻辑的正确性。缺乏全链路评估的智能体，频繁面临以下异常场景：工具错配（选错
- [Skill（技能）观测数据上报](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0037.md): 当智能体引入Skill（技能）能力后，Skill的运行状态往往是影响整体体验的关键环节。常见的线上问题包括：某个Skill加载变慢拖累了整体响应、Skill频繁执行失败但没有告警、Skill内容过长导致Token成本异常攀升。由于Skill的调用过程嵌套在智能体链路内部，这些问题在没有专项观测的情况下很难被发现和定位。通过将Skill的调
- [手动搭建智能客服智能体](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0008.md): 智能客服智能体可以自动响应并自动处理用户咨询，提高客户满意度和运营效率。本文将帮助您在AgentArts中搭建一个智能客服智能体应用，提供全天候的在线咨询服务。向智能体输入问题时，智能体会自动解析问题内容，理解其核心需求，并生成相应的解决方案。智能体会利用其内部的模型和技能，结合问题的上下文信息，确保提供的解决方案既准确又高效。例如输入“
- [搭建知识问答助手工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0010.md): 知识问答助手对话流，支持用户与助手进行日常对话，分享心情、趣事等。用户在遇到压力或情绪问题时，与助手进行交流，获得安慰和建议。还可以针对自己感兴趣的学科进行知识问答游戏、咨询和提问。本实践将详细介绍如何利用意图识别节点、提问器节点、大模型节点、判断节点、消息节点和变量聚合节点等搭建一个问答助手工作流。和知识问答助手进行互动时，问答助手可以
- [搭建知识问答助手工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0011.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用DeepSeek-V4-Flash模型。在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除等操作。开始和结束节点为必选节点，不支持重命名、复制和删除。单击“开始”节点，该节点已默认配置query参数，表示用户
- [创建语文知识库](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0003.md): 知识库是一个组织、存储及管理知识的系统，包括文档、图表、表格等多种形式信息的分类、整理和归纳，可以帮助用户高效管理大量信息。平台为用户提供了创建并管理知识库的能力，且创建的知识库可在工作流和Agent中调用。对于需要处理大量问答知识、对检索效率有较高要求的场景，通过创建知识库组织和管理信息，可以提升信息获取效率。本实践以创建语文知识库为例
- [搭建辅助批改作业工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0014.md): 在教育技术不断进步的今天，辅助批改作业提供“自动批改+详细解析+个性化反馈”的全流程支持，成为学生作业批改的高效助手。这种技术驱动的批改方式旨在减轻教师的工作负担，同时为学生提供即时准确的反馈，帮助他们更好地理解和掌握知识。本实践将详细介绍如何利用大模型节点、消息节点搭建一个辅助批改作业的工作流。向辅助批改作业提问时，该工作流应用能提供答
- [搭建辅助批改作业工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0015.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用DeepSeek-V4-Flash模型。在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制和删除。删除“大模型”节点和“结束”节点的连线。单击添加节点，选择消
- [搭建智能助教工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0017.md): 在教育数字化与 "双减" 背景下，智能助教助手以知识图谱 + 自然语言处理技术，化身语文学习全场景伙伴，提供即时问答 + 分层解析 + 情境拓展陪伴链。它以技术驱动个性化学习，让每个学生拥有专属语文空间，通过智能技术引导学生探索语言的魅力，同时加深对中国文化的理解。本实践将详细介绍如何利用不同的节点搭建一个语文知识智能助教的工作流，通过该
- [搭建智能助教工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0018.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用平台预置的DeepSeek-V4-Flash模型。搭建助教工作流前须完成语文知识库创建，详见创建语文知识库。在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制
- [附录](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0019.md): 本章节提供的语文知识库仅供参考。如需使用，请手动复制到Word文档中。用户可根据实际情况自定义知识库。第一部分：基础知识 1. 下列词语中，字形和加点字的读音全部正确的一项是（） A. 确凿 (záo) 蝉蜕 (tuì) 人声鼎沸 来势凶凶 B. 骊歌 (lí) 木屐 (jī) 荒草萋萋 人迹罕至 C. 嫉妒 (jì) 澎湃 (pà
- [方案概述](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0139.md): 在金融科技不断发展的今天，手机银行助手提供“转账汇款+智能客服问答”的全流程支持，是用户日常金融管理的高效工具。多智能体应用专为复杂、多任务场景设计，其核心优势在于灵活的工作流调度：系统根据用户意图动态选择并切换工作流，实现任务的精准拆解与高效执行，有效解决单智能体提示词冗长、插件过多导致的调试困难和结果不可控等问题。在手机银行助手场景中
- [安装天眼查MCP服务](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0142.md): 在手机银行助手应用的转账汇款工作流中，由于涉及查询企业信息，因此需要安装天眼查MCP服务，以便后续在搭建转账汇款工作流中调用。已实名认证的华为账号或IAM用户。已开通AgentArts服务。MCP服务参数说明参数示例说明选择类型选择类型：HTTP配置方式：表单编辑。URL：https://mcp.tianyancha.com/v1选择安装
- [搭建转账汇款工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0143.md): 该工作流根据用户输入的账号信息执行转账汇款；如果收款方为企业，转账成功后自动展示转账通知邮件已发送的消息。创建转账汇款工作流：开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的转账汇款等信息。语音输入时，须在工作流全局配置节点开启“语音交互”功能。提问器节点-获取收款人信息：该节点从用户输入
- [子场景2：搭建智能客服问答工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0144.md): 该工作流主要实现智能问答，自动识别、理解和回答客户问题。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的客服问答等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。判断节点：该节点根据不同的条件连接多个后续分支，并按照判断结果运行到相应的分支节点。消息节点-投资期限：该节点用于
- [主智能体场景：搭建手机银行助手多智能体应用](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0145.md): 已完成子场景1：搭建转账汇款工作流。已完成子场景2：搭建智能客服问答工作流。创建后，进入“多智能体配置”页面，初始只有一个“多Agent控制器”节点。创建的多智能体应用显示在多智能体应用卡片列表中。在“多Agent控制器”卡片上，单击鼠标左键，在弹出的页面配置参数信息，多Agent控制器参数说明请参考图2和表2。检查节点设置是否有误，常见
- [搭建病历生成助手工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0032.md): 当前医生面临门诊量大、问诊时间有限、病历书写负担重等挑战，为提升诊疗效率与病历质量，降低医疗误差，我们搭建一款能够实时理解医患对话、自动生成“一诉五史”（主诉、现病史、既往史、个人史、家族史、过敏史）、关键查体要点及初步诊断的智能辅助系统，从而优化诊疗流程，提升医疗服务质量。本实践将详细介绍如何利用大模型节点，搭建病历生成助手。在与病历生
- [搭建病历生成助手工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0033.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用DeepSeek-V4-Flash模型。本章节主要介绍如何在工作流编排页面配置生成一诉五史、生成查体、生成诊断大模型以及结束节点，以形成一个完整的工作流应用。平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除操作，开始和结束节
- [方案概述](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0045.md): 茶叶销售公司希望通过AI智能体推广其茶叶产品。公司提供的茶叶产品有三种类别（productmodel），分别是红茶、绿茶和普洱茶。每个品类又细分为普通、高级和奢华三个等级（class）。每个品类和等级根据当前价格有不同的优惠比例（voucher），而整体价格计算则需根据提供的相应数量件数（count）。用户诉求：能够根据用户提供的数量、类
- [创建茶叶产品介绍知识库](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0048.md): 搭建茶叶销售助手前，需要先创建关于茶叶的知识库。已实名认证的华为账号或IAM用户。已开通AgentArts服务。准备需要上传的知识素材，本实践使用的知识库请参见茶叶产品介绍.docx，仅供参考。创建并上传：进入“创建知识库”的“上传文档”页面，为知识库添加文档信息，具体操作请参考上传文档。立即创建：页面返回知识库列表。当上传的文档由“上传
- [搭建产品介绍工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0049.md): 该工作流能够根据客户的产品查询需求，提供准确的产品类别和产品描述。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的产品咨询/客服问答等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。大模型节点：该节点将从用户输入中提取并解析问题，并用JSON格式输出。知识检索节点：该节点从预
- [搭建产品筛选工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0051.md): 该工作流能够根据用户提供的数量、类别、等级和优惠比例要求进行产品筛选。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的产品采购等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。提问器节点：该节点负责从用户输入中提取用户需要购买的茶叶类别、等级、数量以及优惠比例等信息。结束节点
- [搭建产品结算工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0052.md): 该工作流能够根据用户提供的数量、类别、等级和优惠比例进行汇总计算价格。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的产品采购等信息，并提取用户需要购买的茶叶类别、等级、数量以及优惠比例等信息。语音输入时，须在工作流全局配置节点开启“语音交互”功能。大模型节点：该节点将根据客户选择的产品类
- [搭建产品采购工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0053.md): 该工作流能够根据用户提供的数量、类别、等级和优惠比例要求进行产品筛选，并汇总计算筛选结果的价格。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的产品采购等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。工作流节点-产品筛选：该节点添加产品筛选工作流，用于提取产品信息，包括产品
- [子场景3：客服支持](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0054.md): 该工作流能够及时响应客户对产品的投诉和服务支持。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的客服问答等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。提问器节点：该节点负责从用户输入中提取用户问题。意图识别节点：该节点负责判断用户输入的问题属于服务支持类还是投诉类，并根据
- [主智能体场景：搭建茶叶销售多智能体应用](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0055.md): 通过在多智能体中配置产品介绍、产品采购和客服支持工作流，支持根据用户意图在不同工作流中进行选择和跳转，灵活满足客户业务诉求。已完成子场景1：产品介绍。已完成子场景2：产品采购。已完成子场景3：客服支持。本实践选用平台预置的DeepSeek-V4-Flash模型。创建后，进入“多智能体配置”页面，初始只有一个“多Agent控制器”节点。创建
- [概述](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0197.md): AgentArts是一个企业级智能体平台，打破了传统开发壁垒，支持Agent开发人员通过可视化、低代码的方式，快速搭建从简单助手到复杂业务流的各类AI应用。在这个平台上，知识库功能是最核心的企业私有知识接入能力之一，它解决了大语言模型（LLM）一个本质性的短板：模型的知识边界被锁定在训练数据中，无法感知企业内部文档、私有数据或训练截止后的
- [RAG技术原理](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0198.md): 要理解为什么源文档质量会影响RAG效果，必须先理解大模型的工作方式，以及AgentArts知识库在整个RAG链路中扮演的角色。大语言模型（LLM）通过在海量文本数据上进行预训练，学习到了语言的语法结构、语义关联和丰富的世界知识。其核心技术基础是Transformer架构中的自注意力机制（Self-Attention），该机制允许模型在处理
- [影响RAG效果的因素](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0199.md): 知识库是组织、存储及管理知识的系统，涵盖文档、图片、表格等信息的分类整理，可以帮助用户高效管理大量的信息。然而在实际的企业RAG落地场景中，接入知识库的源文档往往来自已有的业务资料，这些文档最初是为人而编写的，并没有考虑AI检索系统的处理方式。以下六类常见问题会系统性地影响AgentArts知识库的检索效果与大模型的最终回答质量。企业内部
- [优化源文档写作规范](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0121.md): 源文档的写作质量是整个RAG链路中最基础、最直接可控的优化维度。知识库的技术能力再强，最终效果的上限仍由源文档本身的质量决定。结构混乱、语义模糊、冗余矛盾的文档，会让检索系统召回错误内容，进而导致大模型生成偏差甚至幻觉的回答。在不改动任何技术架构的前提下，系统性地优化源文档的写作与整理方式，是提升RAG应用效果性价比最高的手段。为文档设置
- [优化知识库配置](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0122.md): 在文档质量得到保障的前提下，AgentArts知识库的配置参数将直接决定文档的解析质量、切片精准度与最终检索效果。本节将介绍创建知识库时的核心配置、分段策略的选择与配置，以及在单智能体和工作流中的检索参数配置。当前AgentArts团队标准版、团队高级版、企业专业版、企业旗舰版未开放，如果需要购买，请提交工单咨询购买相关事宜。向量模型向量
- [通过智能体评估持续优化](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0123.md): 仅靠主观判断很难全面识别文档和配置问题，更难量化优化效果。AgentArts提供了完整的智能体评估功能，可以将智能体测试和调整工作从“凭经验改”升级为“用数据改”，形成可持续的优化闭环。相关实践案例请参考企业知识问答助手（RAG）智能体评估。评测集的质量直接决定评估能否真正暴露问题。在AgentArts中，RAG场景的评测集应包含以下核心
- [相关资源](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0124.md): 华为云AgentArts官方文档知识库相关知识库介绍知识库类型知识库使用限制创建知识库上传文档知识库命中测试知识库分段第三方知识库分类在智能体与工作流中使用知识库在单智能体中使用知识库在工作流中使用知识库最佳实践与评估企业知识问答助手（RAG）智能体评估评测集设计实践搭建知识库问答工作流
- [概述](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0126.md): 过去几年，我们已经习惯了与大模型进行对话（Chat）。但当你要求AI“策划一场旅行并订好机票”时，传统的对话模型只能给你一份攻略建议，而Agentic AI（智能体式AI）则能自主拆解目标、查询实时航班、对比价格，并在获得授权后完成下单。智能体式AI（Agentic AI）的兴起正在将人工智能的价值锚点从“被动响应”转移至“主动执行”。传
- [Agentic AI技术原理](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0127.md): 传统自动化工具（如RPA）基于静态规则或预定义脚本运行，适合重复性、低变化的结构化任务。Agentic AI的核心区别在于它能够在规则无法穷举的复杂场景中，依靠大模型的推理能力动态规划执行路径。Agentic AI并非一次性输出，而是运行在一个持续进化的流程中。根据行业共识，其核心运作机制包含以下四个支柱：反思与纠错：这是Agentic 
- [提示词编写技巧](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0129.md): 大语言模型的输出具有概率波动性，将智能体推向生产应用的首要难题，是在保持其灵活性的同时控制行为边界。AgentArts中提示词的编辑功能定义了智能体行为范围，通过合理的结构化提示词设计以及首句欢迎语的逻辑锚定，可以极大降低大模型输出不相关内容的风险。提示词编写技巧在开发任何企业级智能体（如合同审计、任务分流、技术问诊等）时，Prompt的
- [多智能体应用技巧](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0130.md): 单智能体能够应对大多数独立任务，但当业务场景涉及多个子流程、需要根据用户意图动态分流至不同专业处理逻辑时，单智能体面临的工程困境日渐凸显：提示词随业务迭代越写越长，工具挂载越堆越多，任何一处改动都可能引起连锁性的决策退化，且整体难以独立维护和精准调测。为解决这一问题，AgentArts提供了多智能体应用。其核心思路是引入一个中央控制器（多
- [高代码智能体开发与云端部署技巧](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0131.md): 在前两章中，提示词编写和多智能体编排均在AgentArts平台页面操作完成。但在企业真实落地场景中，大量团队已在本地基于LangChain、LangGraph等主流框架积累了成熟的Agent代码资产，这些代码无法直接粘贴进画布节点。AgentArts的高代码开发能力正是为解决这一问题而设计：开发者在本地用自己熟悉的框架写代码，通过标准化S
- [智能体效果评估与质量提升技巧](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0132.md): 传统软件的质量保障依赖确定性的测试用例，测试要么通过要么失败。但大模型的输出具有概率分布特性：同样的问题，两次回答可能用词不同但语义相同；更棘手的是，模型可能给出听起来合理但事实上完全错误的回答（幻觉）。这意味着传统的测试方法在智能体场景下不适用，不是因为智能体答错了，而是因为这种测试方式根本无法衡量语义质量。AgentArts的评估体系
- [相关资源](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0133.md): 华为云AgentArts官方文档提示词相关提示词介绍撰写提示词规范在单智能体中使用提示词在工作流中使用提示词高码开发智能体相关基础示例：创建基础对话智能体进阶示例：构建全能出行助手（集成模型/记忆/沙箱/网关/高德mcp）智能体评估相关评估介绍示例：快速完成一次智能体评估示例：基于离线任务进行评估

## API参考

- [使用前必读](https://support.huaweicloud.com/api-agentarts/agentarts_07_0001.md): 欢迎使用AgentArts服务。AgentArts是一个企业级一站式智能体构建与运营平台。它打破了传统开发壁垒，支持Agent开发人员通过可视化、低代码的方式，快速搭建从简单助手到复杂业务流的各类AI应用。您可以使用本文档提供API对AgentArts进行相关操作，如调用运行时等。支持的全部操作请参见API概览。在调用AgentArts 
- [API概览](https://support.huaweicloud.com/api-agentarts/agentarts_07_0002.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [构造请求](https://support.huaweicloud.com/api-agentarts/agentarts_07_0004.md): 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户接口说明如何调用API。请求URI由如下部分组成。{URI-scheme}:// {Endpoint} / {resource-path} ? {query-string}尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此
- [认证鉴权](https://support.huaweicloud.com/api-agentarts/agentarts_07_0005.md): 智能体在初次部署时，可以选择认证方式。再次调整智能体，重新进行部署时，认证方式无法进行修改。如果认证方式选择错误，目前需要重新创建一个新的智能体。可以使用智能体的“复制”功能快速创建同样的一个智能体。AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。AK（Access Key ID）：访问密
- [返回结果](https://support.huaweicloud.com/api-agentarts/agentarts_07_0006.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。对应请求消息头，响应同样也有消息头，如“Content-type”。对于“获取评测集列表”接口（GET
- [调用运行时 - InvokeRuntime](https://support.huaweicloud.com/api-agentarts/InvokeRuntime.md): 该接口用于运行场景化应用，支持在指定的智能体、工作流中执行。接口支持流式响应模式，可以根据需要返回增量执行结果，适用于实时交互场景。适用场景：在项目中运行预定义的工作流/智能体。在项目中运行预定义的工作流/智能体。支持调试模式和发布模式，适用于不同开发和生产环境。支持调试模式和发布模式，适用于不同开发和生产环境。支持流式响应，适用于需要实
- [将智能体信息同步至观测页面 - CreateOpsAgentObservation](https://support.huaweicloud.com/api-agentarts/CreateOpsAgentObservation.md): 通过此接口可以在观测页面查看该智能体上报的数据信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/observation/agents状态码：200状态码：400状态码：403状态码：500
- [将智能体信息在观测页面删除 - DeleteOpsAgentObservation](https://support.huaweicloud.com/api-agentarts/DeleteOpsAgentObservation.md): 删除智能体后在观测页面无法查看该智能体上报的信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/ops/observation/agents/{agent_id}无状态码：200删除成功。状态码
- [查询智能体列表 - ListOpsAgentObservation](https://support.huaweicloud.com/api-agentarts/ListOpsAgentObservation.md): 在观测页面查询智能体列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/agents无状态码：200状态码：400状态码：403状态码：500状态码：200参数解释：响
- [更新智能体信息 - UpdateOpsAgentObservation](https://support.huaweicloud.com/api-agentarts/UpdateOpsAgentObservation.md): 更新智能体信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/ops/observation/agents/{agent_id}状态码：200状态码：400状态码：403状态码：500状态码：400参
- [查询组件列表，包括工具，模型，skill列表 - ListOpsAgentMetricLabelValues](https://support.huaweicloud.com/api-agentarts/ListOpsAgentMetricLabelValues.md): 查询组件列表，包括工具，模型，skill列表。请参见如何调用API。当前API调用无需身份策略权限。POST /v1/ops/observation/agents/metric/label-values状态码：200状态码：400状态码：403状态码：500状态码：200参数解释：响应码，用于标识接口调用结果。取值范围：200表示成功，其
- [查询时间范围内智能体的总数、草稿数、发布态数 - ShowOpsAgentMetric](https://support.huaweicloud.com/api-agentarts/ShowOpsAgentMetric.md): 该接口用于查询指定时间范围内智能体（单智能体、工作流、多智能体）的总数、草稿数、发布态数。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/agents/metric无状态
- [查询指标趋势图 - ShowOpsAgentMetricTrend](https://support.huaweicloud.com/api-agentarts/ShowOpsAgentMetricTrend.md): 该接口用于查询智能体的指标趋势图。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/observation/agents/metric/trend状态码：200状态码：400状态码：403状态码
- [查询指标的topN - ShowOpsAgentMetricTopN](https://support.huaweicloud.com/api-agentarts/ShowOpsAgentMetricTopN.md): 该接口用于查询智能体指标的topN排行柱状图数据。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/observation/agents/metric/topn状态码：200状态码：400状态码
- [查询指标的数据 - ShowOpsAgentMetricGauge](https://support.huaweicloud.com/api-agentarts/ShowOpsAgentMetricGauge.md): 该接口用于查询智能体指标的数据信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/observation/agents/metric/gauge状态码：200状态码：400状态码：403状态
- [查询调用链span指标 - ListOpsAgentSpanMetric](https://support.huaweicloud.com/api-agentarts/ListOpsAgentSpanMetric.md): 该接口用于查询调用链详情页面中每个span的数据信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/agent/{agent_id}/span/{span_name}/
- [Trace数据标注 - TagOpsTraceLabel](https://support.huaweicloud.com/api-agentarts/TagOpsTraceLabel.md): 该接口用于给调用链数据进行数据标注。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/observation/traces/{trace_id}/label状态码：200状态码：400状态码：4
- [trace数据点赞、点踩 - UpdateOpsTraceFeedback](https://support.huaweicloud.com/api-agentarts/UpdateOpsTraceFeedback.md): 该接口用于给调用链数据进行评价(点赞/点踩)。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/ops/observation/traces/{trace_id}/feedback状态码：200状态码：4
- [查询trace列表 - ListOpsTrace](https://support.huaweicloud.com/api-agentarts/ListOpsTrace.md): 该接口用于分页查询调用链列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/observation/traces状态码：200状态码：400状态码：403状态码：500状态码：200参数解释
- [查询调用链详细信息 - ShowOpsTrace](https://support.huaweicloud.com/api-agentarts/ShowOpsTrace.md): 该接口用于查询调用链详细信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/traces/{trace_id}无状态码：200状态码：400状态码：403状态码：500
- [查询会话列表 - ListOpsSession](https://support.huaweicloud.com/api-agentarts/ListOpsSession.md): 该接口用于查询会话列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/observation/sessions状态码：200状态码：400状态码：403状态码：500状态码：200参数解释：
- [查询会话详情 - ShowOpsSession](https://support.huaweicloud.com/api-agentarts/ShowOpsSession.md): 该接口用于查询会话详情。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/sessions/{session_id}无状态码：200状态码：400状态码：403状态码：50
- [查询租户关联的AOM /APM /LTS信息 - ShowOpsSubscriptionInfo](https://support.huaweicloud.com/api-agentarts/ShowOpsSubscriptionInfo.md): 查询租户关联的AOM/APM/LTS信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/subscription无状态码：200状态码：400状态码：403状态码：50
- [查询租户关联的APM信息 - ShowOpsSubscriptionApmInfo](https://support.huaweicloud.com/api-agentarts/ShowOpsSubscriptionApmInfo.md): 该接口用于查询租户关联的APM信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/subscription/apm无状态码：200状态码：400状态码：403状态码：5
- [查询租户关联的AOM信息 - ShowOpsSubscriptionAomInfo](https://support.huaweicloud.com/api-agentarts/ShowOpsSubscriptionAomInfo.md): 该接口用于查询租户关联的AOM信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/subscription/aom无状态码：200状态码：400状态码：403状态码：5
- [查询租户关联的LTS信息 - ShowOpsSubscriptionLtsInfo](https://support.huaweicloud.com/api-agentarts/ShowOpsSubscriptionLtsInfo.md): 该接口用于查询租户关联的LTS信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/agents/{agent_id}/subscription/lts无状态码：200状
- [根据条件查询日志 - ListOpsAgentLog](https://support.huaweicloud.com/api-agentarts/ListOpsAgentLog.md): 该接口用于条件查询日志。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/agent/{agent_id}/log无状态码：200状态码：400状态码：403状态码：500
- [查询agentRun的日志 - ListOpsAgentRunLog](https://support.huaweicloud.com/api-agentarts/ListOpsAgentRunLog.md): 该接口用于查询agentRun的日志。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/observation/agent-run/{agent_run_id}/log无状态码：200状态码：40
- [查询合成的条目列表 - ListOpsSynthesisItems](https://support.huaweicloud.com/api-agentarts/ListOpsSynthesisItems.md): 该接口用于分页查询特定合成任务所生成的详细条目数据，支持在任务运行中和检索样本内容。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/datasets-synthesis/{synthesis_i
- [删除评测集合成任务 - DeleteOpsSynthesisTask](https://support.huaweicloud.com/api-agentarts/DeleteOpsSynthesisTask.md): 该接口用于删除指定的数据集合成任务，通过移除任务记录及其关联的临时数据，实现任务列表清理。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/ops/datasets-synthesis/{synth
- [导入结果到评测集 - ImportOpsResults](https://support.huaweicloud.com/api-agentarts/ImportOpsResults.md): 将条目导入到目标评测集，支持导入到现有评测集或创建新评测集。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/datasets/import状态码：200将条目导入到目标评测集状态码：200返回
- [批量删除评测集 - BatchDeleteOpsDatasets](https://support.huaweicloud.com/api-agentarts/BatchDeleteOpsDatasets.md): 该接口用于通过指定评测集ID列表批量删除不再使用的评测集资源，清理以释放存储空间。适用场景：资源清理：在业务周期结束或项目归档时，批量清理过时的测试数据。资源清理：在业务周期结束或项目归档时，批量清理过时的测试数据。批量操作：支持一次性处理多个ID，适用于批量删除。批量操作：支持一次性处理多个ID，适用于批量删除。请参见如何调用API。账
- [获取评测集列表 - ListOpsDatasets](https://support.huaweicloud.com/api-agentarts/ListOpsDatasets.md): 该接口用于分页查询当前项目下的评测集列表，支持按名称模糊检索和更新人筛选，帮助用户实现对评测集资产的全局视图管理。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/datasets无状态码：200
- [创建评测集 - CreateOpsDataset](https://support.huaweicloud.com/api-agentarts/CreateOpsDataset.md): 该接口用于创建结构化评测集，支持定义评测集的字段，为Agent的评估任务提供标准化的数据来源。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/datasets状态码：200创建一个结构化评测集
- [删除评测集 - DeleteOpsDataset](https://support.huaweicloud.com/api-agentarts/DeleteOpsDataset.md): 该接口用于通过指定评测集ID彻底删除评测集中的所有的数据条目、Schema定义和历史版本。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/ops/datasets/{dataset_id}无状态码
- [获取评测集详情 - ShowOpsDataset](https://support.huaweicloud.com/api-agentarts/ShowOpsDataset.md): 该接口用于根据评测集ID获取其完整的元数据配置，包括字段结构定义、基本属性及关联的历史发布版本列表。适用场景：评测配置校验：在启动评估任务前，开发者通过此接口确认评测集的字段是否符合评估任务输入要求。评测配置校验：在启动评估任务前，开发者通过此接口确认评测集的字段是否符合评估任务输入要求。版本回溯与管理：获取评测集下属的所有版本信息，以便
- [修改评测集 - UpdateOpsDataset](https://support.huaweicloud.com/api-agentarts/UpdateOpsDataset.md): 该接口用于更新现有评测集的名称和业务描述等信息，旨在确保资产信息的准确性与时效性，且操作不涉及对Schema字段定义的变更。适用场景：描述完善：在评测集创建后，补充更详细的业务背景、用途说明或标注说明。描述完善：在评测集创建后，补充更详细的业务背景、用途说明或标注说明。名称更改：根据业务需求变更或内部命名规范调整，修改评测集的显示名称。名
- [获取评测集 Schema - ListOpsDatasetSchemas](https://support.huaweicloud.com/api-agentarts/ListOpsDatasetSchemas.md): 该接口用于专门检索指定评测集信息，获取所有字段的名称、数据类型及约束规则，为数据处理提供标准的Schema视图。适用场景：数据导入校验：在用户上传或导入数据前，核对本地文件格式是否与评测集定义的字段规范一致。数据导入校验：在用户上传或导入数据前，核对本地文件格式是否与评测集定义的字段规范一致。请参见如何调用API。账号根用户具备所有API
- [批量删除评测集条目 - BatchDeleteOpsDatasetItems](https://support.huaweicloud.com/api-agentarts/BatchDeleteOpsDatasetItems.md): 该接口用于通过指定条目ID列表，从当前评测集的草稿版本中批量移除特定的数据行，实现对评测集内容的清理。适用场景：数据清洗：在数据导入后，批量剔除经人工或自动化检测识别出的错误数据、脏数据或重复样本。数据清洗：在数据导入后，批量剔除经人工或自动化检测识别出的错误数据、脏数据或重复样本。评测集优化：根据业务需求对现有的评测资源进行精简，移除测
- [获取评测集条目列表 - ListOpsDatasetItems](https://support.huaweicloud.com/api-agentarts/ListOpsDatasetItems.md): 该接口用于分页检索指定评测集的具体数据记录，支持查看当前草稿态数据或特定历史发布版本的数据样本。适用场景：内容预览：在评测集详情页分页展示具体的数据行，供用户直观核查数据质量。内容预览：在评测集详情页分页展示具体的数据行，供用户直观核查数据质量。版本溯源：通过指定版本ID，检索并对比历史发布版本中的样本数据。版本溯源：通过指定版本ID，检
- [批量添加评测集条目 - BatchCreateOpsDatasetItems](https://support.huaweicloud.com/api-agentarts/BatchCreateOpsDatasetItems.md): 该接口用于向指定评测集的草稿态批量注入数据行，支持增量添加、覆盖更新或基于历史版本还原数据，并强制校验数据与Schema的符合性。适用场景：数据初始化：在创建评测集后，通过API批量导入首批业务数据或基准测试集。数据初始化：在创建评测集后，通过API批量导入首批业务数据或基准测试集。版本回滚：当前草稿数据出现异常时，通过指定源版本ID将评
- [获取评测集条目详情 - ShowOpsDatasetItem](https://support.huaweicloud.com/api-agentarts/ShowOpsDatasetItem.md): 该接口用于精确获取评测集中某一行特定数据条目的完整内容，通过评测集ID与条目ID的双重定位。适用场景：单条样本核对：在对模型评测结果产生疑问时，调取对应原始数据条目的全量信息进行比对。单条样本核对：在对模型评测结果产生疑问时，调取对应原始数据条目的全量信息进行比对。数据编辑回显：在用户进入单条数据编辑界面前，通过此接口加载该条目的当前配置
- [更新评测集条目 - UpdateOpsDatasetItem](https://support.huaweicloud.com/api-agentarts/UpdateOpsDatasetItem.md): 该接口用于对指定评测集草稿版本中已存在的特定数据行进行修改，确保条目内容符合Schema结构校验。适用场景：样本内容完善：针对多轮对话或复杂数据集，补充缺失的字段信息或优化对话轮次逻辑。样本内容完善：针对多轮对话或复杂数据集，补充缺失的字段信息或优化对话轮次逻辑。业务数值更新：当底层业务逻辑变化导致原有的评测基准数据失效时，手动更新特定条
- [获取评测集版本列表 - ListOpsDatasetVersions](https://support.huaweicloud.com/api-agentarts/ListOpsDatasetVersions.md): 接口用于通过分页方式查询指定数据集下所有已成功发布的历史版本记录，按发布时间倒序排列，为用户提供数据集变更历史。适用场景：版本回溯：查看数据集的发布历史，追踪数据集随时间演进的变更记录。版本回溯：查看数据集的发布历史，追踪数据集随时间演进的变更记录。版本差异对比：获取不同版本的ID信息，以便后续调取详情接口进行内容或Schema的差异化分
- [发布评测集版本 - PublishOpsDatasetVersion](https://support.huaweicloud.com/api-agentarts/PublishOpsDatasetVersion.md): 该接口用于将当前处于草稿状态的数据内容固化，生成一个不可变的历史快照版本，并分配唯一版本ID以确保数据在后续调用中的可追溯性。适用场景：版本固化：在完成评测集条目的增删改等一系列调整后，通过发布版本将当前数据状态锁定。版本固化：在完成评测集条目的增删改等一系列调整后，通过发布版本将当前数据状态锁定。评测任务关联：为模型评测或训练任务提供一
- [删除评测集版本 - DeleteOpsDatasetVersion](https://support.huaweicloud.com/api-agentarts/DeleteOpsDatasetVersion.md): 该接口用于永久删除指定的评测集历史版本及其关联的所有条目快照数据。适用场景：合规性清理：根据数据保留政策或合规性要求，物理删除过期的、包含敏感信息的历史数据版本。合规性清理：根据数据保留政策或合规性要求，物理删除过期的、包含敏感信息的历史数据版本。删除冗余：在评测集生命周期后期，移除冗余的中间过程版本，保持资产列表的整洁。删除冗余：在评测
- [获取评测集版本详情 - ShowOpsDatasetVersion](https://support.huaweicloud.com/api-agentarts/ShowOpsDatasetVersion.md): 该接口用于通过指定版本ID检索特定历史版本的完整元数据，包含发布时的Schema结构快照、数据规模统计及版本属性。适用场景：历史版本对比：核对已发布评测集在特定时间点的字段定义、数据规模和配置参数。历史版本对比：核对已发布评测集在特定时间点的字段定义、数据规模和配置参数。变更差异分析：获取特定版本的结构化快照，以便与当前草稿态或其他历史版
- [评测集导入 - ImportOpsDatasetItems](https://support.huaweicloud.com/api-agentarts/ImportOpsDatasetItems.md): 该接口用于从本地文件或历史版本中将海量数据批量导入至指定评测集的草稿版本中，支持多种格式解析及灵活的写入模式。适用场景：评测集同步：将存储在OBS（对象存储服务）中的海量生产数据或标注数据自动化同步至评测系统。评测集同步：将存储在OBS（对象存储服务）中的海量生产数据或标注数据自动化同步至评测系统。评测集更替：利用全量覆盖模式（Overw
- [获取评测集导入任务列表 - ListOpsDatasetItemsImportTasks](https://support.huaweicloud.com/api-agentarts/ListOpsDatasetItemsImportTasks.md): 该接口用于分页查询指定评测集下所有异步导入任务的执行状态、实时进度及详细统计信息，支持通过任务ID进行精确过滤。适用场景：进度查看：在提交大规模数据导入请求后，实时跟踪任务的完成百分比与当前处理状态。进度查看：在提交大规模数据导入请求后，实时跟踪任务的完成百分比与当前处理状态。历史追溯：复盘评测集内容的来源、导入时间及各批次任务的执行结果
- [批量删除评测集合成任务 - BatchDeleteOpsSynthesisTasks](https://support.huaweicloud.com/api-agentarts/BatchDeleteOpsSynthesisTasks.md): 该接口用于通过指定任务ID列表集中清理多个评测集合成任务及其关联的历史记录。适用场景：环境清理：在完成大规模合成实验或多轮对比测试后，批量回收过期的测试任务以释放管理空间。环境清理：在完成大规模合成实验或多轮对比测试后，批量回收过期的测试任务以释放管理空间。任务删除：在后台管理系统中，支持用户通过勾选方式一次性销毁多个冗余的任务条目。任务
- [查询评测集合成任务列表 - ListOpsSynthesisTasks](https://support.huaweicloud.com/api-agentarts/ListOpsSynthesisTasks.md): 该接口用于分页查询当前租户下所有已提交的评测集合成异步任务，支持按任务名称、状态等多种过滤条件进行检索，提供任务执行进度。适用场景：任务进度查看：在发起大规模数据合成后，通过此接口批量获取任务的运行状态（如：进行中、已完成、已失败）。任务进度查看：在发起大规模数据合成后，通过此接口批量获取任务的运行状态（如：进行中、已完成、已失败）。历史
- [创建评测集合成任务 - CreateOpsSynthesisTask](https://support.huaweicloud.com/api-agentarts/CreateOpsSynthesisTask.md): 该接口用于利用大模型能力发起异步的数据合成任务，通过种子数据泛化（Seed-based Generalization）等手段自动生成高质量、多样化的训练或评测样本。适用场景：数据样本扩充：在现有数据量不足时，基于少量种子数据生成大规模同分布的模拟数据，提升模型训练效果。数据样本扩充：在现有数据量不足时，基于少量种子数据生成大规模同分布的模
- [查询评测集合成任务详情 - ShowOpsSynthesisTask](https://support.huaweicloud.com/api-agentarts/ShowOpsSynthesisTask.md): 该接口用于通过任务ID检索特定评测集合成任务的完整信息，涵盖任务配置快照、实时执行状态及生成统计。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/datasets-synthesis/{synt
- [更新评测集合成任务状态 - UpdateOpsSynthesisTask](https://support.huaweicloud.com/api-agentarts/UpdateOpsSynthesisTask.md): 该接口用于对指定的评测集合成任务执行生命周期状态控制，支持触发任务启动或手动中止执行。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/ops/datasets-synthesis/{synthesis_
- [批量删除评估器 - BatchDeleteOpsEvaluator](https://support.huaweicloud.com/api-agentarts/BatchDeleteOpsEvaluator.md): 该接口用于通过评估器ID列表批量移除不再使用的评估工具定义，适用场景：冗余清理：定期移除测试阶段产生的临时评估器或已过时的评价准则，保持评估器仓库的整洁。冗余清理：定期移除测试阶段产生的临时评估器或已过时的评价准则，保持评估器仓库的整洁。评价体系更迭：当业务评测标准发生重大调整，需要彻底废弃并清理旧版评估逻辑时使用。评价体系更迭：当业务评
- [新建评估器 - CreateOpsEvaluator](https://support.huaweicloud.com/api-agentarts/CreateOpsEvaluator.md): 该接口用于在系统中注册并创建一个新的评估器（Evaluator），通过定义具体的评估逻辑、判分准则及参数配置，为模型输出的质量度量提供标准化工具。适用场景：自定义评价体系构建：针对特定业务领域（如法律、医疗），创建符合行业规范的判分插件或规则脚本。自定义评价体系构建：针对特定业务领域（如法律、医疗），创建符合行业规范的判分插件或规则脚本。
- [获取评估器信息列表 - ListOpsEvaluators](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluators.md): 该接口用于分页查询当前租户下所有已注册的评估器信息，支持按名称、类型或创建时间进行过滤评估器。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/evaluators/list状态码：200查询当
- [删除单个评估器 - DeleteOpsEvaluator](https://support.huaweicloud.com/api-agentarts/DeleteOpsEvaluator.md): 该接口用于通过指定的评估器ID删除对应的评估工具定义，是从系统资产库中彻底移除单条评测标准的不可逆操作。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/ops/evaluators/{evalua
- [获取评估器信息 - ShowOpsEvaluator](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluator.md): 该接口用于通过指定的评估器ID检索其完整定义信息，包括判分逻辑、参数配置、关联模型及元数据详情，是核对特定评测标准执行细节的核心入口。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evalua
- [获取评估器所有版本信息 - ListOpsEvaluatorVersions](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluatorVersions.md): 该接口用于查询指定评估器下所有已发布的历史版本列表，提供各版本的发布时间、逻辑快照及版本状态。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluators/{evaluator_id}/
- [发布评估器新版本 - PublishOpsEvaluatorVersion](https://support.huaweicloud.com/api-agentarts/PublishOpsEvaluatorVersion.md): 该接口用于为指定的评估器创建并发布一个全新的快照版本，通过固化当前的判分逻辑与参数配置，实现评测标准的版本化管理与历史可追溯。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/evaluator
- [删除评估器特定版本 - DeleteOpsEvaluatorVersion](https://support.huaweicloud.com/api-agentarts/DeleteOpsEvaluatorVersion.md): 该接口用于从指定评估器的版本序列中永久移除特定的历史快照。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/ops/evaluators/{evaluator_id}/versions/{versi
- [获取评估器单个版本信息 - ShowOpsEvaluatorVersion](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluatorVersion.md): 该接口用于通过评估器ID与版本ID获取特定版本的详细快照信息，包括该版本固化的判分逻辑、Prompt 模板、参数权重及生效配置。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluator
- [评估器调试 - DebugOpsEvaluator](https://support.huaweicloud.com/api-agentarts/DebugOpsEvaluator.md): 该接口用于对评估器的判分逻辑进行实时调试，通过输入样例数据验证评估器的解析能力、Prompt 效果及评分准确性。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/evaluators/debug
- [智能生成G-Eval评估步骤 - GenerateOpsEvaluatorEvaluationSteps](https://support.huaweicloud.com/api-agentarts/GenerateOpsEvaluatorEvaluationSteps.md): 该接口用于根据用户提供的规则描述(criteria)，利用大模型自动生成结构化的评估步骤。通过自适应的方式降低用户编写评估提示词的门槛，提升评估器配置效率。约束限制：criteria长度必须在1到20000之间。criteria长度必须在1到20000之间。criteria必须包含{{}}格式的变量。criteria必须包含{{}}格式的
- [获取评估器筛选选项列表 - ListOpsEvaluatorFilterOptions](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluatorFilterOptions.md): 该接口用于获取评估器列表页面可用的筛选维度及其枚举值。前端通过此接口动态渲染筛选下拉框，帮助用户快速定位所需的评估器。返回的筛选项包括：evaluator_type: 评估器类型（模型判定/代码判定/自适应判定）evaluator_type: 评估器类型（模型判定/代码判定/自适应判定）turn_type: 对话轮次类型（单轮/多轮）tu
- [细粒度评估 - InvokeOpsFineGrainedEvaluation](https://support.huaweicloud.com/api-agentarts/InvokeOpsFineGrainedEvaluation.md): 该接口提供细粒度评估能力，基于评估器维度，无需预先创建评测集和评估任务，只需指定评估器并传入待评估数据即可完成评估，评估结果通过流式（SSE）或非流式方式返回。适用场景：场景1（dataset）：对已有的输入输出数据进行评估评分。场景1（dataset）：对已有的输入输出数据进行评估评分。场景2（agent）：传入输入调用智能体获取输出后
- [获取评估器模板列表 - ListOpsEvaluatorTemplates](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluatorTemplates.md): 该接口用于获取系统中的所有评估器模板信息列表，支持分页查询和条件筛选，适用于需要查看和管理评估器模板的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/evaluator-template
- [获取评估器模板 - ShowOpsEvaluatorTemplate](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluatorTemplate.md): 该接口用于根据模板ID获取特定评估器模板的详细信息，支持查询模板的完整配置和使用说明，适用于需要深入了解特定模板配置的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluator-t
- [检查新建评估任务名称是否存在 - CheckOpsEvaluationTaskName](https://support.huaweicloud.com/api-agentarts/CheckOpsEvaluationTaskName.md): 该接口用于检查指定的评估任务名称是否已存在，返回名称唯一性验证结果，适用于创建新任务前验证任务名称可用性的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluation-tasks/
- [查看评估任务列表 - ListOpsEvaluationTasks](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluationTasks.md): 该接口用于获取评估任务列表信息，支持条件筛选和分页查询，返回任务的基本信息和执行状态，适用于任务管理和监控的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/evaluation-task
- [查看任务评估结果 - ListOpsEvaluationTaskResults](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluationTaskResults.md): 该接口用于获取评估任务的详细评估结果，包括各项评估指标的分数、用时和详细信息，适用于任务结果分析和质量评估的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/evaluation-task
- [校正评估结果 - UpdateOpsEvaluationTaskResult](https://support.huaweicloud.com/api-agentarts/UpdateOpsEvaluationTaskResult.md): 该接口用于对已生成的自动化评估结果执行人工校正，允许通过更新得分与修正理由来覆盖评价，确保最终评测结论的客观性与权威性。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/ops/evaluation-ta
- [获取任务的成功数和失败数 - ShowOpsEvaluationTaskChartsStatus](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTaskChartsStatus.md): 该接口用于获取指定评测任务的执行状态分布统计，返回任务中各数据条目的成功与失败数量。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluation-tasks/{task_id}/char
- [某个任务的所有评估器得分统计 - ShowOpsEvaluationTaskChartsScoreStats](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTaskChartsScoreStats.md): 该接口用于获取指定评测任务中各评估维度的得分分布与汇总统计，通过聚合多个评估器的分值数据，生成反映模型各方面能力指标视图。适用场景：模型能力多维诊断：对比同一任务下不同评估器（如：逻辑性得分 vs 准确性得分）的统计表现，精准识别模型的优势与短板。模型能力多维诊断：对比同一任务下不同评估器（如：逻辑性得分 vs 准确性得分）的统计表现，精
- [统计一个任务的所有自定义标签的标签项分布 - ShowOpsEvaluationTaskChartsLabelsDistribution](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTaskChartsLabelsDistribution.md): 该接口用于统计评估任务中自定义标签的分布情况，支持文本标签和布尔标签的分类统计，适用于数据特征分析和标签管理的场景。适用场景：- 分析评估数据中标签的分布特征和规律。- 自定义标签的使用频率和覆盖范围。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更
- [统计每个任务的评估器得分分布 - ShowOpsEvaluationTaskChartsScoreDistribution](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTaskChartsScoreDistribution.md): 该接口用于获取评估任务中各评估器的得分分布情况，统计不同分数区间的样本数量，适用于评估结果可视化分析的场景。适用场景：- 查看评估得分的分布特征和集中趋势。- 识别评估结果中高分和低分样本的比例。- 分析评估模型的评分一致性和区分度。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IA
- [删除评估任务自定义标签 - DeleteOpsEvaluationTaskCustomLabels](https://support.huaweicloud.com/api-agentarts/DeleteOpsEvaluationTaskCustomLabels.md): 该接口用于删除评估任务的指定自定义标签，支持移除不需要的标签项，适用于标签管理和数据清理的场景。适用场景：清理评估任务中不再使用的标签项。清理评估任务中不再使用的标签项。调整评估数据的分类和标记。调整评估数据的分类和标记。优化标签结构以提高数据管理效率。优化标签结构以提高数据管理效率。请参见如何调用API。账号根用户具备所有API的调用权
- [批量删除任务 - BatchDeleteOpsEvaluationTasks](https://support.huaweicloud.com/api-agentarts/BatchDeleteOpsEvaluationTasks.md): 该接口用于批量删除指定的评估任务，支持一次性删除多个任务，批量返回删除结果，适用于任务清理的场景。适用场景：清理不再需要的历史评估任务。清理不再需要的历史评估任务。批量删除测试或错误创建的任务。批量删除测试或错误创建的任务。管理项目中的任务列表以保持系统整洁。管理项目中的任务列表以保持系统整洁。请参见如何调用API。账号根用户具备所有AP
- [创建评估任务 - CreateOpsEvaluationTask](https://support.huaweicloud.com/api-agentarts/CreateOpsEvaluationTask.md): 该接口用于创建新的评估任务，支持离线和在线评估模式，灵活配置评估参数和数据源，适用于各类模型评估和数据质量验证的场景。适用场景：启动新的离线评估任务进行模型质量测试。启动新的离线评估任务进行模型质量测试。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，
- [暂停评估任务 - StopOpsEvaluationTask](https://support.huaweicloud.com/api-agentarts/StopOpsEvaluationTask.md): 该接口用于暂停正在运行的评估任务，支持临时任务执行控制，适用于任务调度的场景。适用场景：暂停长时间运行的评估任务以释放资源。暂停长时间运行的评估任务以释放资源。在发现问题时临时停止任务执行。在发现问题时临时停止任务执行。调整任务执行优先级和时间安排。调整任务执行优先级和时间安排。请参见如何调用API。账号根用户具备所有API的调用权限，如
- [查看评估任务详情 - ShowOpsEvaluationTask](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTask.md): 该接口用于获取评估任务的详细信息，包括任务配置、状态、统计结果等完整信息，适用于任务详情查看的场景。适用场景：查看评估任务的完整配置和执行状态。查看评估任务的完整配置和执行状态。分析任务运行过程中的性能和结果统计信息。分析任务运行过程中的性能和结果统计信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用
- [批量添加评估任务的自定义标签值 - BatchAddOpsEvaluationTaskCustomLabelValues](https://support.huaweicloud.com/api-agentarts/BatchAddOpsEvaluationTaskCustomLabelValues.md): 该接口用于批量添加评估任务的自定义标签值，支持为多个数据项设置标签值，适用于数据标注和分类管理的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/ops/evaluation-tasks/{tas
- [查询评估任务的自定义标签值 - ListOpsEvaluationTaskCustomLabelValues](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluationTaskCustomLabelValues.md): 该接口用于查询评估任务的自定义标签值，支持按标签ID和项目ID进行过滤查询，适用于标签数据查询和分析的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluation-tasks/{t
- [更新评估任务的自定义标签值 - BatchUpdateOpsEvaluationTaskCustomLabelValues](https://support.huaweicloud.com/api-agentarts/BatchUpdateOpsEvaluationTaskCustomLabelValues.md): 该接口用于批量更新评估任务的自定义标签值，支持修改现有标签值的标注内容。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/ops/evaluation-tasks/{task_id}/custom-lab
- [删除评估任务自定义标签值 - DeleteOpsEvaluationTaskCustomLabelValues](https://support.huaweicloud.com/api-agentarts/DeleteOpsEvaluationTaskCustomLabelValues.md): 该接口用于删除评估任务的自定义标签值，支持批量移除指定标签项。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/ops/evaluation-tasks/{task_id}/custom-label
- [查询评估任务的自定义标签列表 - ListOpsEvaluationTaskCustomLabels](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluationTaskCustomLabels.md): 该接口用于查询评估任务的所有自定义标签，返回标签ID、类型、创建时间等详细信息，支持分页查询和筛选，适用于标签管理和查询的场景。适用场景：查看评估任务使用的所有分类标记。查看评估任务使用的所有分类标记。分析自定义标签的使用情况和分布特征。分析自定义标签的使用情况和分布特征。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用
- [添加评估任务自定义标签 - BatchAddOpsEvaluationTaskCustomLabels](https://support.huaweicloud.com/api-agentarts/BatchAddOpsEvaluationTaskCustomLabels.md): 该接口用于为评估任务添加自定义标签，支持批量添加多个标签类型，适用于任务分类管理和数据标记的场景。适用场景：为评估任务添加新的分类标记和特征标签。为评估任务添加新的分类标记和特征标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见
- [获取评估任务统计结果 - ShowOpsEvaluationTasksChartsCompareResult](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTasksChartsCompareResult.md): 该接口用于统计不同评估任务的对比结果报告，包含评估器得分情况、得分概览、任务消耗总token统计，适用于数据特征分析和评估任务管理的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/eval
- [获取评估任务对比结果 - ShowOpsEvaluationTasksCompareResult](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTasksCompareResult.md): 该接口用于统计不同评估任务的对比结果，包含每个任务在每个评估器的得分情况、每个评估器得分、任务状态、任务耗时、任务消耗总token，适用于数据特征分析和评估任务管理的场景。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项
- [获取评估任务的洞察结果 - ShowOpsEvaluationTaskInsights](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationTaskInsights.md): 该接口用于获取评估任务的洞察结果，返回任务综合指标评分、高频异常分布及对应的链路诊断结果与修复策略的文本内容。适用场景：获取任务维度的多维量化评分结果，用于衡量并对比被评估对象的综合基准表现。获取任务维度的多维量化评分结果，用于衡量并对比被评估对象的综合基准表现。定位导致评估失败或评分偏低的关键错误节点，获取基于错误链路的自动化修复策略，
- [更新评估任务洞察结果的用户反馈 - UpdateOpsEvaluationTaskInsights](https://support.huaweicloud.com/api-agentarts/UpdateOpsEvaluationTaskInsights.md): 该接口用于更新用户对于洞察内容的反馈。适用场景：用户反馈建议。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/ops/evaluation-tasks/{task_id}/insights状态码：200
- [获取多模态文件上传地址 - GenerateOpsMultimodalUploadUrl](https://support.huaweicloud.com/api-agentarts/GenerateOpsMultimodalUploadUrl.md): 该接口用于生成OBS预签名上传链接和对应的OBS路径，供用户上传多模态文件（如PPT等）。用户使用返回的上传链接将文件上传至OBS后，可在细粒度评估接口中传入OBS路径进行评估。约束限制：同一用户未使用的上传链接数量上限为5个。同一用户未使用的上传链接数量上限为5个。上传链接有效期为15分钟。上传链接有效期为15分钟。单个文件大小上限10
- [获取标签列表 - ListOpsLabels](https://support.huaweicloud.com/api-agentarts/ListOpsLabels.md): 该接口用于获取系统中所有标签的信息列表，支持分页查询和类型筛选，适用于标签管理和选择查询的场景。适用场景：查看系统中可用的所有标签资源。查看系统中可用的所有标签资源。在评估任务中选择合适的标签进行分类。在评估任务中选择合适的标签进行分类。看标签的详细信息，维护标签体系的完整性。看标签的详细信息，维护标签体系的完整性。请参见如何调用API。
- [创建标签 - CreateOpsLabel](https://support.huaweicloud.com/api-agentarts/CreateOpsLabel.md): 该接口用于创建新标签，支持文本标签和布尔类型的自定义标签，适用于资源分类、数据标注和标签管理的场景。适用场景：在评估任务管理中，创建新的标签以便对任务进行分类标记（如按业务线、优先级分类）。在评估任务管理中，创建新的标签以便对任务进行分类标记（如按业务线、优先级分类）。根据业务发展需要，扩展现有的标签系统，增加新的数据分类维度，支持更细粒
- [获取标签详情 - ShowOpsLabel](https://support.huaweicloud.com/api-agentarts/ShowOpsLabel.md): 该接口用于获取标签的详细信息，包括标签名称、类型、描述和关联的标注项，适用于标签详情查看和标签管理的场景。适用场景：查看标签的完整配置信息和关联内容。查看标签的完整配置信息和关联内容。审核和验证标签的使用范围和限制。审核和验证标签的使用范围和限制。标签系统维护和数据质量检查。标签系统维护和数据质量检查。请参见如何调用API。账号根用户具备
- [更新标签 - UpdateOpsLabel](https://support.huaweicloud.com/api-agentarts/UpdateOpsLabel.md): 该接口用于更新标签信息，支持修改标签名称、描述和标注项，适用于标签内容维护和完善的场景。适用场景：更新标签的描述信息以反映最新使用场景。更新标签的描述信息以反映最新使用场景。添加或修改标签的支持选项和枚举值。添加或修改标签的支持选项和枚举值。修正标签配置以适应业务需求变化。修正标签配置以适应业务需求变化。请参见如何调用API。账号根用户具
- [获取当前项目的配额 - ShowOpsQuota](https://support.huaweicloud.com/api-agentarts/ShowOpsQuota.md): 该接口用于获取当前项目的配额信息，支持查询各类任务的数量上限和剩余配额，适用于资源管理和容量规划的场景。适用场景：任务创建前查询当前项目的资源限制和剩余容量，避免因配额不足导致任务创建失败。任务创建前查询当前项目的资源限制和剩余容量，避免因配额不足导致任务创建失败。查看各类任务的已用配额和总量，掌握项目的资源消耗状况。查看各类任务的已用配
- [获取模型信息 - ListOpsEvaluationModels](https://support.huaweicloud.com/api-agentarts/ListOpsEvaluationModels.md): 该接口用于获取系统中所有可用的基础大模型及微调模型的详细列表，涵盖模型能力类型、状态及访问参数。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluation-models无状态码：200
- [获取单个模型信息 - ShowOpsEvaluationModel](https://support.huaweicloud.com/api-agentarts/ShowOpsEvaluationModel.md): 该接口用于通过模型ID获取特定大模型的详细元数据，包含其技术规格、版本信息、支持的协议能力及服务终点。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/ops/evaluation-models/{mod
- [创建代码解释器 - CreateCoreCodeInterpreter](https://support.huaweicloud.com/api-agentarts/CreateCoreCodeInterpreter.md): 该API用于创建一个代码解释器。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/core/code-interpreters状态码：201状态码：400状态码：401状态码：403状态码：404状态码
- [查询代码解释器列表 - ListCoreCodeInterpreters](https://support.huaweicloud.com/api-agentarts/ListCoreCodeInterpreters.md): 该API用于查询代码解释器列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/code-interpreters无状态码：200状态码：400状态码：401状态码：403状态码：404状态码
- [查询代码解释器详情 - ShowCoreCodeInterpreter](https://support.huaweicloud.com/api-agentarts/ShowCoreCodeInterpreter.md): 该API用于查询代码解释器详情。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/code-interpreters/{code_interpreter_id}无状态码：200状态码：401状态
- [更新代码解释器 - UpdateCoreCodeInterpreter](https://support.huaweicloud.com/api-agentarts/UpdateCoreCodeInterpreter.md): 该API用于更新代码解释器配置。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/core/code-interpreters/{code_interpreter_id}状态码：200状态码：401状态码
- [删除代码解释器 - DeleteCoreCodeInterpreter](https://support.huaweicloud.com/api-agentarts/DeleteCoreCodeInterpreter.md): 删除指定的代码解释器。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/core/code-interpreters/{code_interpreter_id}无状态码：204删除成功，无响应内容。
- [根据标签查询代码解释器列表 - ListCoreCodeInterpretersByTags](https://support.huaweicloud.com/api-agentarts/ListCoreCodeInterpretersByTags.md): 该API用于根据标签查询代码解释器列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/code-interpreters/resource-instances/filter状态码：200状态码：40
- [根据标签查询代码解释器数量 - ShowCoreCodeInterpreterNumsByTags](https://support.huaweicloud.com/api-agentarts/ShowCoreCodeInterpreterNumsByTags.md): 该API用于根据标签查询代码解释器数量。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/code-interpreters/resource-instances/count状态码：200状态码：400
- [批量添加代码解释器标签 - BatchCreateCoreCodeInterpreterTags](https://support.huaweicloud.com/api-agentarts/BatchCreateCoreCodeInterpreterTags.md): 该API用于批量添加代码解释器标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/code-interpreters/{code_interpreter_id}/tags/create状态码：204
- [批量删除代码解释器标签 - BatchDeleteCoreCodeInterpreterTags](https://support.huaweicloud.com/api-agentarts/BatchDeleteCoreCodeInterpreterTags.md): 该API用于批量删除代码解释器标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/code-interpreters/{code_interpreter_id}/tags/delete状态码：204
- [查询代码解释器标签列表 - ListCoreCodeInterpreterTags](https://support.huaweicloud.com/api-agentarts/ListCoreCodeInterpreterTags.md): 该API用于查询代码解释器标签列表。请参见如何调用API。当前API调用无需身份策略权限。GET /v1/code-interpreters/{code_interpreter_id}/tags无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：200查询代码解释器标签列表成功。状态
- [查询账号下所有代码解释器标签列表 - ListAllCoreCodeInterpreterTags](https://support.huaweicloud.com/api-agentarts/ListAllCoreCodeInterpreterTags.md): 该API用于查询账号下所有代码解释器标签列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/code-interpreters/tags无状态码：200状态码：400状态码：401状态码：403状态码
- [执行数据面请求调用 - ExecuteCode](https://support.huaweicloud.com/api-agentarts/ExecuteCode.md): 该API用于在沙箱中执行各类操作请求，比如执行代码、执行命令、写入文件、读取文件、列出文件、删除文档等操作。请参见如何调用API。当前API调用无需身份策略权限。POST /v1/code-interpreters/{code_interpreter_name}/invoke状态码：200状态码：401状态码：200OK状态码：400请求
- [启动session - StartCodeInterpreterSession](https://support.huaweicloud.com/api-agentarts/StartCodeInterpreterSession.md): 该API用于启动一个代码解释器的Session。请参见如何调用API。当前API调用无需身份策略权限。PUT /v1/code-interpreters/{code_interpreter_name}/sessions-start状态码：200状态码：401状态码：200OK状态码：400请求参数错误。状态码：401未授权（认证令牌缺失、
- [停止session - StopCodeInterpreterSession](https://support.huaweicloud.com/api-agentarts/StopCodeInterpreterSession.md): 该API用于停止指定的代码解释器的Session。请参见如何调用API。当前API调用无需身份策略权限。PUT /v1/code-interpreters/{code_interpreter_name}/sessions-stop状态码：204No Content状态码：401状态码：400请求参数错误。状态码：401未授权（认证令牌缺失
- [查询session - ShowCodeInterpreterSession](https://support.huaweicloud.com/api-agentarts/ShowCodeInterpreterSession.md): 该API用于查询一个代码解释器的Session详情。请参见如何调用API。当前API调用无需身份策略权限。GET /v1/code-interpreters/{code_interpreter_name}/sessions-get状态码：200状态码：401状态码：200OK状态码：400请求参数错误。状态码：401未授权（认证令牌缺失、
- [调用MCP网关 - InvokeMcpGateway](https://support.huaweicloud.com/api-agentarts/InvokeMcpGateway.md): 该接口用于调用已创建并配置好Target的MCP网关。请参见如何调用API。当前API调用无需身份策略权限。POST /mcp状态码：200状态码：401状态码：500无请参见错误码。
- [创建网关 - CreateCoreGateway](https://support.huaweicloud.com/api-agentarts/CreateCoreGateway.md): 使用指定配置创建一个新的网关。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/core/gateways状态码：201状态码：400状态码：401状态码：403状态码：429状态码：409状态码：50
- [列出所有网关 - ListCoreGateways](https://support.huaweicloud.com/api-agentarts/ListCoreGateways.md): 检索所有网关的列表，支持可选的过滤和分页功能。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/gateways无状态码：200状态码：400状态码：401状态码：403状态码：429状态码：5
- [获取网关详情 - ShowCoreGateway](https://support.huaweicloud.com/api-agentarts/ShowCoreGateway.md): 通过 ID 获取指定网关的详细信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/gateways/{gateway_id}无状态码：200状态码：404状态码：401状态码：403状态码：
- [更新网关 - UpdateCoreGateway](https://support.huaweicloud.com/api-agentarts/UpdateCoreGateway.md): 使用新配置更新现有网关。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/core/gateways/{gateway_id}状态码：200状态码：400状态码：404状态码：401状态码：403状态码：
- [删除网关 - DeleteCoreGateway](https://support.huaweicloud.com/api-agentarts/DeleteCoreGateway.md): 永久删除指定 ID 的网关。此操作无法撤销。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/core/gateways/{gateway_id}无状态码：204网关删除成功状态码：409状态码：4
- [同步网关目标工具列表 - SyncCoreGatewayTargets](https://support.huaweicloud.com/api-agentarts/SyncCoreGatewayTargets.md): 同步网关目标工具列表，同步状态可通过查询目标详情查询。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/core/gateways/{gateway_id}/synchronize-targets状态码：
- [创建目标服务 - CreateCoreGatewayTarget](https://support.huaweicloud.com/api-agentarts/CreateCoreGatewayTarget.md): 为指定网关创建目标服务。目标服务定义了网关可以连接的端点。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/core/gateways/{gateway_id}/targets状态码：201状态码：40
- [列出目标服务 - ListCoreGatewayTargets](https://support.huaweicloud.com/api-agentarts/ListCoreGatewayTargets.md): 列出指定网关的所有目标服务，支持分页功能。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/gateways/{gateway_id}/targets无状态码：200状态码：400状态码：404
- [获取目标服务详情 - ShowCoreGatewayTarget](https://support.huaweicloud.com/api-agentarts/ShowCoreGatewayTarget.md): 获取指定目标服务的详细信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/gateways/{gateway_id}/targets/{target_id}无状态码：200状态码：400状态
- [更新目标服务 - UpdateCoreGatewayTarget](https://support.huaweicloud.com/api-agentarts/UpdateCoreGatewayTarget.md): 更新现有目标服务的配置。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。PUT /v1/core/gateways/{gateway_id}/targets/{target_id}状态码：200状态码：400状态码：4
- [删除目标服务 - DeleteCoreGatewayTarget](https://support.huaweicloud.com/api-agentarts/DeleteCoreGatewayTarget.md): 永久删除指定目标服务。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。DELETE /v1/core/gateways/{gateway_id}/targets/{target_id}无状态码：204目标服务删除成功状
- [查询账号配额 - ListCoreGatewayQuotas](https://support.huaweicloud.com/api-agentarts/ListCoreGatewayQuotas.md): 获取当前认证账号的有效配额信息，包括配额类型、最小值、最大值、配额值和已使用数量。请参见如何调用API。当前API调用无需身份策略权限。GET /v1/core/gateway-quotas无状态码：200状态码：500状态码：400状态码：401状态码：404状态码：429无状态码：200成功检索账号配额列表状态码：500内部服务器错误
- [根据标签查询网关列表 - ListCoreGatewaysByTags](https://support.huaweicloud.com/api-agentarts/ListCoreGatewaysByTags.md): 根据标签过滤条件查询网关列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/gateways/resource-instances/filter状态码：200状态码：400状态码：401状态码：40
- [根据标签查询网关数量 - ShowCoreGatewayNumsByTags](https://support.huaweicloud.com/api-agentarts/ShowCoreGatewayNumsByTags.md): 根据标签查询网关数量。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/gateways/resource-instances/count状态码：200状态码：400状态码：401状态码：403状态码：
- [批量添加网关标签 - BatchCreateCoreGatewayTags](https://support.huaweicloud.com/api-agentarts/BatchCreateCoreGatewayTags.md): 批量添加网关标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/gateways/{gateway_id}/tags/create状态码：204No Content状态码：400状态码：401状态码
- [批量删除网关标签 - BatchDeleteCoreGatewayTags](https://support.huaweicloud.com/api-agentarts/BatchDeleteCoreGatewayTags.md): 批量删除网关标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/gateways/{gateway_id}/tags/delete状态码：204No Content状态码：400状态码：401状态码
- [查询网关标签列表 - ListCoreGatewayTags](https://support.huaweicloud.com/api-agentarts/ListCoreGatewayTags.md): 查询网关标签列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/gateways/{gateway_id}/tags无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：42
- [查询账号下所有网关标签列表 - ListAllCoreGatewayTags](https://support.huaweicloud.com/api-agentarts/ListAllCoreGatewayTags.md): 查询账号下所有网关标签列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/gateways/tags无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500
- [创建Space - CreateCoreSpace](https://support.huaweicloud.com/api-agentarts/CreateCoreSpace.md): 创建新的记忆空间，用于存放某一类业务的短长期记忆数据，包括访问方式、抽取策略、密钥绑定等相关配置。请参见如何调用API。POST /v1/core/spaces状态码：201状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：201Space创建成功请参见错误码。
- [列出所有Space - ListCoreSpaces](https://support.huaweicloud.com/api-agentarts/ListCoreSpaces.md): 查询租户下的所有记忆空间信息，支持分页查询。请参见如何调用API。GET /v1/core/spaces无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：200成功获取 Space 列表请参见错误码。
- [获取Space详情 - ShowCoreSpace](https://support.huaweicloud.com/api-agentarts/ShowCoreSpace.md): 根据记忆空间ID获取记忆空间详细信息，包含完整配置和记忆策略。请参见如何调用API。GET /v1/core/spaces/{space_id}无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：200成功获取Space信息请参见错误码。
- [更新记忆空间相关配置 - UpdateCoreSpace](https://support.huaweicloud.com/api-agentarts/UpdateCoreSpace.md): 更新记忆空间相关配置，涉及名称、策略等。请参见如何调用API。PUT /v1/core/spaces/{space_id}状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：200更新成功请参见错误码。
- [删除记忆空间 - DeleteCoreSpace](https://support.huaweicloud.com/api-agentarts/DeleteCoreSpace.md): 删除记忆空间，将清空所有记忆数据和配置，不可恢复。请参见如何调用API。DELETE /v1/core/spaces/{space_id}无状态码：204删除成功状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：204删除成功请参见错误码。
- [获取内置记忆策略列表 - ListCoreSpaceBuiltinStrategies](https://support.huaweicloud.com/api-agentarts/ListCoreSpaceBuiltinStrategies.md): 返回系统预置的内置记忆策略及其步骤详情，内置策略全局共享。内置策略不可修改，用户可根据内置策略创建自定义策略。当前包含 4 种内置策略：Semantic Memory：语义记忆提取（extraction → consolidation）Semantic Memory：语义记忆提取（extraction → consolidation）Us
- [创建自定义记忆策略 - CreateCoreSpaceCustomizedStrategy](https://support.huaweicloud.com/api-agentarts/CreateCoreSpaceCustomizedStrategy.md): 为指定 Space 创建自定义记忆策略。需指定策略名称、类型及步骤列表。请参见如何调用API。POST /v1/core/spaces/{space_id}/strategies/customized状态码：201状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：201自定义策略创建成功请参见错误
- [更新自定义记忆策略 - UpdateCoreSpaceCustomizedStrategy](https://support.huaweicloud.com/api-agentarts/UpdateCoreSpaceCustomizedStrategy.md): 更新指定Space下的自定义记忆策略配置。请参见如何调用API。PUT /v1/core/spaces/{space_id}/strategies/customized/{strategy_id}状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：200策略更新成功请参见错误码。
- [删除自定义记忆策略 - DeleteCoreSpaceCustomizedStrategy](https://support.huaweicloud.com/api-agentarts/DeleteCoreSpaceCustomizedStrategy.md): 删除指定Space下的自定义记忆策略，不可恢复。请参见如何调用API。DELETE /v1/core/spaces/{space_id}/strategies/customized/{strategy_id}无状态码：204策略删除成功状态码：401状态码：403状态码：404状态码：429状态码：500无请参见错误码。
- [创建 API Key - CreateCoreSpaceApiKey](https://support.huaweicloud.com/api-agentarts/CreateCoreSpaceApiKey.md): 创建新的 API Key，用于数据面访问认证。API Key 先于 Space 创建，创建后通过 CreateSpace 的 api_key_id 参数绑定到 Space。请参见如何调用API。POST /v1/core/space-keys无状态码：201状态码：400状态码：401状态码：403状态码：429状态码：500状态码：20
- [重置 API Key - ResetCoreSpaceApiKey](https://support.huaweicloud.com/api-agentarts/ResetCoreSpaceApiKey.md): 异步重置指定 Space 的 API Key，旧 Key 立即失效。请参见如何调用API。POST /v1/core/spaces/{space_id}/reset-key无状态码：202状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500无请参见错误码。
- [更新Space网络配置 - UpdateCoreSpaceNetwork](https://support.huaweicloud.com/api-agentarts/UpdateCoreSpaceNetwork.md): 更新指定Space的网络访问配置。请参见如何调用API。PUT /v1/core/spaces/{space_id}/network状态码：202状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500无请参见错误码。
- [列出异步任务 - ListCoreSpaceJobs](https://support.huaweicloud.com/api-agentarts/ListCoreSpaceJobs.md): 分页列出指定Space下的异步任务。请参见如何调用API。GET /v1/core/spaces/{space_id}/jobs无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500状态码：200成功获取任务列表请参见错误码。
- [查询异步任务详情 - ShowCoreSpaceJob](https://support.huaweicloud.com/api-agentarts/ShowCoreSpaceJob.md): 查询服务异步任务详情。请参见如何调用API。GET /v1/core/spaces/{space_id}/job/{job_id}无状态码：200状态码：401状态码：403状态码：404状态码：429状态码：500状态码：200成功获取任务状态请参见错误码。
- [批量添加记忆库标签 - BatchCreateCoreSpaceTags](https://support.huaweicloud.com/api-agentarts/BatchCreateCoreSpaceTags.md): 该接口用于批量为记忆库打资源标签。适用场景：为记忆库资源批量添加标签。请参见如何调用API。POST /v1/memory-space/{space_id}/tags/create状态码：204操作成功，无响应内容。状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500创建单个标签无请参见错误码。
- [批量删除记忆库标签 - BatchDeleteCoreSpaceTags](https://support.huaweicloud.com/api-agentarts/BatchDeleteCoreSpaceTags.md): 该接口用于批量删除记忆库的资源标签。适用场景：为记忆库资源批量删除标签。请参见如何调用API。POST /v1/memory-space/{space_id}/tags/delete状态码：204操作成功，无响应内容。状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500删除单个标签无请参见错误码。
- [查询账号下所有记忆库标签列表 - ListAllCoreSpaceTags](https://support.huaweicloud.com/api-agentarts/ListAllCoreSpaceTags.md): 该接口用于查询本账号下所有记忆库资源的标签列表。适用场景：查询账号下所有记忆库资源的标签列表。请参见如何调用API。GET /v1/memory-space/tags无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500查询租户所有记忆库标签状态码：200查询账号下所有记忆库标签列表成功。请参
- [查询记忆库标签列表 - ListCoreSpaceTags](https://support.huaweicloud.com/api-agentarts/ListCoreSpaceTags.md): 该接口用于查询记忆库的资源标签。适用场景：查询记忆库的资源标签。请参见如何调用API。GET /v1/memory-space/{space_id}/tags无状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500查询资源所有标签状态码：200查询记忆库标签列表成功。请参见错误码。
- [根据标签查询记忆库列表 - ListCoreSpaceByTags](https://support.huaweicloud.com/api-agentarts/ListCoreSpaceByTags.md): 该接口用于根据标签过滤条件查询智能体记忆库的资源列表。适用场景：根据标签条件查找对应的智能体记忆库资源。请参见如何调用API。POST /v1/memory-space/resource-instances/filter状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500根据标签精确查询状态码
- [根据标签查询记忆库数量 - ShowCoreSpaceNumsByTags](https://support.huaweicloud.com/api-agentarts/ShowCoreSpaceNumsByTags.md): 该接口用于根据标签过滤条件查询记忆库的资源数量。适用场景：根据标签条件查找对应的记忆库的资源数量。请参见如何调用API。POST /v1/memory-space/resource-instances/count状态码：200状态码：400状态码：401状态码：403状态码：404状态码：429状态码：500根据标签精确查询资源数量状态码
- [创建智能体运行时会话 - StartRuntimeSession](https://support.huaweicloud.com/api-agentarts/StartRuntimeSession.md): 该接口用于创建智能体运行时会话。请参见如何调用API。当前API调用无需身份策略权限。POST /runtimes/{runtime_name}/sessions-start状态码：200状态码：401状态码：500启动运行时会话, gateway_domain为运行时的访问域名，可以在智能体运行时的运行时详情页面中获取无请参见错误码。
- [调用智能体运行时的自定义接口 - ExecuteRuntimeWithPrefix](https://support.huaweicloud.com/api-agentarts/ExecuteRuntimeWithPrefix.md): 该接口用于使用前缀匹配方式调用已经部署好的高代码智能体运行时的自定义接口，使用该接口需要确保智能体运行时的URL的匹配模式设置为PREFIX_MATCH前缀匹配，部署智能体运行时请参见部署智能体运行时。此API实际上支持所有 HTTP 方法（包括不限于POST、GET、DELETE、PUT等），请按照后端实际的接口方法进行调用。适用场景：
- [调用智能体运行时 - ExecuteRuntime](https://support.huaweicloud.com/api-agentarts/InvokeRuntime1.md): 该接口用于调用已经部署好的高代码智能体运行时，部署智能体运行时请参见部署智能体运行时。适用场景：适用场景：调用已经部署好的高代码智能体运行时。请参见如何调用API。当前API调用无需身份策略权限。POST /runtimes/{runtime_name}/invocations状态码：200智能体调用成功的响应Body体。状态码：401状
- [调用智能体运行时--执行命令 - ExecuteRuntimeCommands](https://support.huaweicloud.com/api-agentarts/ExecuteRuntimeCommands.md): 该接口用于调用已经部署好的高代码智能体运行时，在智能体内执行命令。部署智能体运行时请参见部署智能体运行时。请参见如何调用API。当前API调用无需身份策略权限。POST /runtimes/{runtime_name}/commands状态码：200状态码：401状态码：500执行test.sh命令, gateway_domain为运行时
- [调用智能体运行时--上传文件 - ExecuteRuntimeUploadFiles](https://support.huaweicloud.com/api-agentarts/ExecuteRuntimeUploadFiles.md): 该接口用于调用已经部署好的高代码智能体运行时，上传文件到智能体内的目标路径。仅传 path (单个文件名) 时，文件会自动保存到用户主目录 ~/仅传 path (单个文件名) 时，文件会自动保存到用户主目录 ~/支持单文件流式上传和 multipart 多文件表单上传件支持单文件流式上传和 multipart 多文件表单上传件上传文件时，
- [调用智能体运行时--下载文件 - ExecuteRuntimeDownloadFiles](https://support.huaweicloud.com/api-agentarts/ExecuteRuntimeDownloadFiles.md): 该接口用于调用已经部署好的高代码智能体运行时，在智能体内下载文件。部署智能体运行时请参见部署智能体运行时。请参见如何调用API。当前API调用无需身份策略权限。GET /runtimes/{runtime_name}/download-files状态码：200下载成功，返回文件流或归档包状态码：400状态码：401状态码：404状态码：4
- [停止智能体运行时会话 - StopRuntimeSession](https://support.huaweicloud.com/api-agentarts/StopRuntimeSession.md): 该接口用于根据会话唯一标识对智能体运行时的会话进行销毁操作。适用场景：适用场景：使用智能体运行时（高代码）接口创建会话后，需要将会话对应的实例进行停止的场景。请参见如何调用API。当前API调用无需身份策略权限。POST /runtimes/{runtime_name}/sessions-stop状态码：200状态码：401状态码：500
- [创建runtime - CreateCoreRuntime](https://support.huaweicloud.com/api-agentarts/CreateCoreRuntime.md): 该接口用于创建Agent运行时，支持为该运行时进行入站认证，网络访问，可观测配置等。该接口会同时创建运行时以及对应的初始版本。适用场景：部署一个已经开发完成的Agent应用。为Agent应用配置入站认证。为Agent应用配置入口和出口网络。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，
- [批量查询runtime - ListCoreRuntimes](https://support.huaweicloud.com/api-agentarts/ListCoreRuntimes.md): 该接口用于查询Agent运行时列表。支持按多种条件筛选和分页查询。适用场景：根据Agent运行时名称查询运行时列表，支持精确匹配和模糊匹配。根据Agent运行时ID进行精确查询，支持批量查询多个运行时ID。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限
- [查询单个runtime及指定版本详情 - ShowCoreRuntime](https://support.huaweicloud.com/api-agentarts/ShowCoreRuntime.md): 该接口用于根据Agent运行时ID查询对应的Agent运行时详细信息。该接口可通过version参数指定查询特定版本，不指定则返回最新版本。适用场景：查询某一个具体的Agent运行时最新版本及指定版本的详细信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策
- [更新runtime - UpdateCoreRuntime](https://support.huaweicloud.com/api-agentarts/UpdateCoreRuntime.md): 该接口用于根据Agent运行时ID修改对应的Agent运行时的配置信息，支持修改Agent镜像，网络配置，运行时委托，环境变量，可观测配置。该接口每次调用会生成一个新的运行时版本（更新tags除外）。version字段默认为v1、v2自增长，用户也可自定义。适用场景：修改某一个具体的Agent运行时的镜像版本、环境变量、网络配置。请参见如
- [删除runtime - DeleteCoreRuntime](https://support.huaweicloud.com/api-agentarts/DeleteCoreRuntime.md): 该接口用于根据Agent运行时ID删除对应的Agent运行时。该接口会删除运行时及其关联的所有版本和访问方式记录。适用场景：删除某一个具体的Agent运行时及其相关记录。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。
- [批量查询版本 - ListCoreRuntimeVersions](https://support.huaweicloud.com/api-agentarts/ListCoreRuntimeVersions.md): 该接口用于根据运行时ID查询某一个具体的Agent运行时下的版本列表。支持分页查询。适用场景：根据Agent运行时ID查询该运行时的版本列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/r
- [批量查询runtime访问方式 - ListCoreRuntimeEndpoints](https://support.huaweicloud.com/api-agentarts/ListCoreRuntimeEndpoints.md): 该接口用于根据运行时ID查询某一个具体的Agent运行时下的访问方式列表。支持分页查询。适用场景：根据Agent运行时ID查询该运行时的访问方式列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/co
- [创建runtime访问方式 - CreateCoreRuntimeEndpoint](https://support.huaweicloud.com/api-agentarts/CreateCoreRuntimeEndpoint.md): 该接口用于为某一个具体的Agent运行时创建访问方式，支持为该访问方式绑定版本以及对应的灰度策略。适用场景：某一个具体的Agent运行时存在多个版本，通过配置访问方式来指定调用某一个具体版本。某一个具体的Agent运行时修改后需要进行灰度发布，通过配置访问方式，为老版本和新版本配置流量权重。请参见如何调用API。账号根用户具备所有API的
- [查询单个runtime访问方式 - ShowCoreRuntimeEndpoint](https://support.huaweicloud.com/api-agentarts/ShowCoreRuntimeEndpoint.md): 该接口用于根据Agent运行时ID和访问方式ID查询对应的Agent运行时访问方式详细信息。适用场景：查询某一个具体的Agent运行时访问方式的详细信息。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/
- [更新runtime访问方式 - UpdateCoreRuntimeEndpoint](https://support.huaweicloud.com/api-agentarts/UpdateCoreRuntimeEndpoint.md): 该接口用于根据Agent运行时ID和访问方式ID修改对应的Agent运行时访问方式的配置信息，支持修改访问方式对应的版本信息以及多版本之间的权重分配信息。适用场景：修改某一个具体的Agent运行时访问方式的绑定版本。修改某一个具体的Agent运行时访问方式的多版本权重配置。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用
- [删除runtime访问方式 - DeleteCoreRuntimeEndpoint](https://support.huaweicloud.com/api-agentarts/DeleteCoreRuntimeEndpoint.md): 该接口用于根据Agent运行时ID以及访问方式ID删除对应的Agent运行时访问方式。访问方式删除后无法通过该访问方式进行Agent调用。适用场景：删除某一个具体的Agent运行时访问方式及其相关记录。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更
- [批量查询网关 - ListCoreIngresses](https://support.huaweicloud.com/api-agentarts/ListCoreIngresses.md): 该接口用于查询Ingress列表，支持按名称模糊匹配和分页查询。适用场景：查询租户下的所有Ingress列表。根据Ingress名称进行模糊查询。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core
- [创建网关 - CreateCoreIngress](https://support.huaweicloud.com/api-agentarts/CreateCoreIngress.md): 该接口用于创建一个新的Ingress配置。适用场景：创建Agent运行时入口网关配置。异步任务确认方式：调用创建接口后，通过查询Ingress详情接口（GET /v1/core/ingresses/{ingress_id}）查询status字段，当status变为ACTIVE时表示创建成功，变为FAILED时表示创建失败。请参见如何调用A
- [查询网关详情 - ShowCoreIngress](https://support.huaweicloud.com/api-agentarts/ShowCoreIngress.md): 该接口用于根据ingress_id查询Ingress的详细信息。适用场景：查询某一个具体的Ingress详情。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/ingresses/{ingres
- [更新网关 - UpdateCoreIngress](https://support.huaweicloud.com/api-agentarts/UpdateCoreIngress.md): 该接口用于根据ingress_id更新Ingress的配置信息。（异步接口）适用场景：修改Ingress的描述信息。启用或禁用公网访问。异步任务确认方式：调用更新接口后，通过查询Ingress详情接口（GET /v1/core/ingresses/{ingress_id}）查询status字段，当status变为ACTIVE时表示更新成功
- [删除网关 - DeleteCoreIngress](https://support.huaweicloud.com/api-agentarts/DeleteCoreIngress.md): 该接口用于根据ingress_id删除Ingress配置。（异步接口）适用场景：删除不再继续使用的Ingress配置。异步任务确认方式：调用删除接口后，通过查询Ingress详情接口（GET /v1/core/ingresses/{ingress_id}），如果返回404 Not Found则表示删除成功；如果仍能查询到资源且status
- [创建VPC入站网络 - CreateCoreIngressNetwork](https://support.huaweicloud.com/api-agentarts/CreateCoreIngressNetwork.md): 该接口用于为某一个Agent网关ID创建指定VPC的入站网络。该接口会为该VPC创建对应网关的访问地址和域名。适用场景：Agent运行时需要在VPC网络内部调用场景下，为该VPC网络配置网关调用入口。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多
- [查询VPC入站网络列表 - ListCoreIngressNetworks](https://support.huaweicloud.com/api-agentarts/ListCoreIngressNetworks.md): 该接口用于查询某一个具体的Agent网关下的所有入站网络列表，不支持分页。适用场景：查询某一个具体的Agent网关下的所有入站网络列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/ingr
- [查询VPC入站网络详情 - ShowCoreIngressNetwork](https://support.huaweicloud.com/api-agentarts/ShowCoreIngressNetwork.md): 该接口用于根据网关ID以及入站网络ID查询某一个具体的Agent网关入站网络详情。适用场景：查询某一个具体的Agent网关入站网络详情。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/core/ingr
- [删除VPC入站网络 - DeleteCoreIngressNetwork](https://support.huaweicloud.com/api-agentarts/DeleteCoreIngressNetwork.md): 该接口用于根据网关ID以及入站网络ID异步删除某一个具体的Agent网关入站网络。调用该接口之后，将无法通过该入站网络的入口IP或者域名进行Agent调用。适用场景：删除不再继续使用的Agent网关入站网络。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权
- [查询Runtime资源实例列表 - ListCoreRuntimeByTags](https://support.huaweicloud.com/api-agentarts/ListCoreRuntimeByTags.md): 该接口用于根据标签过滤条件查询智能体运行时的资源列表。适用场景：根据标签条件查找对应的智能体运行时资源。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtimes/resource-instan
- [查询Runtime资源实例数量 - ShowCoreRuntimeNumsByTags](https://support.huaweicloud.com/api-agentarts/ShowCoreRuntimeNumsByTags.md): 该接口用于根据标签过滤条件查询智能体运行时的资源数量。适用场景：根据标签条件查找对应的智能体运行时资源数量。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtimes/resource-inst
- [批量为Runtime打资源标签 - BatchCreateCoreRuntimeTags](https://support.huaweicloud.com/api-agentarts/BatchCreateCoreRuntimeTags.md): 该接口用于批量为运行时打资源标签。适用场景：为运行时资源批量添加标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtimes/{runtime_id}/tags/create状态码：204N
- [批量删除Runtime资源标签 - BatchDeleteCoreRuntimeTags](https://support.huaweicloud.com/api-agentarts/BatchDeleteCoreRuntimeTags.md): 该接口用于批量删除运行时的资源标签。适用场景：为运行时资源批量删除标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtimes/{runtime_id}/tags/delete状态码：204
- [查询Runtime标签列表 - ListCoreRuntimeTags](https://support.huaweicloud.com/api-agentarts/ListCoreRuntimeTags.md): 该接口用于查询运行时的资源标签。适用场景：查询运行时的资源标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/runtimes/{runtime_id}/tags无状态码：200状态码：400状态码：
- [查询账号下所有Runtime标签列表 - ListAllCoreRuntimeTags](https://support.huaweicloud.com/api-agentarts/ListAllCoreRuntimeTags.md): 该接口用于查询本账号下所有运行时资源的标签列表。适用场景：查询账号下所有运行时资源的标签列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/runtimes/tags无状态码：200状态码：400状态
- [查询RuntimeEndpoint资源实例列表 - ListCoreRuntimeEndpointByTags](https://support.huaweicloud.com/api-agentarts/ListCoreRuntimeEndpointByTags.md): 该接口用于根据标签过滤条件查询智能体运行时访问方式的资源列表。适用场景：根据标签条件查找对应的智能体运行时访问方式资源。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtime-endpoint
- [查询RuntimeEndpoint资源实例数量 - ShowCoreRuntimeEndpointNumsByTags](https://support.huaweicloud.com/api-agentarts/ShowCoreRuntimeEndpointNumsByTags.md): 该接口用于根据标签过滤条件查询智能体运行时访问方式的资源数量。适用场景：根据标签条件查找对应的智能体运行时访问方式资源数量。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtime-endpoi
- [批量为RuntimeEndpoint打资源标签 - BatchCreateCoreRuntimeEndpointTags](https://support.huaweicloud.com/api-agentarts/BatchCreateCoreRuntimeEndpointTags.md): 该接口用于批量为运行时访问方式打资源标签。适用场景：为运行时访问方式资源批量添加标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtime-endpoints/{endpoint_id}/t
- [批量删除RuntimeEndpoint资源标签 - BatchDeleteCoreRuntimeEndpointTags](https://support.huaweicloud.com/api-agentarts/BatchDeleteCoreRuntimeEndpointTags.md): 该接口用于批量删除运行时访问方式的资源标签。适用场景：为运行时访问方式资源批量删除标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。POST /v1/runtime-endpoints/{endpoint_id}/
- [查询RuntimeEndpoint标签列表 - ListCoreRuntimeEndpointTags](https://support.huaweicloud.com/api-agentarts/ListCoreRuntimeEndpointTags.md): 该接口用于查询运行时访问方式的资源标签。适用场景：查询运行时访问方式的资源标签。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/runtime-endpoints/{endpoint_id}/tags无
- [查询账号下所有RuntimeEndpoint标签列表 - ListAllCoreRuntimeEndpointTags](https://support.huaweicloud.com/api-agentarts/ListAllCoreRuntimeEndpointTags.md): 该接口用于查询本账号下所有运行时访问方式资源的标签列表。适用场景：查询账号下所有运行时访问方式资源的标签列表。请参见如何调用API。账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。GET /v1/runtime-endpoints/tags
- [使用API调用单/多智能体](https://support.huaweicloud.com/api-agentarts/agentarts_07_0045.md): 在AgentArts平台上开发完成智能体后，其最终目的是要融入企业的核心业务流中。为了实现上述集成，AgentArts提供了标准的RESTful API。完整的调用架构分为两步：认证鉴权：在AgentArts平台获取鉴权参数Authorization（新版AgentArts部署区域为西南-贵阳一，使用Authorization参数鉴权，而
- [使用API调用工作流](https://support.huaweicloud.com/api-agentarts/agentarts_07_0046.md): 在AgentArts平台上开发完成工作流后，其最终目的是要融入企业的核心业务流中。为了实现上述集成，AgentArts提供了标准的RESTful API。完整的调用架构分为两步：认证鉴权：在AgentArts平台获取鉴权参数Authorization（新版AgentArts部署区域为西南-贵阳一，使用Authorization参数鉴权，而
- [使用API调用图像理解工作流](https://support.huaweicloud.com/api-agentarts/agentarts_07_0048.md): 本案例中搭建一个图像理解工作流，实现通过多模态模型进行图像识别，并通过标准的RESTful API进行调用。工作流部署时采用API Key认证，API调用也采用该方法。图像理解工作流的搭建、参数配置和文本类工作流存在差异，详见步骤一：搭建图像理解工作流。使用API调用图像理解工作流时，图片约束如下：上传格式：.png、.jpg、.jpeg
- [使用API调用文档解析智能体](https://support.huaweicloud.com/api-agentarts/agentarts_07_0049.md): 在AgentArts平台上开发单智能体时，部分业务场景需要智能体具备文档理解能力，例如：合同审核场景中智能体需读取用户上传的合同文件并提取关键条款；技术文档分析场景中需对产品手册、接口文档进行结构化解析；报告生成场景中需先读取参考文档再进行内容总结。文档理解能力依赖智能体中挂载的文档解析插件或MCP实现。用户上传文档后，插件先完成文档解析
- [使用API调用文档解析工作流](https://support.huaweicloud.com/api-agentarts/agentarts_07_0050.md): 在AgentArts平台上开发工作流时，部分业务场景需要工作流具备文档理解能力，例如：合同审核场景中需读取用户上传的合同文件并提取关键条款。文档理解能力依赖工作流中的插件节点、MCP节点或代码节点等方式实现。工作流支持在开始节点定义File或Array<File>类型的文档参数，单文档时使用File类型；多文档时使用Array<File>
- [使用API调用单/多智能体（IAM认证）](https://support.huaweicloud.com/api-agentarts/agentarts_07_0052.md): 本案例介绍如何通过IAM认证（AK/SK签名）的方式，调用智能体的API接口。与API Key认证的主要区别：IAM认证使用您华为云账号的访问密钥（AK/SK）进行请求签名，无需在平台单独管理API Key，更适合企业级应用集成场景，权限管控由统一的IAM服务管理。根据华为云API网关（APIG）与AgentArts平台的认证鉴权规范，智
- [使用API调用观测/评估/沙箱/网关/记忆库/运行时接口](https://support.huaweicloud.com/api-agentarts/agentarts_07_0047.md): 此类接口与单/多智能体、工作流的调用方式有所差异。认证鉴权信息中的Authorization、X-Sdk-Date的值需要通过一个API签名SDK获取。这类接口的域名地址为：agentarts.cn-southwest-2.myhuaweicloud.com接口Header由三个参数构成：Authorization、X-Sdk-Date、
- [常见问题](https://support.huaweicloud.com/api-agentarts/agentarts_07_0051.md): 调用API时出现{"code":401,"data":null,"message":"Authorization failed!"}报错，表示Authorization失效，请重新获取。调用智能体/工作流接口：请参考步骤二：获取API调用凭证（获取Authorization）重新获取Authorization。调用观测/评估/沙箱/网关等
- [沙箱工具身份策略授权参考](https://support.huaweicloud.com/api-agentarts/Permission0.md): 云服务在IAM预置了常用的权限，称为系统身份策略。如果IAM系统身份策略无法满足授权要求，管理员可以根据各服务支持的授权项，创建IAM自定义身份策略来进行精细的访问控制，IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外，Organizations服务中的服务控制策略（Service Control Policy，以下简称S
- [网关身份策略授权参考](https://support.huaweicloud.com/api-agentarts/Permission1.md): 云服务在IAM预置了常用的权限，称为系统身份策略。如果IAM系统身份策略无法满足授权要求，管理员可以根据各服务支持的授权项，创建IAM自定义身份策略来进行精细的访问控制，IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外，Organizations服务中的服务控制策略（Service Control Policy，以下简称S
- [智能体运行时身份策略授权参考](https://support.huaweicloud.com/api-agentarts/Permission2.md): 云服务在IAM预置了常用的权限，称为系统身份策略。如果IAM系统身份策略无法满足授权要求，管理员可以根据各服务支持的授权项，创建IAM自定义身份策略来进行精细的访问控制，IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外，Organizations服务中的服务控制策略（Service Control Policy，以下简称S
- [观测身份策略授权参考](https://support.huaweicloud.com/api-agentarts/Permission3.md): 云服务在IAM预置了常用的权限，称为系统身份策略。如果IAM系统身份策略无法满足授权要求，管理员可以根据各服务支持的授权项，创建IAM自定义身份策略来进行精细的访问控制，IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外，Organizations服务中的服务控制策略（Service Control Policy，以下简称S
- [评估身份策略授权参考](https://support.huaweicloud.com/api-agentarts/Permission4.md): 云服务在IAM预置了常用的权限，称为系统身份策略。如果IAM系统身份策略无法满足授权要求，管理员可以根据各服务支持的授权项，创建IAM自定义身份策略来进行精细的访问控制，IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外，Organizations服务中的服务控制策略（Service Control Policy，以下简称S
- [状态码](https://support.huaweicloud.com/api-agentarts/agentarts_07_0016.md): 状态码如表1所示。
- [错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.md): 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。

## SDK参考

- [SDK概述](https://support.huaweicloud.com/sdk-agentarts/agentarts_11_0001.md): 本文介绍了AgentArts服务提供的SDK语言版本，列举了最新版本SDK的获取地址。API Explorer能根据需要动态生成SDK代码功能，降低您使用SDK的难度，推荐使用。您可以在API Explorer中具体API页面的“代码示例”页签查看对应编程语言类型的SDK代码。表1提供了AgentArts服务支持的SDK列表，您可以在Gi
- [隐私声明](https://support.huaweicloud.com/sdk-agentarts/agentarts_11_0002.md): 为完成华为云服务开放API调用的必要校验，SDK需要使用由华为云控制台下载的用户访问密钥（AK）进行签名，该过程不会上传您的私有密钥（SK）。本工具默认会在请求头User-Agent中附加额外信息，附加信息包括客户端调用服务时所使用的SDK语言、客户端库版本、操作系统、时区语言信息和一个随机标识符，上述信息将用于保护您及您的用户的华为云账

## 常见问题

- [单智能体应用与多智能体应用是否可以切换？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0002.md): 单智能体应用与多智能体应用之间不可切换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [工作流应用和多智能体应用有什么区别？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0003.md): 工作流应用是多智能体应用的组成元素，多智能体应用通过控制器可以执行多个工作流并根据用户输入意图在不同工作流之间跳转。工作流应用只是单工作流的运行。
- [在单智能体应用中使用工作流与在多智能体应用中使用工作流有什么区别？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0004.md): 多智能体应用可灵活管控工作流执行逻辑，通过控制器管理多个工作流，并根据用户意图在不同工作流间跳转。单智能体应用由大模型自主决策是否调用工具（含工作流）及调用哪个工具。
- [单智能体/工作流应用中的知识库检索策略为什么不一致？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0005.md): 知识库的检索策略是根据知识库本身的能力提供的。对于默认类型的知识库，支持语义检索、关键词检索、混合检索、FAQ检索；对于从第三方接入的知识库（RAGFlow），只支持语义检索。
- [单智能体应用与多智能体应用是否可以切换？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0002.md): 单智能体应用与多智能体应用之间不可切换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [工作流应用和多智能体应用有什么区别？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0003.md): 工作流应用是多智能体应用的组成元素，多智能体应用通过控制器可以执行多个工作流并根据用户输入意图在不同工作流之间跳转。工作流应用只是单工作流的运行。
- [在单智能体应用中使用工作流与在多智能体应用中使用工作流有什么区别？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0004.md): 多智能体应用可灵活管控工作流执行逻辑，通过控制器管理多个工作流，并根据用户意图在不同工作流间跳转。单智能体应用由大模型自主决策是否调用工具（含工作流）及调用哪个工具。
- [单智能体/工作流应用中的知识库检索策略为什么不一致？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0005.md): 知识库的检索策略是根据知识库本身的能力提供的。对于默认类型的知识库，支持语义检索、关键词检索、混合检索、FAQ检索；对于从第三方接入的知识库（RAGFlow），只支持语义检索。
- [为什么在单智能体中无法添加知识库？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0007.md): 在单智能体添加知识库界面，没有找到自己创建的知识库，无法添加知识库。单智能体模式中添加知识库时，需要确保知识库已启用，未启用的知识库无法添加。将未启用的知识库启用后，即可在单智能体中添加该知识库。
- [为什么单智能体模式有的工作流无法添加？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0009.md): 创建工作流后，在单智能体添加工作流界面，无法添加。工作流必须已发布才能被单智能体添加，未发布的工作流无法在单智能体添加工作流界面查找到并添加。将未发布的工作流提交发布后，即可在单智能体中添加该工作流。在左侧导航栏中选择开发中心 > 智能体管理，单击“单智能体”页签，进入单智能体应用管理界面。单击目标单智能体应用，在应用配置页签中，单击工作
- [单智能体模式支持上传文件吗？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0011.md): 单智能体支持上传文件，目前单智能体模式支持图片文件、音频文件和文档文件等。支持上传image、audio、excel、csv、docx等格式的文件。最多支持上传10个文件。
- [与单智能体交互时，能否看到给大模型的原始输入？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0012.md): 在单智能体交互界面，单击右上角的调试按钮，可以回溯您与大模型的原始输入记录。支持查看会话的运行结果与调用详情。
- [为什么在单智能体中无法添加知识库？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0007.md): 在单智能体添加知识库界面，没有找到自己创建的知识库，无法添加知识库。单智能体模式中添加知识库时，需要确保知识库已启用，未启用的知识库无法添加。将未启用的知识库启用后，即可在单智能体中添加该知识库。
- [为什么单智能体模式有的工作流无法添加？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0009.md): 创建工作流后，在单智能体添加工作流界面，无法添加。工作流必须已发布才能被单智能体添加，未发布的工作流无法在单智能体添加工作流界面查找到并添加。将未发布的工作流提交发布后，即可在单智能体中添加该工作流。在左侧导航栏中选择开发中心 > 智能体管理，单击“单智能体”页签，进入单智能体应用管理界面。单击目标单智能体应用，在应用配置页签中，单击工作
- [单智能体模式支持上传文件吗？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0011.md): 单智能体支持上传文件，目前单智能体模式支持图片文件、音频文件和文档文件等。支持上传image、audio、excel、csv、docx等格式的文件。最多支持上传10个文件。
- [与单智能体交互时，能否看到给大模型的原始输入？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0012.md): 在单智能体交互界面，单击右上角的调试按钮，可以回溯您与大模型的原始输入记录。支持查看会话的运行结果与调用详情。
- [工作流中知识检索运行失败：Plugin restful api response http code error, root cause = plugin response code 404 error.](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0019.md): 执行报错，错误码：105011，错误信息：Plugin restful api response http code error, root cause = plugin response code 404 error.，请参考产品文档解决或联系系统管理员。配置的知识库不存在。在知识检索节点中重新添加其他可用的知识库即可解决。
- [对话型工作流、任务型工作流是否可以相互转换？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0020.md): 对话型工作流与任务型工作流之间不可相互转换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [为什么提问器提取问题答案不准确？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0021.md): 在工作流中提问器提取问题答案不准确。问题不明确，提示词不适配。在提问器节点中补充配置校验、提取约束（提示词）、示例等参数使提取更准确。
- [为什么在工作流中配置了大模型却没有内容输出？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0022.md): 工作流中增加了大模型组件，但没有内容输出。模型提示词配置不正确或模型输出未被输出节点（消息节点、结束节点）使用。检查大模型提示词配置是否正确，并确保大模型输出参数被输出型节点（如消息节点、结束节点）引用。
- [大模型节点如何输出多个参数？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0023.md): 在使用大模型节点时，如果需要输出多个参数，应如何配置节点实现输出多个参数？大模型节点通常默认配置输出为文本格式，为了实现多参数输出，需要对节点的输出配置进行调整，以确保大模型能够正确解析和输出多个参数。在大模型节点的输出参数中选择JSON模式，并在提示词中明确多参数输出指令即可实现。
- [工作流中知识检索运行失败：Plugin restful api response http code error, root cause = plugin response code 404 error.](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0019.md): 执行报错，错误码：105011，错误信息：Plugin restful api response http code error, root cause = plugin response code 404 error.，请参考产品文档解决或联系系统管理员。配置的知识库不存在。在知识检索节点中重新添加其他可用的知识库即可解决。
- [对话型工作流、任务型工作流是否可以相互转换？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0020.md): 对话型工作流与任务型工作流之间不可相互转换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [为什么提问器提取问题答案不准确？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0021.md): 在工作流中提问器提取问题答案不准确。问题不明确，提示词不适配。在提问器节点中补充配置校验、提取约束（提示词）、示例等参数使提取更准确。
- [为什么在工作流中配置了大模型却没有内容输出？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0022.md): 工作流中增加了大模型组件，但没有内容输出。模型提示词配置不正确或模型输出未被输出节点（消息节点、结束节点）使用。检查大模型提示词配置是否正确，并确保大模型输出参数被输出型节点（如消息节点、结束节点）引用。
- [大模型节点如何输出多个参数？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0023.md): 在使用大模型节点时，如果需要输出多个参数，应如何配置节点实现输出多个参数？大模型节点通常默认配置输出为文本格式，为了实现多参数输出，需要对节点的输出配置进行调整，以确保大模型能够正确解析和输出多个参数。在大模型节点的输出参数中选择JSON模式，并在提示词中明确多参数输出指令即可实现。
- [创建第三方知识库时为什么查不到知识库列表？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0027.md): 创建第三方知识库时为什么查不到知识库列表？原因1：第三方知识库平台中未创建知识库。原因2：第三方知识库连接信息配置有误。原因1解决方案：需在第三方知识库平台创建知识库。原因2解决方案：登录AgentArts智能体平台。在左侧导航栏中选择“开发中心 > 组件库”，选择知识库页签。在“知识库”页面，单击第三方知识库连接，找到要接入的第三方知识
- [第三方知识库连接中的已启用/已停用状态如何更改？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0028.md): 在第三方知识库连接中，已启用状态表示已从此连接中接入了一个或多个知识库，已停用状态表示还未从此连接中接入过知识库，两个状态为自动切换，无需用户手工操作。当您想要删除某个外部知识库连接时，需要先把此知识库连接中的知识库从知识库列表中全部取消接入，使此外部知识库连接变为已停用状态，才可以继续删除。
- [创建第三方知识库时为什么查不到知识库列表？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0027.md): 创建第三方知识库时为什么查不到知识库列表？原因1：第三方知识库平台中未创建知识库。原因2：第三方知识库连接信息配置有误。原因1解决方案：需在第三方知识库平台创建知识库。原因2解决方案：登录AgentArts智能体平台。在左侧导航栏中选择“开发中心 > 组件库”，选择知识库页签。在“知识库”页面，单击第三方知识库连接，找到要接入的第三方知识
- [第三方知识库连接中的已启用/已停用状态如何更改？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0028.md): 在第三方知识库连接中，已启用状态表示已从此连接中接入了一个或多个知识库，已停用状态表示还未从此连接中接入过知识库，两个状态为自动切换，无需用户手工操作。当您想要删除某个外部知识库连接时，需要先把此知识库连接中的知识库从知识库列表中全部取消接入，使此外部知识库连接变为已停用状态，才可以继续删除。
- [在插件中使用IP地址，为什么会调试失败？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0030.md): 在插件中使用IP地址请求可能会被服务端的网络安全设置拦截。因此建议在配置插件的URL或抓取类插件的参数URL时，使用域名而非IP地址。
- [如何配置插件请求参数中的默认值？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0031.md): 配置请求参数的默认值可有效避免大模型运行时因插件参数值缺失而导致的报错。同时，针对值较为稳定的参数，设置其默认值且隐藏其可见性可减少大模型的无效判断，从而提高插件调用效率。您可以在插件工具的请求头（Header）、请求体（Body）和查询参数（Query）中添加参数并配置默认值。下面以在请求头（Header）中为参数配置默认值为例。API
- [插件的输入参数支持图片格式吗？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0032.md): 当请求体的数据格式是form-data时，支持上传图片格式的文件。
- [工作流添加插件节点执行报错？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0033.md): 用户配置新插件并添加到工作流中时，执行报错。在组件库中调测插件确认功能正常，再检查工作流中插件节点的输入参数是否符合插件要求。
- [在插件中使用IP地址，为什么会调试失败？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0030.md): 在插件中使用IP地址请求可能会被服务端的网络安全设置拦截。因此建议在配置插件的URL或抓取类插件的参数URL时，使用域名而非IP地址。
- [如何配置插件请求参数中的默认值？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0031.md): 配置请求参数的默认值可有效避免大模型运行时因插件参数值缺失而导致的报错。同时，针对值较为稳定的参数，设置其默认值且隐藏其可见性可减少大模型的无效判断，从而提高插件调用效率。您可以在插件工具的请求头（Header）、请求体（Body）和查询参数（Query）中添加参数并配置默认值。下面以在请求头（Header）中为参数配置默认值为例。API
- [插件的输入参数支持图片格式吗？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0032.md): 当请求体的数据格式是form-data时，支持上传图片格式的文件。
- [工作流添加插件节点执行报错？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0033.md): 用户配置新插件并添加到工作流中时，执行报错。在组件库中调测插件确认功能正常，再检查工作流中插件节点的输入参数是否符合插件要求。
- [平台预置模型](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0000.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [免费额度](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0052.md): 免费额度用完了怎么办免费额度用完后，需要配置华为云MaaS服务的模型API Key，具体操作请参见接入华为云MaaS服务付费模型。免费额度用完后，需要配置华为云MaaS服务的模型API Key，具体操作请参见接入华为云MaaS服务付费模型。开通后不使用会收费吗免费额度仅用于模型调测、智能体试运行。不使用则不产生费用。超出免费额度或智能体部
- [付费模型](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0053.md): API Key忘记了怎么办？API Key仅在创建时显示一次。如果丢失，需要在MaaS控制台重新创建一个API Key，然后在AgentArts中更新鉴权配置。API Key仅在创建时显示一次。如果丢失，需要在MaaS控制台重新创建一个API Key，然后在AgentArts中更新鉴权配置。免费额度用完后，不配置鉴权会怎样？模型将无法调测
- [自定义模型](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0054.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [接入的外部模型无法使用？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0056.md): 请依次检查以下事项：API Key是否正确粘贴，无多余空格或换行符。DeepSeek账户是否有可用余额。模型服务API地址是否填写正确（https://api.deepseek.com/chat/completions）。模型名称参数是否填写了正确的模型编码（如deepseek-chat），而非自定义名称。API Key是否正确粘贴，无多
- [接入后调测，模型无返回结果或者报错怎么办？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0057.md): API Key填写错误，如多填写了Bearer前缀。API Key本身已过期或无效，需要到模型服务商官网确认API Key状态，必要时重新生成。
- [API地址应该填基础路径还是完整路径？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0058.md): 需要填入模型服务商文档中给出的完整API地址，例如：模型API地址示例模型服务商API地址示例DeepSeekhttps://api.deepseek.com/chat/completions智谱https://open.bigmodel.cn/api/paas/v4/chat/completions不同模型服务商的路径结构不同（如智谱是
- [接入自建模型需要注意什么？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0059.md): “模型名称”字段必须与模型服务商定义的模型名称完全一致，该值会直接作为接口请求体中model字段的值。随意填写会导致模型不可用。模型名称需要到模型服务商官网查看，注意大小写和分隔符必须完全匹配。
- [可以接入本地部署的模型吗？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0060.md): 可以，但需要确保：模型API对AgentArts平台可达（公网可访问）。API符合AgentArts平台的模型对接协议。模型API对AgentArts平台可达（公网可访问）。API符合AgentArts平台的模型对接协议。
- [免费额度](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0052.md): 免费额度用完了怎么办免费额度用完后，需要配置华为云MaaS服务的模型API Key，具体操作请参见接入华为云MaaS服务付费模型。免费额度用完后，需要配置华为云MaaS服务的模型API Key，具体操作请参见接入华为云MaaS服务付费模型。开通后不使用会收费吗免费额度仅用于模型调测、智能体试运行。不使用则不产生费用。超出免费额度或智能体部
- [付费模型](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0053.md): API Key忘记了怎么办？API Key仅在创建时显示一次。如果丢失，需要在MaaS控制台重新创建一个API Key，然后在AgentArts中更新鉴权配置。API Key仅在创建时显示一次。如果丢失，需要在MaaS控制台重新创建一个API Key，然后在AgentArts中更新鉴权配置。免费额度用完后，不配置鉴权会怎样？模型将无法调测
- [免费额度](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0052.md): 免费额度用完了怎么办免费额度用完后，需要配置华为云MaaS服务的模型API Key，具体操作请参见接入华为云MaaS服务付费模型。免费额度用完后，需要配置华为云MaaS服务的模型API Key，具体操作请参见接入华为云MaaS服务付费模型。开通后不使用会收费吗免费额度仅用于模型调测、智能体试运行。不使用则不产生费用。超出免费额度或智能体部
- [付费模型](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0053.md): API Key忘记了怎么办？API Key仅在创建时显示一次。如果丢失，需要在MaaS控制台重新创建一个API Key，然后在AgentArts中更新鉴权配置。API Key仅在创建时显示一次。如果丢失，需要在MaaS控制台重新创建一个API Key，然后在AgentArts中更新鉴权配置。免费额度用完后，不配置鉴权会怎样？模型将无法调测
- [接入的外部模型无法使用？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0056.md): 请依次检查以下事项：API Key是否正确粘贴，无多余空格或换行符。DeepSeek账户是否有可用余额。模型服务API地址是否填写正确（https://api.deepseek.com/chat/completions）。模型名称参数是否填写了正确的模型编码（如deepseek-chat），而非自定义名称。API Key是否正确粘贴，无多
- [接入后调测，模型无返回结果或者报错怎么办？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0057.md): API Key填写错误，如多填写了Bearer前缀。API Key本身已过期或无效，需要到模型服务商官网确认API Key状态，必要时重新生成。
- [API地址应该填基础路径还是完整路径？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0058.md): 需要填入模型服务商文档中给出的完整API地址，例如：模型API地址示例模型服务商API地址示例DeepSeekhttps://api.deepseek.com/chat/completions智谱https://open.bigmodel.cn/api/paas/v4/chat/completions不同模型服务商的路径结构不同（如智谱是
- [接入自建模型需要注意什么？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0059.md): “模型名称”字段必须与模型服务商定义的模型名称完全一致，该值会直接作为接口请求体中model字段的值。随意填写会导致模型不可用。模型名称需要到模型服务商官网查看，注意大小写和分隔符必须完全匹配。
- [可以接入本地部署的模型吗？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0060.md): 可以，但需要确保：模型API对AgentArts平台可达（公网可访问）。API符合AgentArts平台的模型对接协议。模型API对AgentArts平台可达（公网可访问）。API符合AgentArts平台的模型对接协议。
- [接入的外部模型无法使用？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0056.md): 请依次检查以下事项：API Key是否正确粘贴，无多余空格或换行符。DeepSeek账户是否有可用余额。模型服务API地址是否填写正确（https://api.deepseek.com/chat/completions）。模型名称参数是否填写了正确的模型编码（如deepseek-chat），而非自定义名称。API Key是否正确粘贴，无多
- [接入后调测，模型无返回结果或者报错怎么办？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0057.md): API Key填写错误，如多填写了Bearer前缀。API Key本身已过期或无效，需要到模型服务商官网确认API Key状态，必要时重新生成。
- [API地址应该填基础路径还是完整路径？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0058.md): 需要填入模型服务商文档中给出的完整API地址，例如：模型API地址示例模型服务商API地址示例DeepSeekhttps://api.deepseek.com/chat/completions智谱https://open.bigmodel.cn/api/paas/v4/chat/completions不同模型服务商的路径结构不同（如智谱是
- [接入自建模型需要注意什么？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0059.md): “模型名称”字段必须与模型服务商定义的模型名称完全一致，该值会直接作为接口请求体中model字段的值。随意填写会导致模型不可用。模型名称需要到模型服务商官网查看，注意大小写和分隔符必须完全匹配。
- [可以接入本地部署的模型吗？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0060.md): 可以，但需要确保：模型API对AgentArts平台可达（公网可访问）。API符合AgentArts平台的模型对接协议。模型API对AgentArts平台可达（公网可访问）。API符合AgentArts平台的模型对接协议。
- [登录时提示：成员数已达套餐上限，暂无法加入](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0065.md): 用户登录AgentArts后，提示“成员数已达套餐上限，暂无法加入”。套餐包对用户的数量有限制，例如，AgentArts体验版支持2个用户，即一个账号下仅允许2个用户登录访问。将用户ID（如图2所示）提供给主账号，主账号在“系统管理 > 成员许可”页面，释放已占用的许可，然后为该用户分配许可，具体操作请参考管理使用AgentArts的成员
- [登录时提示：成员数已达套餐上限，暂无法加入](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0065.md): 用户登录AgentArts后，提示“成员数已达套餐上限，暂无法加入”。套餐包对用户的数量有限制，例如，AgentArts体验版支持2个用户，即一个账号下仅允许2个用户登录访问。将用户ID（如图2所示）提供给主账号，主账号在“系统管理 > 成员许可”页面，释放已占用的许可，然后为该用户分配许可，具体操作请参考管理使用AgentArts的成员
- [如何进入统一身份认证服务（新版）控制台？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0064.md): AgentArts对接统一身份认证服务（新版），访问地址：https://console.huaweicloud.com/iam5/#/overview。从控制台直接跳转至统一身份认证服务，默认跳转到统一身份认证服务（旧版）。可通过以下两种方式进入统一身份认证服务（新版）：方式一：通过切换入口进入在弹窗提示页面单击“立即体验”，或者在页面
- [如何进入统一身份认证服务（新版）控制台？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0064.md): AgentArts对接统一身份认证服务（新版），访问地址：https://console.huaweicloud.com/iam5/#/overview。从控制台直接跳转至统一身份认证服务，默认跳转到统一身份认证服务（旧版）。可通过以下两种方式进入统一身份认证服务（新版）：方式一：通过切换入口进入在弹窗提示页面单击“立即体验”，或者在页面