阿里云百炼支持零代码创建智能体应用。应用可集成RAG(Retrieval-Augmented Generation,检索增强生成)、插件、应用组件、MCP及长期记忆等功能。创建完成后,应用支持多渠道发布。
为什么使用智能体应用
大语言模型(LLM)虽具备强大的语言能力,但存在固有局限:
无法访问私有知识,如公司制度或人员信息。
缺乏实时信息,如当前天气或比赛结果。
专业任务处理能力有限,如精确计算或图像生成
智能体应用通过集成外部能力,弥补了LLM的上述不足。使用阿里云百炼控制台,可零代码创建智能体应用,集成所需外部能力以解决业务问题。
外部能力指LLM自身不具备的功能,如信息检索或调用工具。
智能体应用主要场景包括:
私有领域知识问答
上传知识库文件,即可在阿里云百炼控制台创建私域问答应用,用于解答公司制度、人员信息等问题。
个性化聊天机器人
阿里云百炼提供长期记忆功能,可保存关键对话历史,实现个性化聊天。集成夸克搜索、图像生成等插件可进一步扩展机器人功能。
智能助手
结合RAG、长期记忆及自定义插件,可构建智能助手。该助手能处理邮件、撰写周报,提升工作效率。
步骤一:创建智能体应用
直接创建
1. 创建应用访问阿里云百炼控制台应用管理,单击新增应用,在智能体应用页签,单击立即创建。 如果您之前已创建过应用,则单击右上角的新增应用。 | |
2. 选择大模型并配置参数进入智能体应用管理界面后,您需要进行大模型的选择与参数配置。您可以参考右图,单击设置,并在模型选择的下拉菜单中选择模型,此处选择通义千问-Max。您可以根据需求进行模型参数的配置,参数详情请将鼠标移动到 说明 DeepSeek-R1 系列模型暂不支持设置温度系数。 最新的 Qwen3 模型支持以下参数:
| 最新的 Qwen3 模型支持以下参数: |
3. 测试应用选择大模型之后,您就在阿里云百炼创建完成了一个智能体应用。您可以输入问题进行测试。 |
通过应用模板创建应用
1. 创建应用访问阿里云百炼控制台应用广场,选择应用模板标签页。单击你要添加的应用模板,进入模板测试界面。点击复制此应用,在弹窗中填写基本信息(填写应用名称,选择应用空间),点击复制创建应用。 | |
2. 调整大模型并配置参数使用模板创建的应用保存在应用管理页面,您可以继续浏览和编辑。 |
步骤二:拓展智能体应用的能力
您可以在智能体应用管理界面,通过设置Prompt、添加RAG与插件等方法拓展智能体应用的能力。
系统提示词(System Prompt):指引内容生成方向
您可以在智能体应用管理界面中输入Prompt来指引应用生成内容的方向。例如设置Prompt为:
输入“你好”,智能体应用的输出如右图。 说明 针对 DeepSeek R1 系列模型,DeepSeek官方不建议设置系统提示词,原文如下:"Avoid adding a system prompt; all instructions should be contained within the user prompt." | |
您可以在提示词中引用变量,点击提示词下方变量中自定义变量增加自定义变量并在提示词中引用。 |
知识检索增强(RAG):提升私域知识问答能力
RAG (Retrieval-Augmented Generation) 是一种检索技术,它通过自动检索相关文档内容,并将这些信息作为上下文输入给智能体,从而提高智能体的回复准确率。特别是在处理私有知识或垂直领域问答时,RAG能显著提升智能体的效果。
提示: RAG 检索到的文本也会占用大模型的上下文窗口长度(Context Window),因此需要根据实际情况调整检索策略和文本长度,以充分利用上下文窗口并避免超出限制。
1. 上传数据访问应用数据,单击导入数据。此处选择阿里云百炼系列手机产品介绍.docx作为知识库文件。在导入数据界面,将文件通过本地上传方式导入。 | |
2. 创建知识库
| |
3. 在应用中集成RAG
|
MCP 服务:接入海量第三方应用的工具集
智能体支持接入 MCP 服务。阿里云百炼提供了多种官方MCP服务。您可以在智能体应用管理界面单击+MCP,便可以在MCP广场中选择一个或多个MCP服务。具体MCP服务使用案例,请参见官方 MCP 服务。
同时您也可以添加自定义 MCP 服务,详情请查看自定义 MCP 服务。
1. 添加服务此处以Amap Maps为例,勾选对应服务后,点击确定。 您可以在同一个智能体应用中选择最多5个MCP服务。智能体应用会根据输入选择使用一个或多个MCP服务。 使用Amap Maps之前需要开通服务,具体请参见官方 MCP 服务。 | |
2. 测试插件效果添加服务后,向输入框输入: 现在出发,从杭州萧山国际机场到杭州西湖景区。请你提供三种公共交通出行方案。 智能体应用的回复如右图,可以看到智能体应用多次调用MCP服务,完成路径规划和时间估算。 |
插件:接入图像视频、代码执行等更多效率工具
插件可以使智能体应用更高效、更专业地应用到业务场景中。阿里云百炼提供了多种官方插件。您可以在智能体应用管理界面单击选择插件,便可以在插件栏中选择一个或多个插件。
同时您也可以添加自定义插件,详情请查看插件概述。
1. 添加插件此处以图片生成插件为例,选择对应插件后,单击添加至智能体。 | |
2. 测试插件效果添加插件后,向输入框输入: 画一只猫。 智能体应用的回复如右图,可以看到智能体应用调用了图像生成插件(即text_to_image)。 | |
3. 使用更多插件您可以在同一个智能体应用中选择最多10个插件。智能体应用会根据输入选择使用一个或多个插件。比如提问: 查一下杭州明天的天气,并将这个天气的西湖画出来。 智能体应用会输出如右图的内容。 |
智能体和工作流组件:接入模块化应用,实现功能复用
您可以接入模块化的智能体或工作流组件,实现功能复用,加速复杂 AI 应用开发。您也可以将智能体和工作流应用发布为组件。详情请参考发布为组件。
1. 添加组件在智能体应用编辑界面,添加智能体或工作流组件。此处以添加智能体组件为例,勾选对应组件后,点击确认。 您可以在同一个智能体应用中选择最多5个组件。 | |
2. 配置参数智能体会根据组件的描述自动推断并填入合适的参数。如果组件包含需要业务透传的参数,您需要在测试时手动填入入参变量配置,或者在 API 调用时通过 |
长期记忆:保存个性化信息
智能体应用具备短期对话记忆能力,但受限于大模型注意力机制,可能无法长时间保持上下文连贯性。 长期记忆功能允许大模型自动存储个性化信息,确保智能体应用在后续对话中能够持续调用和参考这些信息,提升对话的个性化和连贯性。
详细的功能介绍请参考长期记忆文档。
1. 开启长期记忆在智能体应用编辑界面,开启长期记忆功能开关。 | |
2. 配置用户画像点击记忆变量,添加新的记忆变量字段,点击右上角发布按钮,发布应用。 字段是记忆变量的属性,例如“岗位”、“行业”、“兴趣爱好”等。 字段描述用于解释字段名称,帮助大模型更好地理解字段的含义。 是否通过模型推理控制该字段是否参与模型推理。开启后,系统会根据对话内容自动推理和填充该字段的记忆变量信息。关闭后,则需要通过手动设置。 | |
3. 测试记忆效果输入“我是一名前端开发工程师”,等待大模型回答完毕。 点击记忆,即可查看两种记忆类型:
此时,大模型在两种长期记忆中都保存了我们输入的信息。即使当前聊天被清除后,这些记忆也能保存到新对话中。 |
步骤三:体验智能体应用
您可以使用文本、语音或视频对话的方式体验智能体应用。
视频对话仅限通义千问 VL 系列模型
文本对话和文件上传
文本对话是智能体应用的核心交互方式,为您提供智能和个性化的多轮对话体验。智能体将以文本形式回复您的问题。
文本对话支持两种主要输入方式:
直接文本输入: 您可以通过键盘输入文字与智能体进行交流。
文件上传: 除了文字输入,您还可以直接上传文档、图片、视频和音频。智能体应用会自动提取文件信息,使您可以直接针对文件内容进行对话。
在智能体应用编辑界面,开启视觉功能开关后,您可以上传图片。此功能需要使用视觉(VL)模型下使用。
如需了解文件大小、格式及操作演示,请参考上传文件。
文本生成
功能亮点
文本生成是面向单轮任务的生成式交互,适合对文章进行信息抽取与文本创作。
用法说明
| |
| |
| |
| |
|
语音和视频通话
计费模式
阿里云百炼与视频云分别产生应用调用的账单。
阿里云百炼按照应用API调用计费(如果TTS选择阿里云百炼CosyVoice,则模型调用也会计费),详情请参见大模型产品计费说明。
视频云按照AI实时互动计费模式计费,AI实时互动每日为未订阅套餐包的用户赠送20通免费电话额度用于产品体验。详情请参见AI实时互动计费说明。
DeepSeek R1和QwQ系列模型不支持音频和视频对话功能;DeepSeek V3 模型不支持视频对话功能。
智能体应用还支持语音和视频对话:
语音对话:依托语音合成-CosyVoice/Sambert模型,智能体可以将文本回复转换为自然语音输出,您可以与智能体进行流畅的语音交流。
视频对话:依托视觉理解模型,智能体可以识别画面中的物体、场景、人物动作等,您可以与智能体进行实时视频通话。
功能亮点
全球高可用、低延迟:依托阿里云的实时音视频网络体系,全球3200+节点覆盖和QoS优化,使得用户可以在全球范围内与 AI 智能体完成音视频通话。
高度拟人化:系统自动启用智能降噪、智能打断、智能断句等功能,互动自然流畅,贴近人类对话习惯。CosyVoice模型提供更逼真的人声。
易调试:提供体验窗与调试信息展示,全流程可观测、可修改、可调试。
易体验、易集成:集成方式可参见集成方案。
用法说明
#角色 你是一个口语练习专家,你会首先使用中文对用户的英文输入进行点评,给出优化建议、纠错及润色,之后使用英文维持继续对话,不要加入多余的中文翻译。 #执行步骤 1.如果用户用中文交流,让用户重新用英文对话。 2.针对用户的英文输入,使用中文进行评价,给出优化建议。 3.使用英文开启下一轮对话,不要说出中文意思。 4.不要输出占位符等无法被转换为语音的文本信息。 | |
| |
| |
| 其中语音转文字可进行语种选择 |
| |
|
个性化交互体验配置
你可以通过设置欢迎语,添加预设问题,进一步完善智能体应用体验。
为什么进行体验配置
欢迎语:智能体的开场白,帮助营造友好积极的对话氛围。
预设问题:预设一系列启发性的问题,覆盖不同主题与功能维度,帮助用户快速了解智能体的核心能力,并激发他们的提问灵感。
测试案例:挑选一些高质量的交互案例,直观呈现智能体在解决复杂问题方面的优质表现,让用户具体、深刻地了解智能体的能力。
用法说明
| |
| |
| |
| |
|
步骤四:发布智能体应用
发布后的应用可以被API调用,也可以通过Web页面分享给同一主账号下的RAM子账号使用。您可以单击智能体应用管理界面右上角的发布按钮。如果您的应用非首次发布,弹窗会向您展示当前智能体应用相比于上一次发布时的修改项。在您确认修改项后单击确认发布。
如果您使用了 RAM 账号创建应用,发布应用前请确认已拥有服务关联角色权限 ram:CreateServiceLinkedRole
,详情请参考服务关联角色。
如果您的应用为首次发布,则不会有弹窗信息。
通过API调用
您可以在智能体应用发布渠道页签,单击API调用右侧的查看API,查看通过API调用智能体应用的方法。
注:您需用您的API KEY对DASHSCOPE_API_KEY进行替换才可发起调用。
发布为组件
您可以将智能体应用发布为组件,以供其他智能体或工作流应用使用。详细的组件配置方法请参考发布为组件。
发布应用为组件
发布应用:前往智能体或工作流应用的编辑界面,点击发布应用。
发布组件:在发布应用时选择发布应用组件。
也可以随时在发布渠道里创建组件。
在管理面板发布组件
控制台提供了组件管理,您可以点击创建组件来将已有的智能体发布为组件,您也可以查看、修改或删除应用组件。
通过官方或魔笔渠道分享应用
单击官方或魔笔渠道右侧的生成分享链接,您可以按需将该链接分享给同一主账号下的RAM子账号使用。
发布为钉钉机器人
您可以将智能体应用与钉钉机器人集成,以便通过钉钉访问和使用智能体应用。要实现此集成,您需要在钉钉平台上创建一个机器人,并将其与您的阿里云百炼应用相关联。详细的操作步骤,请参阅 通过钉钉发布应用。
发布为微信公众号
您可以将智能体应用与微信公众号集成,以便用户通过微信公众号访问和使用智能体应用。要实现此集成,您需要创建一个微信公众号,并将其与您的阿里云百炼应用相关联。详细的操作步骤,请参阅 通过微信发布应用。
在应用的发布渠道页签下,将鼠标悬停在微信公众号右侧的二维码图标上,即可显示公众号的二维码。用户可以通过微信扫一扫功能,扫描此二维码来关注您的公众号,进而访问已集成的阿里云百炼应用。
发布为百炼应用模板
您可以将您的应用上架为官网模板,如若需要,请填写阿里云百炼应用模板上架申请,我们的团队将与您取得联系并审核您的应用。审核通过后,我们将安排应用上架至应用广场。
步骤五:删除与复制智能体
您可以在应用管理找到已发布的应用卡片,在
进行删除与复制智能体、修改应用名操作。步骤六:配置内容安全和多轮对话(可选)
发布应用后,您可以在内置的安全规则基础上,自定义内容干预规则,确保大模型生成的内容安全可控。您还可以选择开启和备份多轮对话。
您可以在应用管理找到已发布的应用卡片,在
配置以上功能。使用快速干预工具处置风险内容
在使用智能体应用时,如果您希望妥善处理对话中存在潜在的违规、敏感或不当内容,可以借助快速干预工具来及时拦截和处理。该工具能够基于自定义的规则,对用户输入或模型生成的文本进行检测,一旦触发条件就会执行预先设置的干预操作。
通过以上两步,您就能够使用快速干预工具对潜在的风险内容进行一站式的拦截和替换,保证您的智能体应用在与用户交互时保持合规与安全。这样既有助于满足平台审核要求,也能为最终用户提供更健康的对话体验。
启动和备份多轮对话
智能体应用默认开启多轮对话功能。阿里云百炼提供内置缓存,用于保存多轮对话记录,有效期为会话开始后 1 小时。您也可以选择将多轮对话记录备份至 ADB-PG。
如果需要了解 ADB-PG 的更多功能与计费信息,请参阅云原生数据仓库AnalyticDB PostgreSQL版帮助文档。
配置风险内容的拦截方式
除快速干预工具外,智能体应用还内置了一套内容安全策略。当大模型生成的内容触发此策略时,智能体应用将拦截全部生成内容,并提示内容存在安全问题。
目前,阿里云百炼仅提供“全部拦截”的风险内容拦截方式,您无需手动配置此项。
步骤七:版本管理
如果您需编辑历史版本描述信息,或选择和使用发布过的历史版本,您可以通过版本管理功能实现。具体操作请参见以下操作步骤:
您可以在智能体应用的配置页签,单击顶部导航栏右侧的版本管理。
在历史版本列表中,选中目标版本后:
如果您需修改版本信息,请将鼠标悬浮至
图标位置单击,在编辑版本描述对话框中按需完成修改后,单击确定。
如果您需使用该版本,请单击覆盖当前草稿,在二次确认对话框中单击确认。
此版本内容将覆盖当前版本草稿内容。
支持的模型
数据更新可能存在延迟,模型的支持情况以智能体应用内显示为准。
下一步
阿里云百炼提供了丰富的实践教程文档,如果您想快速将阿里云百炼集成到您的业务中,请参考实践教程。
常见问题
计费
Q:大模型应用会收费吗?
A:只创建应用不会收费。但如果调用应用进行了问答,则会根据调用的模型类型收取模型调用费用。
Q:知识库检索额外计费吗?
A:知识检索增强功能免费,但检索到的内容作为模型输入,按模型输入 Token 计费。
知识库
Q:智能体回复知识库相关内容不稳定,效果时好时坏,该如何解决?
A:
1. 首先进行知识库命中测试,查看问题与知识库内容的相似度得分。如果得分较低,请尝试优化检索配置,确保模型优先从知识库中获取答案。
2. 在提示词技能设置中添加限制,要求模型仅基于知识库内容回答,避免使用大模型自有知识生成回复。
3. 如果问题仍然存在,可能是模型本身的特性导致,建议尝试更换其他模型以获得更稳定的输出。
插件
Q:自定义插件是否有超时限制?
A:是,超时限制时间为 5 秒。
发布与备案
Q:使用智能体应用对外提供 AI 服务,需要通过什么备案审核吗?
A:根据国家网信办《生成式人工智能服务管理暂行办法》,阿里云百炼智能体应用对外提供服务时,需要通过相应的备案或审核。具体备案流程和要求请参考应用合规备案。
Q:是否支持通过 API 创建智能体应用?
A:支持使用 Assistant API 创建大模型应用,其功能和智能体应用类似。
注意: Assistant API 创建的应用不支持控制台管理,详细信息请参阅 Assistant API 文档。