新版智能体应用（Agent 2.0）将知识库、MCP 等多种能力统一为工具，并通过自主思考和规划来调用，以解决复杂任务。
版本对比与选型建议
新版智能体为大多数应用场景提供了更优的性能和开发体验，在没有旧版本依赖需求时，推荐使用新版。
对比维度 | 旧版本（Agent 1.0） | 新版本（Agent 2.0） |
规划与调度 | 智能体在检索知识库后，再决策是否调用 MCP 等其他工具。 | 将知识库、MCP 统一为工具，由智能体自主规划在何时、以何种顺序进行调用。 |
过程透明度 | 只展示最终结果，无法完整回溯中间决策。 | 能完整展示每一轮的“规划-执行-反思”链路的全过程。 |
适用场景 | 适用于意图单一、流程固定的简单任务。 | 能够完成从简单问答到复杂规划的各类任务。 |
示例对比
旧版 | 新版 |
|
|
|
|
快速开始：创建一个基础智能体
访问阿里云百炼控制台应用管理，单击创建应用，选择。
填写应用名称，单击立即创建。创建完毕后自动跳转至应用配置界面。
在模型选择器的下拉菜单中选择模型，例如
通义千问-Plus-Latest。
在右侧对话框中输入问题：
你是谁？。
能力配置
模型选择
为确保多步规划效果，推荐选用具备强工具调用能力的模型，如通义千问-Max系列模型。
在模型选择器的下拉菜单中选择模型。单击更多模型可以选择其他模型。
单击模型选择器右侧的参数配置器，支持修改的参数如下：
最长回复长度：模型生成的长度限制，不包含提示词。
temperature：控制生成随机性和多样性，数值越高随机性越强。
enable_thinking：是否开启思考模式。开启思考模式有助于提升智能体的反思效果。不支持思考模式的模型无法配置 enable_thinking 参数。
系统提示词
系统提示词用于定义智能体角色、行为指令与能力边界，以确保其在交互中始终保持一致性、可控性和任务合规性。
配置系统提示词
配置系统提示词为
请你模仿《百年孤独》的风格来回答我的问题，以下是效果对比：无系统提示词：
配置系统提示词：
在系统提示词中使用自定义变量（可选）
除了支持输入静态文本，系统提示词还允许嵌入自定义变量。
单击系统提示词右上方的新建变量，设置自定义变量，单击确定保存。
输入
/，使用已配置的变量。
预解析文件
预解析文件功能用于控制上传文件的处理方式。
关闭预解析：关闭后，系统不会主动解析文件。文件的 URL 会作为上下文信息传递给智能体，智能体可在后续步骤中决策是否调用工具，并将该 URL 作为参数传入。
开启预解析：开启后，系统将使用预置解析器处理上传的文档、图像、视频、音频等文件，并返回解析后的文本内容给模型作为参考。
通义千问-VL 系列模型由于具备多模态能力，即使关闭预解析文件，也能够直接解析图片和视频文件。
在其他所有情况下（例如，使用不具备多模态能力的文本模型，或使用通义千问-VL 系列模型处理非图像/视频文件时），智能体的文件处理能力则严格遵循上述“开启”或“关闭”的逻辑。
知识库
知识库使智能体能够查询外部信息，并将检索到的内容作为生成答案的依据。在新版智能体中，知识库作为智能体的一项技能，作为工具由智能体自主规划调用。这种主动获取知识的方式，在处理私有知识或垂直领域问答时，能提升回答的准确率并有效减少内容幻觉。详情请参考知识库。
在回复中开启展示回答来源可以展示知识来源和源文件地址。
配置阿里云百炼系列手机产品介绍.docx作为知识库后，以下是输出效果对比：
无知识库。模型因缺乏相关知识，无法回答有关“百炼手机”的问题。
配置知识库。模型从知识库中检索到“百炼手机”的相关信息，并据此生成了准确的回答。
MCP
在新版智能体中，外部工具均以 MCP 协议接入智能体，并纳入调度体系，包括来自MCP 广场的官方 MCP 和自定义 MCP 服务。智能体能够在多步推理中，对 MCP 进行动态的、非固定顺序的调用，以解决更复杂的任务。此外，插件也支持一键转换为 MCP 服务。
记忆
短期记忆：新版智能体支持短期记忆功能，即在多轮会话中为智能体提供上下文信息。可以设置 0 到 30 轮的上下文（0 代表不传递多轮对话记录）；轮数越多，对话相关性越强，但输入长度也会相应增加。
长期记忆：该功能计划在未来的迭代中支持。
回复
回复支持展示回答来源。开启后，将以角标形式展示知识来源和源文件/源网页地址。该功能推荐与知识库和联网搜索 MCP 组合使用。
运行与结果分析
完成应用配置后，可在页面右侧的对话窗口中运行智能体。对于需要多步规划的复杂请求，新版智能体会以卡片流的形式，展示其决策过程和运行轨迹，该过程主要包含以下两种步骤：
思考 (Thinking)：此步骤展示模型的推理逻辑，便于分析其决策路径并定位非预期行为的根源（仅当选用支持思考模式的模型时出现）。
工具调用：此步骤记录了模型执行的具体工具调用入参及其返回的结果。
通过配置 ReAct 最大轮次（取值范围 1-50），用于限制智能体在单次会话中可以调用工具的最大次数，当超出此限制后将会自动退出工具调用链路，并由智能体生成最终回复。
应用发布与集成
应用发布是后续所有智能体应用调用、集成的前提条件。
应用发布
在应用配置页面的右上角，单击发布按钮，在弹出窗口中会展示自上次发布以来的配置变更差异。确认发布信息无误后，单击确认发布，即可完成应用发布。
通过 API 调用
您可以在智能体应用发布渠道页签，单击API调用右侧的查看API，查看通过 API 调用新版智能体应用的方法。详情参考新版智能体应用 API 参考。
应用管理
版本管理
通过版本管理功能，可以编辑历史版本描述信息，或回滚发布过的历史版本。
在应用配置页，单击顶部导航栏右侧的版本管理。
选中需要回滚的历史版本，将鼠标悬浮至卡片上，单击右上角编辑图标，在编辑版本描述对话框中按需完成修改后，单击确定，即可修改历史版本描述信息。单击覆盖当前草稿，即可回滚至该版本。
安全与合规
应用合规备案
若应用对外提供服务，必须遵守国家网信办《生成式人工智能服务管理暂行办法》等法规，完成必要的应用合规备案。
计费说明
智能体功能计费主要体现在以下几个方面：
常见问题
支持将旧版智能体升级到新版本吗？
不支持。旧版智能体和新版智能体基于不同的技术架构，彼此不兼容，无法进行直接的版本切换、升级或降级。
如果您当前在使用旧版智能体，并希望体验新版智能体的功能，请您前往控制台重新创建一个新版智能体应用。
为什么智能体未按预期调用已配置的工具？
可从以下四个层面进行排查：
技能配置与挂载：请核实该技能是否已成功创建并正确挂载到当前智能体应用中。
系统提示词的引导性：请检查系统提示词是否清晰地描述了该技能的功能、参数以及适用的场景。模型依赖这些描述信息来决策何时调用技能。
意图与技能的相关性：请评估问题的表述是否清晰，其意图是否能明确指向特定技能。如果意图模糊或与技能功能不相关，模型可能选择不调用。
执行轮次限制：请检查是否达到了 ReAct 轮次上限。智能体可能已规划调用该技能，但在执行到该步骤前因轮次耗尽而被强制终止。