# 智能体开发平台（华北-北京四）


## 产品介绍

- [什么是智果（AgentArts）智能体平台](https://support.huaweicloud.com/productdesc-agentarts0/agentarts_03_0002.md): 随着人工智能技术的快速发展，尤其是大模型的突破，越来越多的企业和开发者致力于构建能够自主感知、决策与执行任务的智能体（Agent）。但开发一个功能完整、稳定可靠的智能体面临诸多挑战，例如缺乏统一的开发框架和调试工具，从原型设计到部署的工程链路复杂，开发门槛高且周期长等，为解决上述问题，智果（AgentArts）智能体平台应运而生。智果（A
- [订阅套餐](https://support.huaweicloud.com/productdesc-agentarts0/agentarts_03_0003.md): AgentArts推出基础版和企业版两大版本，满足多样化业务需求，其中基础版限时免费。基础版与企业版为独立订阅体系。一个账号支持同时购买基础版和企业版，当您同时拥有基础版和企业版时，系统将优先启用企业版。待企业版服务到期后，系统将自动回退至基础版（限时免费），确保您的使用不受中断。各个订阅套餐的规格不同，具体说明如表2所示。其中，√表示支
- [资产广场](https://support.huaweicloud.com/productdesc-agentarts0/agentarts_03_0028.md): 资产广场是AgentArts的资源库，提供开箱即用的应用模板和标准化的组件资产，赋能开发者以“搭积木”的方式高效构建智能体。在资产广场中，您可以根据构建需求，灵活选择并复用核心资产：应用模板、模型、MCP、插件、提示词、知识库。“应用模板”页面汇集了官方预置及团队共享的高频场景应用模板，预置的模板覆盖客服、通用、政务、信息处理、营销、陪伴
- [基本概念](https://support.huaweicloud.com/productdesc-agentarts0/agentarts_03_0010.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 开始使用

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

## 计费说明

- [免费套餐](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0001.md): AgentArts服务提供了AgentArts基础版（限时免费），适用于开发者体验产品功能。具体规格请参考表1。
- [计费概述](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0002.md): 通过阅读本文，您可以快速了解AgentArts服务的计费模式、计费项等主要计费信息。计费模式AgentArts服务提供限时免费、包年包月计费模式，以满足不同场景下的用户需求。限时免费是一个周期内用户无需付费即可使用的免费资源。包年/包月是一种预付费模式，即先付费再使用，按照订单的购买周期进行结算，因此在购买之前，您必须确保账户余额充足。A
- [计费项](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0003.md): AgentArts服务根据购买的套餐包计费。具体内容如表1所示。以包年/包月计费模式为例，假设您在2025/11/08 15:50:04购买了包年/包月AgentArts企业版。购买时长为一个月，并在到期前手动续费1个月，则：第一个计费周期为：2025/11/08 15:50:04 ~ 2025/12/08 23:59:59第二个计费周期
- [计费模式概述](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0005.md): AgentArts服务提供限时免费、包年/包月计费模式，以满足不同场景下的用户需求。限时免费：一个周期内用户无需付费即可使用的免费资源。适用于了解、试用AgentArts服务。包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。表1列出了两种计费模式
- [包年/包月](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0006.md): 包年/包月是一种先付费再使用的计费模式，适用于对资源需求稳定且希望降低成本的用户。通过选择包年/包月的计费模式，您可以预先购买AgentArts服务资源并获得一定程度的价格优惠。本文将介绍包年/包月AgentArts套餐包的计费规则。包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计
- [变更计费模式](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0007.md): 如果当前AgentArts基础版（限时免费）计费模式不满足业务需求，可以升级为AgentArts企业版。升级后AgentArts基础版和AgentArts企业版时存在，系统将优先使用AgentArts企业版。待AgentArts企业版服务到期后，系统使用AgentArts基础版，确保您的使用不受中断。支付完成后，系统会提示“订单支付成功”
- [续费概述](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0009.md): 包年/包月套餐包到期后会影响AgentArts正常运行。如果您想继续使用，需要在指定的时间内为AgentArts服务续费。续费操作适用于包年/包月套餐包，只需要保证账户余额充足即可。套餐包在到期前续费成功，所有资源得以保留，且AgentArts的运行不受影响。套餐包到期后的状态说明，请参见到期后影响。包年/包月云套餐包续费相关的功能如表1
- [手动续费](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0010.md): 包年/包月套餐包从购买到被自动删除之前，您可以随时在费用中心进行续费，以延长套餐包的使用时间。可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源，对资源进行手动续费的操作。所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动续费。单个续费：在资源页面找到需要续费的资源，在
- [自动续费](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0011.md): 自动续费可以减少手动续费的管理成本，避免因忘记手动续费而导致AgentArts资源被自动删除。自动续费的规则如下所述：以AgentArts套餐包的到期日计算第一次自动续费日期和计费周期。AgentArts自动续费周期以您选择的续费时长为准。例如，您选择了3个月，AgentArts即在每次到期前自动续费3个月。在AgentArts到期前均可
- [费用账单](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0012.md): 您可以在“费用中心 > 账单管理”查看资源的费用账单，以了解该资源在某个时间段的使用量和计费信息。包年/包月计费模式的资源完成支付后，会实时上报一条账单到计费系统进行结算。用户如果需要查看应用平台 AppStage（AgentArts）服务的费用明细，可以参考账单管理的“流水与明细账单”完成。
- [停止计费](https://support.huaweicloud.com/price-agentarts0/agentarts_08_0013.md): 用户在购买时会一次性付费，服务将在到期后自动停止使用。如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭

## 用户指南

- [AgentArts选型指南](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0279.md): 为满足从简单对话到复杂业务自动化的多样化需求，AgentArts提供了三种核心应用构建模式：单智能体、工作流和多智能体。在开始搭建AI应用之前，你需要回答一个核心问题："我的任务，应该交给一个人做，一条流水线做，还是一个团队做？"平台提供了三种核心开发模式，它们的关系如表1所示。单智能体单智能体是最基础的AI应用形态，一个单智能体能独立完
- [AgentArts使用流程](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0001.md): AgentArts是一个企业级一站式智能体构建与运营平台。它打破了传统开发壁垒，支持Agent开发人员通过可视化、低代码的方式，快速搭建从简单助手到复杂业务流的各类AI应用。
- [单智能体应用介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0012.md): 单智能体（Single Agent）是一个独立运作的AI实体，能自主感知环境、规划决策并执行任务，全程无需其他智能体协作。其核心特点是集中化处理，适用于目标明确、复杂度较低的场景（如客服机器人、游戏NPC）。单智能体应用适合处理简单独立任务，如果有固定的任务执行流程，高准确率要求，可以选择工作流应用，具体请参见开发工作流应用；如果需要处理
- [示例：搭建一个医疗问诊助手智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0013.md): 随着人工智能技术的不断进步，大模型在医疗领域的应用逐渐成熟。通过结合医学知识库、自然语言处理和智能交互技术，医疗问诊助手智能体能够为患者提供初步的健康咨询、症状分析和诊断建议，同时减轻医生的工作负担，提升医疗服务效率。本教程将指导你如何在AgentArts智能体开发平台上搭建一个医疗问诊助手，用于获取健康建议。与医疗问诊助手进行对话时，可
- [创建单智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0016.md): 通过创建单智能体，您可以快速构建一个高效、灵活的自动化解决方案，满足用户的特定需求。无论是处理复杂任务还是简化日常操作，智能体都能帮助用户实现目标。AgentArts支持创建单智能体应用的方式如表1所示。不同套餐包允许创建的应用数量不同，具体可参考计费模式。已开通AgentArts服务。模型已接入AgentArts平台，接入指导请参考模型
- [选择并配置模型](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0017.md): 在AgentArts中，创建智能体后配置模型是构建和优化智能应用的关键操作，用户可以通过可视化配置页面选择和集成多种大语言模型，如DeepSeek、千问等。通过灵活选择和配置不同大语言模型，确保智能体能够根据业务需求高效、稳定地提供强大的AI能力。AgentArts已接入模型。接入模型服务详见模型。登录用户为空间所有者、空间管理员、开发工
- [配置提示词](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0018.md): 在搭建Agent应用的过程中，设置提示词是至关重要的一步。提示词是一种自然语言指令，用于指导大语言模型（LLM）如何完成特定任务。例如，在写作小说的场景中，提示词可以是请生成一个悬疑小说的开篇，营造紧张的氛围，描述主角在雨夜进入一座废弃的别墅。提示词的作用在于为模型提供明确的任务目标，规范输出格式，优化生成内容，并支持个性化需求。通过精心
- [添加MCP服务](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0021.md): Agent工具调用支持MCP协议，并提供了一个丰富的MCP服务生态系统，以增强智能体的功能。MCP是一种开放协议，它规范了应用程序向大语言模型提供上下文的方式，平台集成了“高德地图”、“车票查询工具”、“必应搜索”等多种实用MCP服务，开通后可以一键集成调用。此外，平台还支持创建自定义MCP服务，开发者可依据MCP服务地址快速创建MCP服
- [添加插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0022.md): AgentArts提供了一个丰富的插件生态系统，以增强智能体的能力。插件是一种工具集，一个插件即是一个API工具。目前，AgentArts集成了类型丰富的插件，包括OCR识别、文件处理、代码解释器、全网热搜榜、高德地图等工具，这些插件能够帮助开发者快速为智能体添加特定功能。此外，平台还支持创建自定义插件，允许开发者将已有的API能力通过参
- [添加工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0023.md): 工作流是AgentArts中用于设计和实现复杂任务自动化的核心工具。通过任务编排、条件判断以及多种组件的协同功能，工作流帮助开发者高效处理复杂任务。工作流中包含大模型节点、知识检索节点、意图识别节点、判断节点、代码节点等多种节点，每个节点都具有特定的功能，能够处理数据、执行任务和运行算法。通过可视化设计，开发者可以清晰地看到数据的流转过程
- [为应用添加知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0025.md): 知识库是Agent中用于存储、管理和检索领域知识的核心组件，它通过结构化存储、智能检索以及动态更新机制，为Agent提供高匹配的信息支持。为智能体添加知识库，能够提供准确的知识支持，增强大模型回答的可靠性和专业性。知识库有助于智能体减少错误信息的生成，提高对复杂查询的处理能力。知识库支持doc、pdf、pptx、xlsx、csv等多种格式
- [为应用添加记忆](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0026.md): 在多轮对话场景中，用户往往期望智能体能够记住自己的偏好、身份和交互习惯，从而获得连贯且个性化的服务体验。在单智能体配置中，支持通过配置变量为应用开启“记忆”功能。AgentArts提供以下记忆类型，满足不同场景下的记忆需求：用户变量：存储用户属性与偏好（如姓名、语言习惯、关注领域），支持自动识别提取、跨会话持久化和动态更新。入参变量：通过
- [提升应用对话体验](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0027.md): 开场白是用户进入智能体应用后首先看到的引导信息，能够帮助用户迅速了解智能体应用的功能和用途，明确如何与智能体应用进行有效交互。开场白需要简洁明了，语气友好并且表述清晰。在“对话体验 > 开场白”中，可填写开场白，也可单击“智能添加 > 确定”按钮智能添加开场白。例如，“您好！我是您的智能助手，很高兴为您提供帮助。请告诉我，今天有什么我可以
- [调试应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0028.md): 开发者可以在智能体应用搭建完成后，直接与智能体应用进行对话，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。平台全链路调试功能，允许开发者查看每个用户请求从输入到响应的完整流程，包括意图识别、知识检索等详细信息，从而准确定位问题并快速调整配置。创建应用后，平台支持对应用执行过程进行预览调试。预览调试界面支持文本输入、语音输入
- [配置触发器](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0029.md): 触发器是Agent中实现任务自动化的关键功能，它能够在特定条件下自动启动任务执行，无需人工干预。可以利用触发器灵活设置任务的启动条件，触发器能确保任务按时按需完成，从而提高Agent应用的自动化水平和响应速度。通过定时任务调用应用按照触发指令要求执行任务。
- [发布应用为API服务](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0031.md): 将Agent应用发布为API服务后，可以通过调用OpenAPI的方式使用Agent程序。本文介绍如何将开发完成的Agent应用发布为API服务。已开通AgentArts服务。已创建单智能体应用。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。已发布的应用支持在Agent应用编辑页面选择更新版本按钮重新发布应用
- [发布应用为网页应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0032.md): AgentArts支持将Agent应用发布为网页应用，这一功能适用于多种场景。例如，在客户服务领域，可以将智能客服Agent部署为网页应用，提供全天候的在线咨询服务，提升客户满意度。在教育和培训中，可以将教学助手Agent部署为网页应用，为学生提供个性化的学习指导和互动体验。在智能问答系统中，可以将知识库查询Agent部署为网页应用，为用
- [发布应用至云商店](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0034.md): 将Agent应用发布到云商店后，生成OpenAPI URL，用户可以在华为云云商店通过调用OpenAPI URL，即可将应用发布到华为云云商店。已开通AgentArts服务。已创建单智能体应用。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。也可通过左侧导航栏中选择开发中心 > 智能体管理，单击目标应用，进入
- [通过API调用单智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0038.md): AgentArts提供Open API请求方式，可通过调用路径发送请求，程序将调用应用并返回预期结果。AgentArts的API调用是应用开发中的强大工具，可以帮助用户快速集成功能和服务，同时支持与其他系统或服务进行交互，提升应用性能和用户体验。合理设计和管理API是确保应用安全和稳定的关键。通过API，用户可以构建功能丰富、高效的应用，
- [管理应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0039.md): 在AgentArts中创建应用之后，可以管理单智能体应用界面中的应用，可执行删除、复制创建的应用、复制应用ID、导入、导出及查看调用路径等。在复制到目标空间时，应用的配置参数、插件等数据将一并复制，且复制后的应用需要单独发布。只有应用的所有者可以删除应用。删除应用时虽然不会同步删除应用资源库中的所有资源，但不可恢复，请谨慎操作。对于Age
- [工作流介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0041.md): 工作流是一系列相互关联的步骤，用于实现业务逻辑或完成特定任务。它为应用/智能体的数据流动和任务处理提供了一个结构化框架。工作流的核心是一个由人工设计和编排的智能系统，由多个AI Agent通过利用自然语言处理（NLP）和大型语言模型（LLM）协作完成任务。这些智能体在预设的逻辑框架下工作，能够根据既定规则自主感知、推理和行动，以追求特定目
- [对话型工作流和任务型工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0042.md): 平台提供了两种类型的工作流，即对话型工作流和任务型工作流，用户可以针对不同的任务或场景选择适合的工作流进行搭建。对话型工作流：面向多轮交互的开放式问答场景，基于用户对话内容提取关键信息，输出最终结果。适用于客服助手、工单助手、娱乐互动等场景。任务型工作流：面向自动化处理场景，基于输入内容直接输出结果，无中间的对话交互过程。适用于内容生成、
- [工作流使用限制](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0043.md): 工作流是一系列相互关联的步骤，用于实现业务逻辑或完成特定任务。在使用过程中注意以下限制。
- [工作流编排逻辑](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0046.md): 业务逻辑是指应用程序中处理特定业务规则和操作的部分。它定义了应用如何根据业务需求处理数据、执行操作和做出决策。在AgentArts中，业务逻辑的实现主要通过工作流来完成。在AgentArts中，左侧的资产广场、组件库中的插件、MCP、知识库、提示词、开发配置中的模型等都称为资源。在工作流中，可以根据业务处理逻辑、业务数据等信息添加或创建资
- [创建工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0047.md): 工作流是一系列相互关联的步骤，用于实现业务逻辑或完成特定任务。可以在智能体和应用搭建中通过工作流实现特定的任务或指令。无论是在智能体还是应用中使用工作流，都需要先创建一个可运行的工作流。AgentArts支持创建工作流应用的方式如表1所示。不同套餐包允许创建的应用数量不同，具体可参考计费模式。已开通AgentArts服务。模型已接入Age
- [试运行工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0051.md): 开发者可以在工作流创建完成后，直接与工作流进行交互，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。平台提供的全链路调试功能，允许开发者查看每条用户请求从输入到响应的完整流程，包括意图识别、知识检索等详细信息，从而能够高效定位问题并快速调整配置。AgentArts支持对整个工作流进行调试，也支持对工作流的单个节点进行调试。已
- [配置触发器](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0052.md): 触发器是工作流中实现任务自动化的关键功能，它能够在特定条件下自动启动任务执行，无需人工干预。可以利用触发器灵活设置任务的启动条件，触发器能确保任务按时按需完成，从而提高工作流应用的自动化水平和响应速度。通过定时任务调用应用按照触发指令执行任务。
- [发布工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0053.md): 工作流试运行成功后，可对其进行发布，便于后续使用，如在单智能体应用中添加工作流，添加工作流。工作流已调试完成，具体请参见试运行工作流。在网页发布渠道的操作列单击发布按钮后将出现立即访问、复制链接、重新生成文字按钮。这里可以通过两种方式访问工作流应用的网页应用链接，同时支持重新生成发布链接。发布工作流立即访问：单击当前页面的立即访问按钮，可
- [通过API调用工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0055.md): 工作流发布成功后，可以使用API调用该工作流。须确保工作流已发布，详情可参考发布工作流。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。其中，“f2d9736e-9f7a-41b5-b3fb-5802b347b390”是随机生成的字符串，在使用时可以替换为其他的字符串。字符串长度为1~64个字符，支持英文字母
- [在单智能体应用中使用工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0056.md): 工作流功能是实现单智能体应用业务逻辑的核心部分。它定义了应用的输入和输出数据结构、数据接收与处理规则，以及决策流程。通过工作流，单智能体应用能够支持添加工作流技能，允许用户通过画布编排的方式，组合使用插件、大模型等不同节点，从而实现复杂且稳定的业务流程编排。简单业务：应用中至少有一个试运行通过的工作流，作为应用的业务处理流程。复杂任务：如
- [在多智能体应用中使用工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0057.md): 可通过工作流功能来实现多智能体应用的业务逻辑部分。工作流决定了应用的输入和输出的数据结构、接收和处理数据的规则以及决策流程，是智能体应用的核心部分。多智能体应用通过添加工作流技能，对用户的会话进行意图分析，路由到不同的子工作流执行编排好的任务。须确保工作流已发布，详情可参考发布工作流。登录用户为空间所有者、空间管理员、开发工程师，详细信息
- [管理工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0058.md): Agentarts平台致力于提供高效、灵活的工作流管理解决方案。除了支持Agentarts工作流的导入导出，为了提升用户体验，Agentarts现支持Dify工作流的导入功能。用户可以轻松将现有的Dify工作流文件导入平台，在导入工作流时，将同步导入与工作流关联的插件等配置，实现无缝对接和高效管理。无论是复杂业务流程还是简单任务自动化，A
- [开始节点](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0060.md): 开始节点用于开启触发一个工作流，结束节点用于返回一个工作流的最终结果。开始节点是工作流的“感知边界”与“数据入口”。它定义了工作流启动时需要接收哪些外部信息（是接收一段文字、一个文件，还是一个特定的参数）。节点定位：它决定了工作流如何理解用户的意图。如果开始节点定义不清晰，后续的大模型节点或其他节点将无法正常传参。默认参数：系统预置了qu
- [结束节点](https://support.huaweicloud.com/usermanual-agentarts0/end_node.md): 结束节点是工作流的“交互出口”。它决定了工作流执行完一系列复杂逻辑后，最终以何种形式将结果反馈给用户或下游系统。对话型反馈：直接回复一段自然的文字。例如：为您找到的结果是{{result}}。任务型反馈：返回结构化的数据（JSON），让工作流的返回结果从“自然语言对话”升级为“程序可调用的标准化数据格式”，满足系统对接、跨流程调用、数据复
- [大模型](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0062.md): 大模型节点是工作流的“大脑”。它不仅能进行对话生成，还能基于上下文进行逻辑推理、任务拆解和非结构化数据提取。通过配置提示词和模型参数，可以控制其输出风格与格式，为下游节点提供决策依据或结构化数据。核心能力：内容生成：撰写文案、代码、翻译、创意写作。逻辑决策：分析用户意图，判断下一步调用哪个插件。信息提取：从自然语言中提取JSON格式的关键
- [工作流](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0063.md): 在复杂的业务编排中，工作流节点允许您将另一个已发布的工作流作为“子程序”嵌入当前流程。通过嵌套，您可以将常用的、标准化的任务处理流程（如“用户鉴权”、“发票OCR识别”）封装为不同的子工作流，并在主工作流中调用这些子工作流。通过工作流嵌套，可以实现复杂任务的模块化拆分和处理，从而使工作流编排逻辑更加灵活、清晰和易于管理。在工作流编辑页面，
- [Agent](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0064.md): Agent节点是AgentArts工作流中的“大模型节点+插件节点”。它在单次执行中完成一个核心流程：接收输入→模型推理→ （按需）调用插件→生成最终回答。核心能力大模型推理：基于提示词指令理解用户意图，生成自然语言回答。插件调用：模型在推理过程中判断是否需要调用已绑定的插件，自动提取参数发起调用，并基于插件返回结果生成最终回答。模型配置
- [判断](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0066.md): 判断节点是工作流中的逻辑路由器。它基于前置节点的输出变量，通过预设的条件表达式（IF/ELSE），将工作流导向不同的执行分支。当向该节点输入参数时，节点会判断是否符合IF区域的条件，符合则执行IF对应的工作流分支，否则执行ELSE分支。每个分支条件支持添加多个判断条件（且/或），可单击“添加分支”添加多个分支，添加多个分支后的执行顺序：先
- [代码](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0067.md): 代码节点是工作流中用于执行自定义代码逻辑的节点。当工作流中需要进行数据处理、格式转换、数学计算、逻辑判断等操作，而这些操作用其他节点难以实现或用大模型处理不够准确时，可以通过代码节点编写代码来完成。代码执行的结果是确定的，相同的输入必然得到相同的输出。对于计算、格式转换等任务，代码比大模型更准确、更快、且不消耗Token。代码节点的典型使
- [循环](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0068.md): 循环环节点用于在工作流中重复执行一系列任务，直到满足特定条件为止。当你需要批量处理数据、逐一遍历列表元素或按固定次数重复执行某个操作时，可以使用循环节点来实现。循环是一种常见的工作流控制机制，它让一组操作能够被重复执行，而不需要手动复制粘贴相同的节点。在实际业务场景中，循环节点可以帮助您：逐条处理列表数据：对一组数据中的每一条逐一执行相同
- [意图识别](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0069.md): 意图识别节点主要是让应用理解用户自然语言表达的意图或目的，可用于需要对用户问题进行分类，或者提供综合类功能有不同分支处理的场景。通过对用户输入进行推理分析，匹配预定义的意图关键字类别，并根据匹配结果引导至相应的处理流程，该节点通常位于工作流的前置位置。意图识别节点支持普通模式或高级模式运行。普通模式：适用于对少量意图进行分类的场景，当意图
- [高级意图识别](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0070.md): 高级意图识别节点是普通意图识别节点的增强版本，专为需要管理20个以上意图的复杂场景设计。它通过意图包集中管理大量意图分类，并使用子工作流为每个意图分支提供独立的处理逻辑，实现主工作流的模块化编排。在配置高级意图识别节点前，必须先创建意图包。意图包是意图分类的“集中管理容器”，独立于工作流存在，可被多个工作流复用。创建意图包的操作请参见创建
- [插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0072.md): 插件节点是工作流中实现第三方能力调用的核心组件之一，允许工作流通过调用插件来执行特定功能任务。尽管大语言模型（LLM）具备强大的自然语言处理与推理能力，但存在两大局限：信息滞后（无法获取训练截止日期之后的实时信息）和行动力缺失（无法直接与外部系统交互）。插件节点正是突破这些局限的关键桥梁，每个插件本质上是经过标准化封装的API或者函数功能
- [MCP服务](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0073.md): MCP服务节点是工作流中实现第三方能力调用的核心组件之一，允许工作流通过调用MCP服务来执行特定功能任务。MCP 服务与插件的关系：两者都是为工作流引入外部能力的方式。插件采用平台定义的封装规范，开发者可将外部API或自定义函数封装为插件使用；MCP服务则基于业界标准协议，能够接入更广泛的第三方工具生态。在功能上两者互补，开发者可根据实际
- [HTTP请求](https://support.huaweicloud.com/usermanual-agentarts0/http_node.md): HTTP请求节点用于在工作流中调用外部服务的API接口，支持POST、GET请求。通过该节点，可以向指定的服务器地址发送请求，获取数据或提交信息，从而将工作流与外部系统打通，实现查询第三方平台的信息、向业务系统写入处理结果、调用外部模型服务等功能。此外，HTTP请求节点还提供了异常忽略功能保证API服务异常情况下工作流正常执行。HTTP 
- [消息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0077.md): 消息节点是工作流中的即时反馈机制。与“结束节点”不同，消息节点允许工作流在执行过程中，向用户界面主动推送中间结果，而无需等待整个流程结束。核心价值降低等待焦虑：在执行耗时任务（如联网搜索、生成长文）前，先发送“正在搜索中...”的提示。分步输出：将复杂的推理过程拆分为多个消息气泡，提升阅读体验。调试与监控：在开发阶段输出变量的中间状态，用
- [输入](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0078.md): 输入节点用于在工作流执行过程中暂停流程，向用户收集额外信息。当下游节点需要某些参数，而这些参数在之前的流程中尚未获取时，你可以插入一个输入节点来主动追问用户。输入节点使用场景：输入参数：支持配置一个或多个输入参数，且输入参数可被后置节点引用。当单击图标时，可新增输入参数。参数名称：变量标识符，下游节点通过此名称引用，只允许输入字母、数字、
- [提问器](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0079.md): 提问器节点在工作流执行过程中主动向用户发起提问，从自然语言对话中提取完成任务所需的结构化参数。它会循环追问，直到收集到所有必需信息或达到最大交互轮数。提问器节点仅适用于对话型工作流。模式偏好选择：可选择效果优先或速度优先，参数说明如表1所示。模型配置：选择用于参数提取和反思纠正的模型。建议选择具备良好指令遵循能力的模型。你还可以单击图标，
- [问答](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0080.md): 问答节点用于在工作流执行过程中向用户提出预设问题。根据配置模式的不同，它既可以暂停工作流等待用户回答（需要回答模式），也可以仅发送问题后继续执行（无需回答模式）。问答节点使用场景：问题配置：问答策略：需要回答：工作流执行到问答节点时暂停，向用户展示问题，等待用户回答后将回答内容作为输出参数传递给下游节点。无需回答：工作流执行到问答节点时不
- [对象提取](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0081.md): 对象提取节点将大模型的语义理解能力与工作流的业务处理能力结合，从用户的自然语言输入中提取出完整的结构化业务参数。工作流在处理复杂业务场景时，逻辑往往极其复杂甚至高达上百个工作流节点。例如对于银行转账业务，要把用户一句“给小刘转100”变成可调用接口的结构化参数，里面涉及到识别谁是转账人，收款人小刘是指谁，需要用哪张卡转账，100的币种是什
- [异常](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0082.md): 异常节点功能，当工作流运行遇到业务异常时，通过本节点终止流程，并向用户或上游系统返回预设的错误信息和异常码，便于定位问题和后续处理。核心价值与适用场景：使用异常节点，是为了在遇到不可恢复的错误时，快速失败并明确告知原因，避免产生脏数据。异常信息载体：异常节点要求输出内容必须符合JSON格式。这确保了前端或上游系统能够通过程序解析错误原因，
- [变量赋值](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0084.md): 变量赋值节点是工作流中用于修改和存储变量值的节点。通过变量赋值节点，将特定的值赋给变量，可以实现数据的动态更新和传递，使工作流能够根据实时数据做出相应的处理和决策。变量赋值节点支持在循环节点内部和外部使用，两种场景下可操作的目标变量不同。变量赋值节点应用广泛，例如：存储中间结果：在工作流中，将中间计算或处理的结果通过变量赋值节点存储到变量
- [变量聚合](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0085.md): 变量聚合节点将多个分支的输出变量汇聚为一个统一变量，供下游节点引用。它的核心能力是：从多个分支的输出中，按照用户指定的优先级顺序，返回第一个非空值。配置变量聚合节点时，需要选择聚合策略和聚合变量，并按需设置聚合分组。聚合策略：通过指定策略对每个分组中的所有变量进行聚合处理，同一组内的变量实施相对应的聚合策略。目前聚合策略仅支持设置为“返回
- [知识检索](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0086.md): 知识检索节点是工作流的“外部知识存储器”。它通过RAG（检索增强生成）技术，从预先上传的知识库中根据用户意图匹配相关片段。核心作用：解决大模型无法掌握的私有领域数据，实时信息以及易产生幻觉的问题。数据流转：输入用户问题>检索匹配文档>输出检索信息。在工作流编辑页面，单击下方“添加节点”，选择“知识检索”节点。输入参数：输入参数固定只有1个
- [意图管理](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0095.md): 意图包是意图分类的集中管理单元，用于将一组相关意图类别及其样例统一封装。在工作流的高级意图识别节点中直接引用预定义的意图包，即可高效实现大规模意图分类与智能路由。一次定义，多处复用：同一意图包（如“通用闲聊包”“银行基础业务包”）可被多个工作流共享引用，避免重复配置，显著提升开发与维护效率。独立管理，敏捷迭代：意图包独立于工作流存在，支持
- [消息模板](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0099.md): 消息模板是预定义的标准化JSON消息结构，通过定义模板，可以规范工作流在特定场景（如系统异常、业务阻断）下的输出格式，实现统一错误处理与交互标准。消息模板主要与工作流中的异常节点配合使用，可以在异常节点中快速引用这些模板，确保多个工作流、多个节点之间的消息输出格式统一且可维护。已开通AgentArts服务。创建消息参数说明参数名称参数说明
- [对象管理](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0100.md): 对象是可复用的变量定义模板，将业务中常用的数据结构（如用户信息、订单详情、收货地址等）预先定义为对象，可在工作流全局配置中的记忆变量、开始节点和对象提取节点中直接引用，无需重复定义相同的变量，显著提升开发效率与数据一致性。每个对象包含一个对象名称和一个对象变量（变量名称 + 变量类型 + 描述）。当变量类型为 Object 时，支持定义多
- [多智能体应用介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0103.md): 在AgentArts中创建的单智能体应用，能够处理基本任务，但在进行复杂任务处理时，需要编写详细且冗长的提示词，并添加各种插件、知识库、MCP服务等，增加了调试的复杂性。在单智能体应用中，任意一处改动都有可能影响到整体功能，导致用户在处理实际任务时，处理的结果可能与预期效果有较大出入。为了解决这一问题，AgentArts提供了多智能体应用
- [创建多智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0106.md): 多智能体应用允许用户将多个智能体应用或工作流应用进行组合，并按预设模式进行调度协同。多智能体应用的更多介绍请参考多智能体应用介绍。本节介绍配置多智能体应用的流程。不同套餐包允许创建的应用数量不同，具体可参考计费模式。已开通AgentArts服务。已发布工作流。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。创
- [调试多智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0107.md): 开发者可以在多智能体应用创建完成后，直接与多智能体进行对话，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。创建多智能体应用后，AgentArts支持对应用进行预览与调试。已开通AgentArts服务。已创建多智能体应用。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。多智能体应用设置了全局配置
- [发布多智能体应用为API](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0108.md): 多智能体应用试运行成功后，可对其进行发布，便于后续使用。已开通AgentArts服务。已创建多智能体应用。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。已经发布的多智能体应用，修改后再次发布，显示为“更新版本”。发布后，在“多智能体”页面的卡片上，显示“已提交”。多智能体发布后，支持通过API调用，具体请参
- [通过API调用多智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0109.md): AgentArts的API调用是应用开发中的强大工具，可以帮助用户快速集成功能和服务，同时支持与其他系统或服务进行交互，提升应用性能和用户体验。合理设计和管理API是确保应用安全和稳定的关键。通过API，用户可以构建功能丰富、高效的应用，满足多样化的用户需求。通过API调用多智能体的优势：提升开发效率API接口可以让不同的应用程序高效交互
- [导入导出多智能体应用](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0110.md): AgentArts支持将多智能体应用在环境中导出，导入至另一个环境中，无需用户重复构建，快速完成多智能体应用跨环境构建或复用。使用的业务场景如下：从测试环境导出多智能体，到生产环境上部署。在不同的开发环境之间迁移多智能体应用。将多智能体应用下载到本地进行代码归档。作为模板提供给其他客户进行复用。已开通AgentArts服务。登录用户为空间
- [插件介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0123.md): 在Agent（智能体）中插件是大语言模型（LLM）与外部世界交互的一系列工具。尽管LLM具备强大的自然语言处理与推理能力，但其本质是基于训练数据的静态系统，存在两大局限：信息滞后：无法获取训练截止日期之后的实时信息。行动力缺失：无法直接与现实世界的软件或硬件系统交互（如读写数据库、发送请求）。插件的引入，使Agent具备了实时信息检索、外
- [示例：创建联网搜索插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0124.md): 本示例将介绍如何通过AgentArts智能体开发平台创建联网搜索插件，并进行插件的调试、发布，最终应用到Agent中。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。本示例使用联网搜索API实现联网搜索功能，其API接口调用示例如下。请提前创建API Key，获取到的API Ke
- [基于API创建插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0126.md): 在AgentArts智能体开发平台中，当官方插件市场无法满足特定业务需求时，开发者需要自主创建插件。根据实现机制与运行形态的不同，自定义插件主要分为“API类型插件”和“函数类型插件”两种形态。函数型插件介绍及创建请参考基于函数创建插件。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间
- [基于函数创建插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0127.md): 在AgentArts智能体开发平台中，当官方插件市场无法满足特定业务需求时，开发者需要自主创建插件。根据实现机制与运行形态的不同，自定义插件主要分为“API类型插件”和“函数类型插件”两种形态。API型插件介绍及创建请参考基于API创建插件。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队
- [基于JSON文件导入API插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0128.md): AgentArts支持通过JSON文件形式导入API插件，可以直接将API插件中定义的接口、入参、出参、鉴权等信息编辑为一份JSON文件，再导入平台创建API形态插件。该文件定义了插件的基础属性、后端服务连接地址、输入输出参数结构以及鉴权方式。开发者可通过修改此文件，快速将现有的RESTful API接入到平台中创建成插件。推荐结合示例：
- [调试发布插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0129.md): 插件创建完成后，需要对其中的工具进行调测，调测成功之后才能发布，只有发布状态的插件才能被智能体和工作流正常使用。已创建插件。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。认证配置不可用插件认证不可用，页面提示AgentArts.02401121报错。请检查API鉴权参数是否填写错误或已过期。调试成功但输出无
- [在单智能体中使用插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0131.md): 如果把大模型（LLM）比作智能体的“大脑”，那么插件就是它的“眼睛”和“手”。通过集成插件，单智能体可以突破仅基于文本生成的局限，获得以下能力：连接外部世界：实时查询天气、搜索网页、读取数据库。执行具体操作：发送邮件、预定会议、生成图表。私有数据交互：调用企业内部API获取业务数据。在单智能体中，大语言模型能够理解用户意图，并主动调用插件
- [在工作流中使用插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0132.md): 相比于单智能体使用插件的“概率性调用”（由大模型决定是否用），工作流使用插件是“确定性调用”（流程走到这一步必须执行）。因此，设置的重心必须从“提示词设置”转移到“参数映射”和“数据流转”上。适用场景：固定业务逻辑：必须先查询订单状态，再根据状态回复用户。精确数据处理：需要调用计算器、汇率转换、数据库查询等不容许出错的操作。连接外部系统：
- [管理插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0133.md): AgentArts服务支持对插件进行版本管理、各版本历史记录查看、引用查询、删除、导出/导入插件的JSON文件等操作，确保插件全生命周期管理的规范性。核心功能包括：版本管理：发布新插件版本并记录版本信息，按时间顺序查看所有插件版本的发布详情。引用查询：定位使用该插件的智能体与工作流，支持手动更新版本。插件删除：移除不再使用的插件（高危操作
- [MCP介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0135.md): MCP（Model Context Protocol）是一个开放协议，旨在打通大语言模型（LLM）应用与外部数据源、工具之间的交互壁垒。在传统的开发场景中，由于每个数据源、工具或服务都有独立的格式规范、对接协议和认证体系，开发者往往需要为每个API单独编写代码、处理文档、配置认证方式和错误处理，这不仅效率低下，也大大增加了开发和维护的成本
- [示例：使用模板创建搜索MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0317.md): 本示例将介绍如何使用资产广场的预置MCP，并以必应搜索MCP为例介绍预置MCP的安装和使用方法。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。一般平台展示的MCP配置，无论是表单编辑还是JSON编辑，均不需要改动，只需要关注是否填写鉴权信息即可。MCP是否需要鉴权取决于其所对接
- [示例：快速接入ModelScope魔塔社区MCP工具集](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0318.md): 本示例将介绍如何在AgentArts智能体开发平台中接入来自ModelScope魔塔社区的开源MCP工具集。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。AgentArts智能体开发平台支持Stdio（本地进程，含NPX、UVX） 和Streamable HTTP/SSE（远程
- [自定义接入MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0136.md): 自定义接入是最灵活的MCP创建方式。您可以通过填写MCP服务的连接地址，将任意MCP服务接入平台供智能体调用。该方式支持接入开源社区中的MCP（如GitHub、ModelScope上的开源MCP），也支持接入用户自主开发的MCP服务，适用于有特定业务系统对接需求、或需要使用社区开源MCP能力的场景。操作示例请参见示例：快速接入ModelS
- [基于模板创建MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0320.md): 如果你不想手动配置MCP服务的连接地址和参数，可以直接使用平台精选的MCP模板。平台精选MCP是由官方筛选并上架至资产广场的标准化MCP服务，已完成适配和验证，您只需安装即可使用（部分MCP需要填写鉴权信息后方可正常调用），无需额外的配置开发。当您的需求恰好在平台精选的覆盖范围内，这是最快捷的接入方式。操作示例请参见示例：使用模板创建搜索
- [使用第三方服务安装MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0321.md): 当自定义接入和平台精选都无法满足需求时，你还可以通过订阅华为云ROMA Connect、华为云云商店提供的第三方MCP服务来扩展智能体的能力。ROMA Connect、云商店汇聚了丰富的第三方MCP服务资源，覆盖更多样化的业务场景。通过该方式，您无需自行开发MCP服务，即可快速获取并安装所需的MCP能力。单租户可创建的NPX和UVX类型M
- [调试MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0322.md): MCP创建完成后，建议先进行调试验证，确认MCP服务连接正常、工具已正确识别、调用结果符合预期后，再将其关联到智能体中使用。调试阶段是发现和排查问题的最佳时机，直接跳过调试将问题带入智能体运行环节会大幅增加排查难度。在开始调试之前，请先检查以下几项：工具是否已识别：进入MCP详情页，确认工具列表已正确加载。如果工具列表为空，通常是MCP配
- [在单智能体中使用MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0138.md): MCP创建并调试通过后，即可将其添加到智能体中使用。平台支持在单智能体和工作流两种模式下使用MCP，工作流中使用方法请参见在工作流中使用MCP。两者的核心差异在于工具的调用方式不同：简单理解：单智能体模式下，MCP工具是大模型的“自选动作”；工作流模式下，MCP工具是流程中的“规定动作”。在单智能体模式下，MCP的调用完全由大模型自主决策
- [在工作流中使用MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0139.md): MCP创建并调试通过后，即可将其添加到工作流使用。平台支持在单智能体和工作流两种模式下使用MCP，单智能体中使用方法请参见在单智能体中使用MCP。两者的核心差异在于工具的调用方式不同：简单理解：单智能体模式下，MCP工具是大模型的“自选动作”；工作流模式下，MCP工具是流程中的“规定动作”。在工作流模式下，MCP作为流程中的一个固定节点被
- [管理MCP](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0140.md): MCP创建完成后，在“组件库 > MCP”页签中查看安装成功MCP服务，您可以通过属性类型（服务名称）或搜索关键字功能来查找MCP服务。也可根据需要执行如表1所示的操作。
- [故障排除](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0323.md): 当MCP安装失败时，平台会返回特定的错误码以及错误信息提示。针对服务创建过程中可能遇到的网络连通性、环境配置冲突及协议错误，本章节提供了典型错误码的诊断流程与解决方案。多数MCP服务安装失败源于MCP的安装方式选择错误。在您深入排查网络问题、配置问题前，请先确认MCP的安装方式是否选择正确。平台支持Stdio（本地进程，含NPX、UVX）
- [知识库介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0148.md): 知识库是组织、存储及管理知识的系统，涵盖文档、图片、视频等信息的分类整理，可以帮助用户高效管理大量的信息。在Agent中添加知识库，使其与用户提供的专业知识库进行交互，可以显著提升Agent的准确度和专业度。AgentArts提供的知识库功能对文本文档、FAQ（Frequently Asked Questions，常见问题解答）等数据进行
- [知识库类型](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0244.md): AgentArts支持以下两种类型知识库的管理：默认：在AgentArts内直接创建并管理的知识库。支持上传文本文档、FAQ文档等文件，设置文档标签，并对其进行向量化存储、知识检索。第三方：将第三方系统中的知识库接入到AgentArts中。当前支持对接开源第三方知识库General、KooSearch和RAGFlow。创建第三方知识库时为
- [知识库使用限制](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0149.md): 在使用知识库时应注意以下限制。
- [创建知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0152.md): AgentArts提供的知识库功能对文本文档、FAQ等数据进行向量化存储、知识检索，支持为应用、工作流提供检索增强能力。本文将详细介绍如何创建知识库，包含模型配置、解析配置和拆分配置等。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。AgentArts基础版：最多可以创建5个知识
- [上传文档](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0153.md): 在创建知识库后，需上传文档至知识库，平台支持知识文档、FAQ问答对、FAQ文档三种形态的文档。上传知识文档（可选）新增文档切片：知识文档上传并解析完成后，用户可根据需要新增/编辑切片，以提升知识库的检索效率。（可选）重新对文档解析拆分：如果用户对知识库内文档的解析切片效果不满意，可修改知识库模型配置、解析配置和拆分配置信息，并对知识库内文
- [通过OBS接入文档](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0154.md): 在创建知识库时，您可以选择本地上传知识文档，或通过对象存储服务（Object Storage Service, OBS）接入知识文档。本文将详细说明如何通过OBS接入知识文档。已完成创建知识库。您需要拥有一个华为账号并实名认证，且该账号可以访问OBS桶信息。OBS配置信息保存之后将无法修改。待执行状态为“执行成功”，即完成OBS接入知识文
- [测试知识库命中率](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0157.md): AgentArts支持对创建的知识库进行命中率测试，以评估知识库的效果和准确性。本文将详细介绍本地知识库创建完成后如何执行命中测试操作。已完成上传文档。当知识库以卡片形式展示时，将鼠标悬浮在需要命中测试的知识库卡片上，单击“命中测试”。在页面右侧将根据不同的检索方式（语义检索、关键词检索、混合检索、FAQ检索），展示多条匹配的内容，并按照
- [知识库分段](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0158.md): 知识库进行分段设置主要是为了提高信息的组织性、可读性和检索效率。具体来说，分段设置的优势包括：提高可读性：将长篇内容分成多个段落，每个段落集中讨论一个主题或一个方面，可以使读者更容易理解和消化信息。长篇大论往往会让读者感到疲惫，而分段则可以提供自然的停顿点，帮助读者更好地吸收信息。增强组织性：通过分段，可以将相关的信息归类在一起，使知识库
- [第三方知识库分类](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0286.md): 支持将第三方系统中的知识库接入到AgentArts中。目前支持的知识库类型请参考表1。
- [连接General知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0245.md): 目前业界有诸多知识库种类，但并没有一个统一的规范。对于用户自开发的知识库平台，AgentArts提供了第三方通用知识库接入规范。知识库的开发者参考此规范进行适配后，即能够作为第三方知识库接入AgentArts平台。本文将介绍如何在AgentArts对接第三方General知识库。用户拥有一个自开发的知识库系统（下文统称第三方知识库），并且
- [连接KooSearch知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0169.md): AgentArts支持连接外部知识库平台，以便用户访问和利用外部的知识资源。KooSearch可以帮助企业搭建企业级RAG，提升用户获取企业私有知识的效率，同时提供联网增强功能，提供互联网公域知识问答能力。主要用于智能客服应用、数字人、数字员工、AI助手、AI搜索等知识问答场景。本文将介绍如何在AgentArts对接第三方KooSearc
- [连接RAGFlow知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0166.md): AgentArts支持连接外部知识库，通过连接外部知识库，可以显著扩展内部知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。本文将介绍如何在AgentArts对接第三方RAGFlow知识库。当资源数量达到上限时，请删除不再使用的资源以释放配额：外部知识库连接：进入 “外部知识库连接” 页签进行删除。具体操作请
- [测试知识库命中率](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0171.md): AgentArts通过对创建的知识库进行命中率测试，以评估知识库的效果和准确性。本文将详细介绍第三方知识库创建完成后如何执行命中测试操作。已完成连接General知识库、连接KooSearch知识库、连接RAGFlow知识库。当知识库以卡片形式展示时，将鼠标悬浮在需要命中测试的知识库卡片上，单击“命中测试”。在命中测试页面右侧将根据不同的
- [第三方通用知识库接入规范](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0246.md): 该规范面向的对象是第三方知识库的开发者（下文简称开发者），其目的是为开发者对AgentArts平台适配提供指导，最终能够将第三方知识库的内容接入到AgentArts平台使用。对于API接口适配，开发者需要新增两个接口，一个是获取知识库列表，一个是检索知识库。开发者按照接口：获取知识库列表、接口：检索知识库规范提供对外接口，并在接口内实现密
- [在单智能体中使用知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0173.md): 支持在AgentArts中添加引用知识库，以根据用户意图来检索召回对应的知识切片。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。如果需要在单智能体中使用本地知识库，请确保已创建平台默认知识库且知识库是启用状态。如果需要在单智能体中使用第三方知识库，请确保已接入第三方知识库且知识库是启用状态。
- [在工作流中使用知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0174.md): 支持在AgentArts中添加引用知识库，以根据用户意图来检索召回对应的知识切片。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。如果需要在工作流中使用本地知识库，请确保已创建平台默认知识库且知识库是启用状态。如果需要在工作流中使用第三方知识库，请确保已接入第三方知识库且知识库是启用状态。
- [管理知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0287.md): 知识库创建完成后，在“知识库”界面，您可以通过分类筛选（全部类型、默认和第三方）或搜索（按名称和来源）功能来查找知识库。支持的其他操作请参考表1。知识库支持以列表和卡片形式展示。单击搜索框右侧按钮，知识库将以列表形式展示。单击搜索框右侧按钮，知识库将以卡片形式展示。相关操作操作说明启用知识库当知识库以列表形式展示时，找到“状态”是“已停用
- [提示词介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0176.md): 提示词是用户输入给大模型的文本指令，用于引导模型生成特定的输出。提示词设计直接影响模型的响应质量，是优化模型性能的关键工具。通过不同的提示词语，可以测试模型在语义理解、逻辑推理等场景中的表现，帮助用户发现和解决其常识错误、逻辑漏洞等问题。平台资产中心预置了丰富的提示词模板，涵盖多种应用场景，如对话问答、文案生成等，支持用户快捷引用。用户也
- [撰写提示词规范](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0177.md): 明确且清晰的提示词能够显著提升大模型的输出质量，减少错误率，并满足特定需求。建议在编写前，先掌握相关技巧。明确目标和任务：在编写提示词之前，明确智能体或大模型的目标和任务，确保提示词能够直接指向预期行为。清晰性：提示词应明确表达目标，避免模糊不清。例如：不要写“告诉我关于健康的事情”，而是写“请描述如何保持健康的生活方式”。准确性：提示词
- [创建提示词](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0178.md): 在构建Agent应用的过程中，设置提示词是至关重要的步骤。提示词旨在为模型提供明确的任务目标，规范输出格式，优化生成内容，并满足个性化需求。通过精心设计和优化提示词，可以确保Agent生成的内容符合特定的风格和需求。撰写提示词时，可以设置提示词变量。即在提示词中通过添加占位符{{ }}标识表示一些动态的信息，让模型根据不同的情况生成不同的
- [优化提示词](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0179.md): 优化提示词功能不仅能够提升模型回答的准确性和响应质量，还能显著增强用户体验和工作效率，适应各种应用场景和需求，并支持持续改进与迭代。通过优化提示词功能，可以在提示词中增加变量，实现不同场景下的快速复用。此外，通过添加数据评测集和补充提示词背景知识等，可以帮助模型更好地理解提示词，多场景评测数据使提示词指令更加具体，输出更加符合预期。在成功
- [管理提示词](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0180.md): 提示词可以作为一种可复用的资源保存在资源库中。团队通过共享这一资源库，能够统一并提升对大语言模型（Large Language Model, LLM）的调用效率和效果。本文档将详细介绍如何在资源库中对提示词/提示词优化任务进行删除、编辑等操作，以确保资源库的持续更新和优化。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开
- [为智能体和工作流设置提示词](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0181.md): 在实际业务场景中，大语言模型（LLM）的应用需要清晰的任务指令来实现高效配置。然而，直接使用大模型进行复杂任务时，可能会面临输出不准确、结果不匹配业务需求。如何有效指导大模型完成特定任务？提示词作为一种自然语言指令，为这一问题提供了解决方案。提示词是大语言模型的关键指导信息，尤其在智能体开发和工作流配置场景中发挥着重要作用。已创建单智能体
- [模型介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0183.md): 模型服务为智能体提供核心推理能力，是智能体实现自主决策和任务执行的基础。在AgentArts中，你可以通过模型服务为智能体接入大语言模型，使其具备文本对话、图像理解、向量化等能力。为满足不同用户的技术能力、业务场景及需求，AgentArts提供了多样化的模型服务模式。以下从模型来源对各类模型服务进行介绍，具体如表1所示。
- [免费模型与使用额度](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0186.md): AgentArts平台已对接ModelArts Studio（MaaS）的模型服务，为用户提供大模型能力支持。开通AgentArts后，平台默认提供2,000,000 tokens的免费使用额度，无需额外配置，即可直接调用模型服务。免费额度用尽后，如需继续使用，需开通MaaS对应的模型服务并完成鉴权配置。具体操作请参见接入预置的付费模型。
- [接入预置的付费模型](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0185.md): 本章节适用于平台提供的2,000,000 tokens免费额度已用尽的场景。如免费额度尚未耗尽，完成本章节的操作仍会优先消耗免费额度。AgentArts平台预置的模型服务由ModelArts Studio（MaaS）提供。免费额度用尽后，需要开通对应的模型服务并完成鉴权配置，才可继续调用。接入预置模型服务的完整流程如图1所示。方式一：在左
- [自定义模型接入流程](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0189.md): AgentArts支持接入由用户或第三方部署在外部环境的模型服务API。相比使用平台预置模型，接入自定义模型服务具有以下优势：优化个性化体验： 根据业务特点接入定制化模型，减少用户的搜索和选择时间，提供更加流畅高效的使用体验。例如，搜索引擎可根据用户的搜索历史和偏好，提供更精准的搜索结果。增强特定领域的准确性： 接入专业领域的模型服务，可
- [接入模型供应商](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0190.md): 模型供应商提供的模型服务使企业和个人能够快速获取和使用高质量模型。在AgentArts中接入外部模型服务API前，需先接入模型供应商，用于对模型来源进行统一管理与标识。完成供应商接入后，您可在该供应商下继续接入具体的模型服务。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师、运维工程师，详细信息请参考管理团队空间
- [接入模型服务](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0191.md): 本章节介绍如何在已接入的模型供应商下接入模型服务API。为满足用户对模型的个性化与专业化需求，AgentArts支持接入由用户自建或第三方在外部环境部署的模型服务API。模型服务接入后，您可以在AgentArts中进行调测和发布，并在智能体中选择使用。当前支持接入的模型类型如下：文本对话（Chat）文本向量化（Embeddings）文本排
- [模型API接口规范](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0192.md): 本章节介绍标准OpenAI协议和AI引擎标准协议的接口规范。接入自定义模型服务前，请确保模型API符合对应的接口协议规范。当前模型网关支持接入以下四种类型的模型API：文本对话（Chat）文本向量化（Embeddings）文本排序（Rerank）图像理解各模型类型支持的接口协议如下表所示。本章节适用于以下场景：需要将第三方模型服务（如De
- [调测模型](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0187.md): 模型调测是指在平台侧对模型服务进行真实调用，并结合参数调整与效果观测，验证模型在特定场景下的可用性、稳定性与效果表现的过程。通过调测，您可以在模型正式发布或接入业务流程前，提前发现并定位常见问题（如鉴权失败、接口协议不匹配、响应超时、输出不符合预期等），确保模型在真实业务场景中能够稳定、高效地运行。本章介绍平台已接入的模型服务调测流程。目
- [配置模型路由策略](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0194.md): 通过配置模型路由策略，您可以将多个已接入的模型服务按规则进行编排，实现模型故障自动切换能力。当主模型因故障、超时或不可用等原因无法正常响应时，系统将根据路由策略自动切换到其他可用模型继续提供服务，从而提升业务的稳定性与可用性。路由策略创建完成后，可对路由入口进行调测验证，并在智能体中选择使用。已接入多个同类型模型服务（例如多个文本对话模型
- [观测介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0200.md): 在AI应用的开发和部署过程中，请求调用链往往十分复杂，导致系统行为难以追踪和分析。观测功能的引入，能清晰记录各组件之间的调用顺序，并提供详细的调用路径和时间戳。此外，它还涵盖会话管理、Agent性能指标以及租户使用数据，帮助开发者和运维人员快速定位问题、优化系统性能，提升用户体验和资源利用率。通过这些能力，系统的可维护性和运行效率得到显著
- [查看应用指标统计信息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0201.md): 应用指标统计界面提供自动化数据统计功能，实时收集应用的性能指标和资源使用情况。这使运维人员能够快速识别性能瓶颈，从而提升系统的稳定性和可靠性，并实现资源的高效利用和成本优化。已开通AgentArts服务。登录用户为空间所有者、空间管理员、运维工程师，详细信息请参考管理团队空间成员。应用指标统计仅统计当前空间下的智能体和工作流应用产生的数据
- [查看租户指标统计信息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0202.md): 租户指标统计页面为您提供当前租户下智能体应用和工作流方面的关键使用数据。通过这些统计数据，您可以了解智能体和工作流的总数、新增数量、活跃情况以及资源消耗情况，帮助您优化资源分配，提高使用效率，并及时发现和解决问题。已开通AgentArts服务。登录用户为空间所有者、空间管理员、运维工程师，详细信息请参考管理团队空间成员。租户指标统计界面包
- [查看应用调用链信息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0203.md): 调用链管理界面提供可视化的调用链数据信息，运维人员可直观地查看各节点的详细信息，从而实现快速运维。已开通AgentArts服务。登录用户为空间所有者、空间管理员、运维工程师，详细信息请参考管理团队空间成员。不同套餐包的Trace上报存留天数不同，具体可参考计费模式。调用链管理页面分为过滤、数据展示两个区域，如图1所示。调用链列表包含以下信
- [查看会话管理信息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0204.md): 会话管理功能记录了您在智能体和工作流对话中的历史数据。您可以在会话管理界面快速查看这些历史数据。已开通AgentArts服务。登录用户为空间所有者、空间管理员、运维工程师，详细信息请参考管理团队空间成员。会话管理列表包含以下信息，如表1所示。会话管理界面支持按多种维度灵活筛选所需的会话记录。
- [评估介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0207.md): 随着大模型技术快速发展与广泛应用，智能体评估已成为AI应用开发的关键环节。传统评估依赖人工操作，从评测集构建、任务执行到报告输出，流程繁琐、效率低、易出错，且难以覆盖全场景、缺乏标准化评测能力，影响评估准确性与可靠性。AgentArts智能体开发平台引入了评估功能，内置可直接使用的评估器（即预置评测标准与规则），支持快速构建评测集、配置评
- [快速完成一次智能体评估](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0337.md): 智能体开发完成后，直接上线往往面临幻觉多（胡说八道）、工具调用错误、答非所问等风险。如何在上线前量化它的能力？如何知道修改了一句Prompt后，智能体变聪明了还是变笨了？这就是智能体评估的核心价值所在。为了方便理解，可以将“智能体评估”看作一次“模拟考试”：评测对象（考生）：开发好的智能体。评测集（考卷）：要考察智能体的哪些边界问题。评估
- [创建评测集](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0208.md): 评测集是用于评估Agent回复效果的数据集，通常包含两部分：输入数据（input）和预期输出（reference_output）。输入数据作为评估对象的输入，预期输出则是期望的结果，用于作为评估的基准。通过将Agent的实际输出与预期输出进行对比，可以准确评估其准确性，从而发现潜在的问题。已开通AgentArts服务。登录用户为空间所有者
- [维护评测集](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0325.md): 完成评测集数据的添加后，发布评测集版本。版本格式为a.b.c，其中每段数字的范围为0-999。同一个评测集发布的版本号应大于之前的历史版本号。导出全部数据到XLSX导出已选中数据到XLSX导出全部数据到jsonl导出已选中数据到jsonl编辑后的评测集将变为修改未提交状态。 如果要在评估任务中使用编辑后的评测集，请将修改后的评测集发布为最
- [评估器介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0327.md): 在评估过程中，评估器扮演着“裁判”的角色，通过量化分析Agent输出结果，或者数据集本身的准确性和质量。在启动评估任务前，必须配置合适的评估器。本章节将详细介绍评估器的概念、类型及评估规则，帮助您在智能体开发平台中高效创建与管理评估器。评估器是一种自动化或半自动化的评估工具，能够依据预设的规则对Agent的输出进行多维度分析，生成可量化的
- [自定义评估器](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0209.md): 已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师、运维工程师，详细信息请参考管理团队空间成员。发布完成后，在评估器列表页面即可查看已发布的评估器。评估器创建完成后，您还可以执行如表3的操作。
- [正确性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0271.md): 正确性评估器评估器参数说明：使用该评估器前，需要在评测集中为每条测试数据准备好input（用户问题）和reference_output（标准参考答案）。评估时平台会自动将智能体的实际输出填入agent_output，三项数据共同传入评估Prompt进行评分。各字段的推荐映射方式如下：输入格式示例：输出格式示例：
- [AI味检查](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0272.md): AI味检查评估器评估器参数说明：输入格式示例：输出格式示例：
- [任务完成度](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0273.md): 任务完成度评估器评估器参数说明：输入格式示例：输出格式示例：
- [轨迹质量](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0274.md): 轨迹质量评估器评估器参数说明：输入格式示例：输出格式示例：
- [不敏感性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0275.md): 不敏感性评估器评估器参数说明：输入格式示例：输出格式示例：
- [争议性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0276.md): 争议性评估器评估器参数说明：输入格式示例：输出格式示例：
- [创意性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0247.md): 创意性评估器评估器参数说明：输入格式示例：输出格式示例：
- [参考答案遵从度](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0248.md): 参考答案遵从度评估器评估器参数说明：输入格式示例：输出格式示例：
- [工具参数正确性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0249.md): 工具参数正确性评估器评估器参数说明：输入格式示例：输出格式示例：
- [工具选择质量](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0250.md): 工具选择质量评估器评估器参数说明：输入格式示例：输出格式示例：
- [幻觉现象](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0251.md): 幻觉现象评估器评估器参数说明：输入格式示例：输出格式示例：
- [性别歧视](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0252.md): 性别歧视评估器评估器参数说明：输入格式输入格式示例：输出格式示例：
- [恶意性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0253.md): 恶意性评估器评估器参数说明：输入格式示例：输出格式示例：
- [指令遵从度](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0254.md): 指令遵从度评估器评估器参数说明：输入格式示例：输出格式示例：
- [拒答检测](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0255.md): 拒答检测评估器评估器参数说明：输入格式示例：输出格式示例：
- [格式检查](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0256.md): 格式检查评估器评估器参数说明：输入格式示例：输出格式示例：
- [语种一致性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0257.md): 语种一致性评估器评估器参数说明：输入格式示例：输出格式示例：
- [文本可用性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0258.md): 文本可用性评估器评估器参数说明：输入格式示例：输出格式示例：
- [安全风险漏放](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0259.md): 安全风险漏放评估器评估器参数说明：输入格式示例：输出格式示例：
- [有害性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0260.md): 有害性评估器评估器参数说明：输入格式示例：输出格式示例：
- [有用性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0261.md): 有用性评估器评估器参数说明：输入格式示例：输出格式示例：
- [深度性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0262.md): 深度性评估器评估器参数说明：输入格式示例：输出格式示例：
- [犯罪性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0263.md): 犯罪性评估器评估器参数说明：输入格式示例：输出格式示例：
- [引用相关性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0264.md): 引用准确性评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-指令遵循](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0265.md): 知识问答-指令遵循评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-真实准确](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0266.md): 知识问答-真实准确评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-精炼性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0267.md): 知识问答精炼性评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-便捷性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0277.md): 知识问答-便捷性评估器评估器参数说明：输入格式示例：输出格式示例：
- [知识问答-丰富度](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0278.md): 知识问答-丰富度评估器评估器参数说明：输入格式示例：输出格式示例：
- [简洁性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0268.md): 简洁性评估器评估器参数说明：输入格式示例：输出格式示例：
- [细节丰富度](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0269.md): 细节丰富度评估器评估器参数说明：输入格式示例：输出格式示例：
- [轨迹-参数填充正确性](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0270.md): 轨迹-工具参数填充正确性评估器评估器参数说明：输入格式示例：输出格式示例：
- [创建评估任务](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0210.md): 评估任务旨在评估智能体或工作流的回复准确率。这个过程通过将评测集、评估对象和评估器结合来完成。评测集提供输入的对话数据，让智能体或工作流进行回答。评估器则根据设定的评估规则将评测集中的预期输出，与智能体或工作流的实际回复进行对比，生成评分结果，从而反映其准确率和整体表现。已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发
- [查看评估结果](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0211.md): 已开通AgentArts服务。登录用户为空间所有者、空间管理员、开发工程师、运维工程师，详细信息请参考管理团队空间成员。评估结果页面是评估任务执行结果的详细视图，旨在帮助您从宏观统计下沉到微观案例，进行深度复盘。全链路数据分析该页面涵盖了从输入到评估的完整过程。您不仅可以查看原始输入、智能体实际输出和设定的预期输出，还能获取评估器给出的具
- [标注评估结果](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0212.md): 在任务评估完成后，可对自动化评估结果进行人工标注，以补充判断、提升结果的可解释性与实用性。通过标注，您可以：为每条评估结果添加定制化的标签（如“正确”“错误”“模糊”“不相关”等），明确其质量等级或问题类型。对异常或争议样本进行归类，便于后续分析与复盘。为模型优化、数据治理和报告撰写提供高质量的标注依据。在开始标注前，请先创建所需的标签。
- [工作空间及权限介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0214.md): 为方便多人协作和资源共享，AgentArts引入了工作空间的概念。工作空间为用户提供了灵活的资源管理和团队协作功能。工作空间分为个人空间和团队空间。个人空间：每个AgentArts用户默认具有一个个人空间，默认的个人空间不可删除、不能编辑、不能共享，仅用于管理个人开发及资源管理。团队空间：团队空间旨在为用户提供灵活、高效的资产管理与协作方
- [创建并管理团队空间](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0215.md): 在开发过程中，一个开发任务往往需要多个团队成员的协作才能完成。此时可以创建一个团队空间，为团队成员提供一个集中的平台，用于任务分配、进度跟踪、文件共享和即时沟通。通过这种方式，可以显著提升团队的工作效率，确保开发任务的顺利进行和高质量完成。不同套餐包允许创建的团队空间数量不同，具体可参考计费模式。已开通AgentArts服务。已实名认证的
- [管理团队空间成员](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0216.md): 用户创建团队空间后，为了使团队空间更加高效地运作，可以为团队空间添加成员。不同套餐包允许添加的成员数量不同，具体可参考计费模式。已开通AgentArts服务。已创建团队空间。已在该租户下创建IAM用户。登录用户为团队空间的空间所有者或空间管理员，该用户具有Security Administrator权限，给IAM用户授权请参考给IAM用户
- [管理云服务授权信息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0218.md): 如果需要使用代码节点、创建函数类型的插件、NPX/UVX类型的MCP，则需要开通及授权依赖的函数工作流，否则会导致功能不可用。如果需要使用预置的MaaS模型，平台提供2,000,000 tokens的免费额度，优先使用免费额度，免费额度用完后，则需要开通及授权依赖的MaaS模型即服务，否则会导致功能不可用。开通服务授权不会产生费用，使用后
- [管理模型授权信息](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0219.md): 如果未对MaaS模型即服务开通授权，则可以在“Maas模型授权”页面，开通服务授权。如果已对MaaS模型即服务开通授权，则“Maas模型授权”页面，显示已开通的模型服务。在“Maas模型授权”查看模型列表、模型版本信息、模型详情，调测模型。登录用户为admin用户组中的用户，华为账号默认为admin用户组中的用户。开通服务授权不会产生费用
- [资源管理](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0220.md): 登录用户为admin用户组中的用户，华为账号默认为admin用户组中的用户。开通AgentArts后，在“资源管理”页面，可以查看资源统计信息、开通的套餐信息。资源统计显示套餐资源数量使用信息及资源总数量信息。当模型资源的“剩余免费额度/总数（tokens）”为“0/2000000”时，需要开通模型资源后才可继续使用，单击“前往模型广场开
- [支持云审计的关键操作](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0225.md): 平台提供了云审计服务（Cloud Trace Service，简称CTS）。通过云审计服务，可记录与AgentArts相关的操作事件，便于日后的查询、审计和回溯。不同套餐包的审计日志存储时长不同，具体可参考计费模式。已开通云审计服务。
- [在CTS事件列表查看云审计事件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0226.md): 云审计服务能够为您提供云服务资源的操作记录，记录的信息包括发起操作的用户身份、IP地址、具体的操作内容的信息，以及操作返回的响应信息。根据这些操作记录，您可以很方便地实现安全审计、问题跟踪、资源定位，帮助您更好地规划和利用已有资源、甄别违规或高危操作。本节介绍如何在云审计服务控制台查看或导出最近7天的操作记录。事件即云审计服务追踪并保存的
- [开发常见报错](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0228.md): AgentArts包括资产广场、智能体管理、组件库、开发配置、运营运维、资源管理等模块。详细展开来说包括：单智能体、工作流、多智能体、公共、组件（插件、MCP、卡片、提示词、知识库）、模型接入、配置管理(意图、数据源)、提示词工程、资产广场、环境管理、License控制、共享资源、记忆管理、导入导出管理等，下面我们将针对各个模块的错误码进
- [购买存储容量](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0231.md): AgentArts基础版的知识库存储容量不支持扩容，如需扩容，需购买AgentArts企业版。AgentArts企业版的知识库存储容量需与KooSearch专享版配套使用。购买KooSearch专享版的操作如下：其中，“问题描述”请填写“使用AgentArts服务的知识库，需开通KooSearch专享版”。
- [更换密钥的加密方式](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0288.md): 在使用AgentArts，创建插件、创建MCP、连接外部知识库、创建模型供应商时，需要对访问凭证进行加密存储，AgentArts提供了对访问凭证的加密方式。如果您的业务对数据存储的安全性和合规性有较高要求，可使用AgentArts提供的服务端加密功能，对上传到AgentArts存储的数据进行加密保护。服务器端加密将对存储在AgentArt

## 最佳实践

- [AgentArts最佳实践汇总](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0001.md): 本文汇总了AgentArts常见场景的操作实践，为每个实践提供详细的方案介绍和操作指导，帮助您深入了解AgentArts的功能。
- [接入和使用DeepSeek模型](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0005.md): AgentArts支持接入兼容OpenAI接口规范的第三方大语言模型。本实践以自定义接入和使用DeepSeek为例，指导您完成从获取API密钥、接入自定义模型到创建问答助手智能体的完整流程。完成本实践后，您将获得一个基于DeepSeek大模型的问答助手智能体，并可参考相同流程接入其他兼容OpenAI接口的第三方模型（如Moonshot、G
- [搭建联网搜索工作流](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0189.md): 在使用大模型处理各类任务时，用户期望能够获得准确、及时的信息支持。然而，大模型默认不具备联网能力，无法获取实时信息，这导致在处理需要最新数据的场景时存在信息滞后和准确性不足的问题。您可以通过添加搜索插件，让工作流在运行时调用搜索引擎获取最新内容。本文演示如何使用代码节点和插件节点，构建一个处理搜索结果的工作流。用户输入关键词，工作流通过插
- [搭建文件解析工作流](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0191.md): 大模型本身不具备直接读取和解析文件的能力，无法处理文件字节流等原始数据。为弥补这一限制，支持工具调用（Function Calling）的模型可以通过插件接入外部工具 API，从而拓展能力边界。资产中心提供了丰富的插件，例如文件解析插件能够将指定链接对应的文件内容解析为纯文本，供大模型进一步理解和处理。本文将演示如何在工作流中配置文件解析
- [搭建数据格式转换工作流](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0192.md): 企业日常运营中经常需要处理CRM、ERP等系统导出的JSON或CSV格式业务数据。这类数据包含大量重复的计算和清洗工作（如汇总销售额、筛选有效订单、按区域分组统计等），大模型虽然擅长文本理解和表达，但不适合进行精确的数学计算和复杂的数据操作。为弥补这一不足，可以在工作流中引入代码节点，利用其执行Python或Node.js代码的能力来处理
- [智能体评估方法](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0089.md): 在智能体开发的早期，最常见的做法是“开发-预览-发布”模式：开发者编写好提示词（Prompt），挂载了知识库和各类工具，在预览聊天框中手动输入5~10个典型问题。如果AI回答得不错，便认为开发完成，直接发布上下。然而面对真实的业务场景，需要长期稳定运行的智能体而言，这种“抽样聊天”的人工测试存在致命的局限性，往往很快就会遇到这些崩溃时刻：
- [评测集设计实践](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0090.md): 在智能体评估体系中，评测集就是发给智能体的那份“考卷”。如果随便导入几十条日常聊天的问答对作为评测集，那么无论评估器多么先进，最终得出的高分也毫无参考价值。高质量的评测集设计不仅要求“考题覆盖全面”，更要求“数据结构精准对齐评估器”。不同的评估器（如幻觉检测、工具参数校验）需要截然不同的上下文背景作为输入。因此，设计评测集的第一步是明确您
- [评估器最优组合实践](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0091.md): 在AgentArts平台中预置了30+不同维度的评估器，很多新手开发者在发起评估任务时往往会犯“选择困难症”，最后为了省事挑选一个最基础的“正确性”评估器。看到评估满分时，即认为智能体已经满足了上线条件。但在真实的业务投产中，往往会面临：回答风格不符：智能体给出的答案确实“正确”，但是内容生硬，排版结构混乱。答案对，但过程错误：订票智能体
- [企业知识问答助手（RAG）智能体评估](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0092.md): 在企业级AI落地中，RAG（检索增强生成）智能体是最普遍、也是最容易让开发者“翻车”的场景。很多开发者随手问了几个文档里的问题，看着回答流畅就直接发布上线了。RAG智能体虽然解决了大模型知识滞后的问题，但引入了新的复杂性。真实的生产环境充满了不可控的边缘场景。缺乏系统性评估的RAG智能体，往往面临着：幻觉：当询问知识库中没有的信息时，或者
- [手动搭建智能客服智能体](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0008.md): 智能客服智能体可以自动响应并自动处理用户咨询，提高客户满意度和运营效率。本文将帮助您在AgentArts中搭建一个智能客服智能体应用，提供全天候的在线咨询服务。向智能体输入问题时，智能体会自动解析问题内容，理解其核心需求，并生成相应的解决方案。智能体会利用其内部的模型和技能，结合问题的上下文信息，确保提供的解决方案既准确又高效。例如输入“
- [搭建知识问答助手工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0010.md): 知识问答助手对话流，支持用户与助手进行日常对话，分享心情、趣事等。用户在遇到压力或情绪问题时，与助手进行交流，获得安慰和建议。还可以针对自己感兴趣的学科进行知识问答游戏、咨询和提问。本实践将详细介绍如何利用意图识别节点、提问器节点、大模型节点、判断节点、消息节点和变量聚合节点等搭建一个问答助手工作流。和知识问答助手进行互动时，问答助手可以
- [搭建知识问答助手工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0011.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用平台预置的DeepSeek-V3模型。在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制和删除。单击“开始”节点，该节点已默认配置query参数，表示用户输入
- [创建语文知识库](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0003.md): 知识库是一个组织、存储及管理知识的系统，包括文档、图表、表格等多种形式的信息的分类、整理和归纳，可以帮助用户组织和管理大量的信息，平台为用户提供了创建并管理知识库的能力，且创建的知识库可在工作流和Agent中调用。对于需要处理大量问答知识、对检索效率有较高要求的场景，通过创建知识库组织和管理信息，可以提升信息获取效率。本实践以创建语文知识
- [搭建辅助批改作业工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0014.md): 在教育技术不断进步的今天，辅助批改作业提供“自动批改+详细解析+个性化反馈”的全流程支持，成为学生作业批改的高效助手。这种技术驱动的批改方式旨在减轻教师的工作负担，同时为学生提供即时准确的反馈，帮助他们更好地理解和掌握知识。本实践将详细介绍如何利用大模型节点、消息节点搭建一个辅助批改作业的工作流。向辅助批改作业提问时，该工作流应用能提供答
- [搭建辅助批改作业工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0015.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用平台预置的DeepSeek-V3模型。在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制和删除。删除“大模型”节点和“结束”节点的连线。单击添加节点，选择消息
- [搭建智能助教工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0017.md): 在教育数字化与 "双减" 背景下，智能助教助手以知识图谱 + 自然语言处理技术，化身语文学习全场景伙伴，提供即时问答 + 分层解析 + 情境拓展陪伴链。它以技术驱动个性化学习，让每个学生拥有专属语文空间，通过智能技术引导学生探索语言的魅力，同时加深对中国文化的理解。本实践将详细介绍如何利用不同的节点搭建一个语文知识智能助教的工作流，通过该
- [搭建智能助教工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0018.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用平台预置的DeepSeek-V3模型。搭建助教工作流前须完成语文知识库创建，详见创建语文知识库。在工作流编排页面，平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除操作。开始和结束节点为必选节点，不支持重命名、复制和删除。鼠标
- [附录](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0019.md): 本章节提供的语文知识库仅供参考。如需使用，请手动复制到word文档中。用户可根据实际情况自定义知识库。第一部分：基础知识 1. 下列词语中，字形和加点字的读音全部正确的一项是（） A. 确凿 (záo) 蝉蜕 (tuì) 人声鼎沸来势凶凶 B. 骊歌 (lí) 木屐 (jī) 荒草萋萋人迹罕至 C. 嫉妒 (jí) 澎湃 (pài)
- [搭建病历生成助手工作流场景介绍](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0032.md): 当前医生面临门诊量大、问诊时间有限、病历书写负担重等挑战，为提升诊疗效率与病历质量，降低医疗误差，我们搭建一款能够实时理解医患对话、自动生成“一诉五史”（主诉、现病史、既往史、个人史、家族史、过敏史）、关键查体要点及初步诊断的智能辅助系统，从而优化诊疗流程，提升医疗服务质量。本实践将详细介绍如何利用大模型节点，搭建病历生成助手。在与病历生
- [搭建病历生成助手工作流操作流程](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0033.md): 已实名认证的华为账号或IAM用户。已开通AgentArts服务。本实践选用平台预置的DeepSeek-V3模型。本章节主要介绍如何在工作流编排页面配置生成一诉五史、生成查体、生成诊断大模型以及结束节点，以形成一个完整的工作流应用。平台已预设了开始、大模型和结束节点。单击节点右上角的，可以对当前节点执行重命名、复制、删除操作，开始和结束节点
- [方案概述](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0045.md): 茶叶销售公司希望通过AI智能体推广其茶叶产品。公司提供的茶叶产品有三种品类（productmodel），分别是红茶、绿茶和普洱。每个品类又细分为普通、高级和奢华三个等级（class）。每个品类和等级根据当前价格有不同的折扣率（voucher），而整体价格计算则需根据提供的相应数量件数（count）。用户诉求：能够根据用户提供的数量、品类、
- [创建茶叶产品介绍知识库](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0048.md): 搭建茶叶销售助手前，需要先创建关于茶叶的知识库。已实名认证的华为账号或IAM用户。已开通AgentArts服务。准备需要上传的知识素材，本实践使用的知识库请参见附录，仅供参考。待文件状态为“成功”，即完成文件解析。命中结果可根据右上方的分值查看结果，分值越高，命中结果越精确。命中测试如果满足需求，则知识库接入完成，您可以在智能体或工作流中
- [搭建产品介绍工作流](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0049.md): 该工作流能够根据客户的产品查询需求，提供准确的产品类别和产品描述。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的产品咨询/客服问答等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。大模型节点：该节点将从用户输入中提取并解析问题，并用JSON格式输出。知识检索节点：该节点从预
- [搭建产品筛选工作流](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0051.md): 该工作流能够根据用户提供的数量、品类、等级和折扣率要求进行产品筛选。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的产品采购等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。提问器节点：该节点负责从用户输入中提取用户需要购买的茶叶品类，等级，数量以及优惠比例等信息。结束节点：
- [搭建产品结算工作流](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0052.md): 该工作流能够根据用户提供的数量、品类、等级和折扣率进行汇总计算价格。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入以及提取用户需要购买的茶叶品类，等级，数量以及优惠比例等信息。语音输入时，须在工作流全局配置节点开启“语音交互”功能。大模型节点：该节点将根据客户选择的产品类别（product
- [搭建产品采购工作流](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0053.md): 该工作流能够根据用户提供的数量、品类、等级和折扣率要求进行产品筛选，并汇总计算筛选结果的价格。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的产品采购等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。工作流节点-产品筛选：该节点添加产品筛选工作流，用于提取产品信息，包括产品数
- [子场景3：客服支持](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0054.md): 该工作流能够及时响应客户对产品的投诉和服务支持。开始节点：作为工作流的入口，开始节点负责接收用户输入的文本或语音。在该工作流中，接收的是用户输入的客服问答等问题。语音输入时，须在工作流全局配置节点开启“语音交互”功能。提问器节点：该节点负责从用户输入中提取用户问题。意图识别节点：该节点负责判断用户输入的问题属于服务支持类还是投诉类，并根据
- [主智能体场景：搭建茶叶销售多智能体应用](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0055.md): 通过在多智能体中配置产品介绍、产品采购和客服支持工作流，支持根据用户意图在不同工作流中进行选择和跳转，灵活满足客户业务诉求。已完成子场景1：产品介绍。已完成子场景2：产品采购。已完成子场景3：客服支持。本实践选用平台预置的DeepSeek-V3模型。创建后，进入“多智能体配置”页面，初始只有一个“多Agent控制器”节点。创建的多智能体应
- [附录](https://support.huaweicloud.com/bestpractice-agentarts0/agentarts_06_0056.md): 本章节提供的茶叶产品介绍知识库仅供参考。如需使用，请手动复制到word文档中。用户可根据实际情况自定义知识库。

## API参考

- [使用前必读](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0001.md): 欢迎使用AgentArts服务。AgentArts服务是一个一站式企业级智能体构建平台，包含应用管理、组件库、知识库、提示词开发、配置管理、模型接入调测等功能模块，覆盖体验设计、代码开发、应用运行、资产管理、数据处理、测试发布、运营监控、安全保障八大面，为企业级用户提供开箱即用的大模型应用开发工具链。依托强大的应用开发工具链，AgentA
- [API概览](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0002.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [构造请求](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0004.md): 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户接口说明如何调用API。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987 。请求URI由如下部分组成。{URI-scheme} :// {Endpoint} / {resourc
- [认证鉴权](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0005.md): Token认证：通过Token认证调用请求。Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。使用Token前请确保Token离过期有足够的时间，防止调用API的过程中Token过期导致调用API失败。Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就
- [返回结果](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0006.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。对应请求消息头，响应同样也有消息头，如“Content-type”。对于管理员创建IAM用户接口，返回
- [调用工作流应用 - runWorkflow](https://support.huaweicloud.com/api-agentarts0/runWorkflow.md): 该接口用于运行场景化应用，支持在指定的项目、工作流和对话上下文中执行工作流逻辑。接口支持流式响应模式，可以根据需要返回增量执行结果，适用于实时交互场景。适用场景：在项目中运行预定义的工作流。在项目中运行预定义的工作流。支持调试模式和发布模式，适用于不同开发和生产环境。支持调试模式和发布模式，适用于不同开发和生产环境。支持流式响应，适用于需
- [调用智能体应用 - runAgent](https://support.huaweicloud.com/api-agentarts0/runAgent.md): 该接口用于运行知识型智能体应用，支持单智能体和多智能体，支持在指定的项目、智能体和对话上下文中执行智能体逻辑。接口支持流式响应模式，可以根据需要返回增量执行结果，适用于实时交互场景。适用场景：在项目中运行预定义的知识型智能体应用。在项目中运行预定义的知识型智能体应用。支持调试模式和发布模式，适用于不同开发和生产环境。支持调试模式和发布模式
- [上传文件 - AgentUploadFile](https://support.huaweicloud.com/api-agentarts0/AgentUploadFile.md): 该接口用于工作流、智能体上传文件，支持多种图片、文档、表格等多种格式的文件上传。接口返回临时下载路径，可用于临时下载文件。适用场景：在智能体应用中上传文件。格式要求：办公文档：DOC、DOCX、XLS、XLSX、PPT、PPTX、PDF、Numbers、CSV。办公文档：DOC、DOCX、XLS、XLSX、PPT、PPTX、PDF、Num
- [知识库检索 - OpenBatchRetrieveKnowledgeBase](https://support.huaweicloud.com/api-agentarts0/OpenBatchRetrieveKnowledgeBase.md): 提供多知识库并行检索能力，支持语义、关键词、混合及FAQ四种检索模式，并允许自定义相似度阈值与返回结果数量，实现精准高效的信息匹配。适用场景：同时从多个知识库或文档集合中搜索相关内容。同时从多个知识库或文档集合中搜索相关内容。在预设的问答列表中快速定位最相关的答案（FAQ检索）。在预设的问答列表中快速定位最相关的答案（FAQ检索）。通过混
- [获取知识库检索图片 - OpenQueryImage](https://support.huaweicloud.com/api-agentarts0/OpenQueryImage.md): 通过图片ID获取知识库检索图片。适用场景：当知识库检索接口的返回内容中包含知识库图片标签{KI|image_id}时，可通过解析标签中的image_id调用本接口获取对应图片。当知识库检索接口的返回内容中包含知识库图片标签{KI|image_id}时，可通过解析标签中的image_id调用本接口获取对应图片。当知识库检索接口返回image
- [调用工作流应用示例](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0010.md): 该接口用于运行场景化应用，支持在指定的项目、工作流和对话上下文中执行工作流逻辑。接口支持流式响应模式，可以根据需要返回增量执行结果，适用于实时交互场景。适用场景：在项目中运行预定义的工作流。在项目中运行预定义的工作流。支持调试模式和发布模式，适用于不同开发和生产环境。支持调试模式和发布模式，适用于不同开发和生产环境。支持流式响应，适用于需
- [调用智能体应用示例](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0011.md): 该接口用于运行知识型智能体应用（单智能体应用、多智能体应用），支持在指定的项目、智能体和对话上下文中执行智能体逻辑。接口支持流式响应模式，可以根据需要返回增量执行结果，适用于实时交互场景。适用场景：在项目中运行预定义的知识型智能体应用。在项目中运行预定义的知识型智能体应用。支持调试模式和发布模式，适用于不同开发和生产环境。支持调试模式和发
- [状态码](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0016.md): 状态码如表1所示。
- [错误码](https://support.huaweicloud.com/api-agentarts0/ErrorCode.md): 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
- [获取项目ID](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0018.md): 项目ID还可通过调用查询指定条件下的项目信息API获取。获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。响应示例如下，其中projects下的“id”即为项目ID。在调用接口的时候，部分URL中
- [获取账号ID](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0019.md): 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下：
- [获取工作区ID](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0020.md): 在调用接口的时候，部分URL中需要填入工作区ID，工作区ID获取方法如下。

## 常见问题

- [单智能体应用与多智能体应用是否可以切换？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0002.md): 单智能体应用与多智能体应用之间不可切换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [工作流应用和多智能体应用有什么区别？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0003.md): 工作流应用是多智能体应用的组成元素，多智能体应用通过控制器可以执行多个工作流并根据用户输入意图在不同工作流之间跳转。工作流应用只是单工作流的运行。
- [在单智能体应用中使用工作流与在多智能体应用中使用工作流有什么区别？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0004.md): 多智能体应用可灵活管控工作流执行逻辑，通过控制器管理多个工作流，并根据用户意图在不同工作流间跳转。单智能体应用由大模型自主决策是否调用工具（含工作流）及调用哪个工具。
- [单智能体/工作流应用中的知识库检索策略为什么不一致？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0005.md): 知识库的检索策略是根据知识库本身的能力提供的。对于默认类型的知识库，支持语义检索、关键词检索、混合检索、FAQ检索；对于从第三方接入的知识库（RAGFlow），只支持语义检索。
- [单智能体应用与多智能体应用是否可以切换？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0002.md): 单智能体应用与多智能体应用之间不可切换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [工作流应用和多智能体应用有什么区别？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0003.md): 工作流应用是多智能体应用的组成元素，多智能体应用通过控制器可以执行多个工作流并根据用户输入意图在不同工作流之间跳转。工作流应用只是单工作流的运行。
- [在单智能体应用中使用工作流与在多智能体应用中使用工作流有什么区别？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0004.md): 多智能体应用可灵活管控工作流执行逻辑，通过控制器管理多个工作流，并根据用户意图在不同工作流间跳转。单智能体应用由大模型自主决策是否调用工具（含工作流）及调用哪个工具。
- [单智能体/工作流应用中的知识库检索策略为什么不一致？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0005.md): 知识库的检索策略是根据知识库本身的能力提供的。对于默认类型的知识库，支持语义检索、关键词检索、混合检索、FAQ检索；对于从第三方接入的知识库（RAGFlow），只支持语义检索。
- [为什么在单智能体中无法添加知识库？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0007.md): 在单智能体添加知识库界面，没有找到自己创建的知识库，无法添加知识库。目前单智能体模式中的添加知识库，需要确保知识库是已经启用的状态，未启用的知识库，是无法添加的。
- [为什么单智能体模式有的工作流无法添加？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0009.md): 我自己创建工作流后，在单智能体添加工作流界面，无法添加。工作流必须是已经发布的状态才能被单智能体添加，未发布的工作流无法在单智能体添加工作流界面找到以及添加。在左侧导航栏中选择开发中心 > 智能体管理，单击“单智能体”页签，进入单智能体应用管理界面。单击目标单智能体应用，在应用配置页签中，单击工作流右侧的添加工作流。在“添加工作流”窗口，
- [单智能体模式支持上传文件吗？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0011.md): 单智能体支持上传文件，目前单智能体模式支持图片文件、音频文件和文档文件等。支持上传image、audio、excel、csv、docx等格式的文件。最多支持上传10个文件。
- [在和单智能体交互的时候，能否看到给大模型最原始的输入？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0012.md): 在单智能体交互界面，单击右上角的调试按钮，可以回溯你和大模型的原始输入。支持查看会话的运行结果与调用详情。
- [为什么在单智能体中无法添加知识库？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0007.md): 在单智能体添加知识库界面，没有找到自己创建的知识库，无法添加知识库。目前单智能体模式中的添加知识库，需要确保知识库是已经启用的状态，未启用的知识库，是无法添加的。
- [为什么单智能体模式有的工作流无法添加？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0009.md): 我自己创建工作流后，在单智能体添加工作流界面，无法添加。工作流必须是已经发布的状态才能被单智能体添加，未发布的工作流无法在单智能体添加工作流界面找到以及添加。在左侧导航栏中选择开发中心 > 智能体管理，单击“单智能体”页签，进入单智能体应用管理界面。单击目标单智能体应用，在应用配置页签中，单击工作流右侧的添加工作流。在“添加工作流”窗口，
- [单智能体模式支持上传文件吗？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0011.md): 单智能体支持上传文件，目前单智能体模式支持图片文件、音频文件和文档文件等。支持上传image、audio、excel、csv、docx等格式的文件。最多支持上传10个文件。
- [在和单智能体交互的时候，能否看到给大模型最原始的输入？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0012.md): 在单智能体交互界面，单击右上角的调试按钮，可以回溯你和大模型的原始输入。支持查看会话的运行结果与调用详情。
- [工作流中知识检索运行失败：Plugin restful api response http code error, root cause = plugin response code 404 error.](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0019.md): 执行报错，错误码：105011，错误信息：Plugin restful api response http code error, root cause = plugin response code 404 error.，请参考产品文档解决或联系系统管理员。配置的知识库不存在。
- [对话型工作流、任务型工作流是否可以相互转换？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0020.md): 对话型工作流与任务型工作流之间不可相互转换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [为什么提问器提取问题答案不准确？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0021.md): 在工作流中提问器提取问题答案不准确。问题不明确，提示词不适配。在提问器节点中补充配置校验，提取约束（提示词），示例等参数使提取更准确。
- [为什么在工作流中配置了大模型却没有内容输出？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0022.md): 工作流中增加了大模型组件，但是没有内容输出。模型提示词配置不正确或模型输出未被输出节点（消息节点、结束节点）使用。
- [大模型节点如何输出多个参数？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0023.md): 在使用大模型节点时，如果需要输出多个参数，应如何配置节点实现输出多个参数？大模型节点通常默认配置输出为文本格式，为了实现多参数输出，需要对节点的输出配置进行调整，以确保大模型能够正确解析和输出多个参数。
- [工作流中知识检索运行失败：Plugin restful api response http code error, root cause = plugin response code 404 error.](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0019.md): 执行报错，错误码：105011，错误信息：Plugin restful api response http code error, root cause = plugin response code 404 error.，请参考产品文档解决或联系系统管理员。配置的知识库不存在。
- [对话型工作流、任务型工作流是否可以相互转换？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0020.md): 对话型工作流与任务型工作流之间不可相互转换。在创建应用时，需要先选择创建类型，创建后类型不可修改。
- [为什么提问器提取问题答案不准确？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0021.md): 在工作流中提问器提取问题答案不准确。问题不明确，提示词不适配。在提问器节点中补充配置校验，提取约束（提示词），示例等参数使提取更准确。
- [为什么在工作流中配置了大模型却没有内容输出？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0022.md): 工作流中增加了大模型组件，但是没有内容输出。模型提示词配置不正确或模型输出未被输出节点（消息节点、结束节点）使用。
- [大模型节点如何输出多个参数？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0023.md): 在使用大模型节点时，如果需要输出多个参数，应如何配置节点实现输出多个参数？大模型节点通常默认配置输出为文本格式，为了实现多参数输出，需要对节点的输出配置进行调整，以确保大模型能够正确解析和输出多个参数。
- [为什么多智能体应用返回为空？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0025.md): 与多智能体应用进行会话时，返回为空。根据用户问题，多智能体应用未识别到对应的子工作流。多智能体应用未配置默认工作流。用户输入的问题，需要与子工作流的任务相关。多智能体应用依赖用户输入的问题来执行对应的子工作流，与多智能体应用进行会话时，输入的问题需与子工作流的任务相关才能执行对应工作流。输入与工作流任务相关的问题多智能体应用依赖用户输入的
- [为什么多智能体应用返回为空？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0025.md): 与多智能体应用进行会话时，返回为空。根据用户问题，多智能体应用未识别到对应的子工作流。多智能体应用未配置默认工作流。用户输入的问题，需要与子工作流的任务相关。多智能体应用依赖用户输入的问题来执行对应的子工作流，与多智能体应用进行会话时，输入的问题需与子工作流的任务相关才能执行对应工作流。输入与工作流任务相关的问题多智能体应用依赖用户输入的
- [创建第三方知识库时为什么查不到知识库列表？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0027.md): 创建第三方知识库时为什么查不到知识库列表？原因1：第三方知识库列表本身没有接入知识库。原因2：外部知识库连接信息配置有误。原因1解决方案：需在第三方知识库平台创建知识库。原因2解决方案：登录AgentArts智能体开发平台，在左侧导航栏“个人空间”区域，选择目标空间。在左侧导航栏中选择“开发中心 > 组件库”。选择知识库页签，切换至“外部
- [外部知识库连接中的已启用/已停用状态如何更改？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0028.md): 在外部知识库连接中，已启用状态表示已经从此连接中接入了一个或多个知识库，已停用状态表示还未从此连接中接入过知识库，两个状态为自动切换，无需用户手工操作。当您想要删除某个外部知识库连接时，需要先把此知识库连接中的知识库从知识库列表中全部取消接入，使此外部知识库连接变为已停用状态，才可以继续删除。
- [创建第三方知识库时为什么查不到知识库列表？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0027.md): 创建第三方知识库时为什么查不到知识库列表？原因1：第三方知识库列表本身没有接入知识库。原因2：外部知识库连接信息配置有误。原因1解决方案：需在第三方知识库平台创建知识库。原因2解决方案：登录AgentArts智能体开发平台，在左侧导航栏“个人空间”区域，选择目标空间。在左侧导航栏中选择“开发中心 > 组件库”。选择知识库页签，切换至“外部
- [外部知识库连接中的已启用/已停用状态如何更改？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0028.md): 在外部知识库连接中，已启用状态表示已经从此连接中接入了一个或多个知识库，已停用状态表示还未从此连接中接入过知识库，两个状态为自动切换，无需用户手工操作。当您想要删除某个外部知识库连接时，需要先把此知识库连接中的知识库从知识库列表中全部取消接入，使此外部知识库连接变为已停用状态，才可以继续删除。
- [在插件使用IP地址，为什么会调试失败？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0030.md): 在插件中使用IP地址请求可能会被服务端的网络安全设置所拦截。因此建议在配置插件的URL或抓取类插件的参数URL时，使用域名而非IP地址。
- [如何配置插件请求参数中的默认值？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0031.md): 配置请求参数的默认值可有效避免大模型运行时因插件参数值缺失而导致的报错。同时，针对一些值较为稳定的参数，设置其默认值且隐藏其可见性可减少大模型的无效判断，从而提高插件调用效率。在为插件中的工具设置参数配置时，您可以在请求头（Header）、请求体（Body）和查询参数（Query）中添加参数，并为这些参数配置默认值。下面以在请求头（Hea
- [插件的输入参数支持图片格式吗？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0032.md): 插件的输入参数不支持图片格式。目前支持的输入参数的类型包括：String、Number、Integer、Boolean、Object、Array<String>、Array<Number>、Array<Integer>、Array<Boolean>和Array<Object>。
- [工作流添加插件节点执行报错？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0033.md): 用户配置新插件并添加到工作流中时，执行报错。
- [在插件使用IP地址，为什么会调试失败？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0030.md): 在插件中使用IP地址请求可能会被服务端的网络安全设置所拦截。因此建议在配置插件的URL或抓取类插件的参数URL时，使用域名而非IP地址。
- [如何配置插件请求参数中的默认值？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0031.md): 配置请求参数的默认值可有效避免大模型运行时因插件参数值缺失而导致的报错。同时，针对一些值较为稳定的参数，设置其默认值且隐藏其可见性可减少大模型的无效判断，从而提高插件调用效率。在为插件中的工具设置参数配置时，您可以在请求头（Header）、请求体（Body）和查询参数（Query）中添加参数，并为这些参数配置默认值。下面以在请求头（Hea
- [插件的输入参数支持图片格式吗？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0032.md): 插件的输入参数不支持图片格式。目前支持的输入参数的类型包括：String、Number、Integer、Boolean、Object、Array<String>、Array<Number>、Array<Integer>、Array<Boolean>和Array<Object>。
- [工作流添加插件节点执行报错？](https://support.huaweicloud.com/agentarts0_faq/agentarts_09_0033.md): 用户配置新插件并添加到工作流中时，执行报错。