智能体编辑器用于把一个对话式 AI 能力包装成用户端可使用的智能体。它既可以接入 Coze、Dify、腾讯元器、文心智能体、第三方开发者项目,也可以在后台直接编排租户自己的智能体。
你可以在这里做什么
目标 操作入口 影响范围 配置智能体信息 基础信息 用户端智能体卡片和详情页 接入外部平台智能体 平台配置 智能体实际运行来源 编排自定义智能体 智能体编排 模型、提示词、开场白、知识库引用 配置展示和售卖 高级设置、售卖策略 用户可见性、会员限制、付费规则 测试对话效果 右侧聊天预览 上线前验证回复质量
一、先确定智能体来源
来源 适合场景 配置方式 智能体编排 租户希望在后台直接做一个问答助手 选择模型、写提示词、挂知识库 Coze 老版 已在 Coze 空间搭好 Bot 先在授权中心配置 Coze,再选择空间和 Bot Dify 已有 Dify 应用 API Key 直接填写 Dify App API Key Coze 新版 使用 Coze 编程接口项目 填写访问 Token、Base URL、Project ID 腾讯元器 已有元器智能体 填写 API Token 和智能体 ID 文心智能体 已有文心智能体应用 填写 Secret Key 和 App ID 系统智能体 使用平台内置智能体 受独立部署或高等级套餐限制 三方智能体 接入第三方开发者项目 先在授权中心配置第三方开发者凭证
编辑已有智能体时,来源通常不允许随意切换。需要更换来源时,建议新建一个智能体,验证后再下架旧智能体。
二、配置基础信息
基础信息决定用户是否愿意点击使用。
图片展示的是智能体配置基础信息的界面。上方有“上传图标”按钮。下方有必填项“名称”“分类”,以及可填写的“简介”“媒体资源”“高级设置”“排序”“教程链接”“售卖策略”等信息栏。其中“名称”需给智能体起名,“分类”需选择合适的分类,“简介”简述智能体功能和特点,“高级设置”可开启“精选推荐”“展示状态”,“排序”输入数字排序,“教程链接”可输入教程链接,“售卖策略”可开启“会员专享”“源码下载”“单独付费”。该界面与文档中配置基础信息的内容对应,用于填写智能体相关基础信息。
填写智能体名称。
选择分类。
写清楚简介,说明它能解决什么问题。
上传或选择图标。
如需要,补充背景图、封面图、演示视频。
设置是否精选、是否展示和排序。
保存前确认名称、分类、简介已完整填写。
名称、分类、简介是保存必填项。简介不要写成内部技术说明,应该从用户任务出发,例如「帮你根据产品卖点生成小红书种草文案」。
三、使用智能体编排
智能体编排适合直接在租户后台完成一个可控的业务助手。
操作步骤:
平台配置选择「智能体编排」。
这张图片展示的是智能体配置流程中选择智能体平台的操作界面,界面内的选项为不同的智能体平台入口,其中被选中并以绿色突出显示的是“智能体编排”,其余未选中的平台选项还有Coze、Dify、Coze新版、腾讯元器、文心智能体、系统智能体、三方智能体,每个未选中的选项旁都带有对应颜色的圆点标识,该界面对应智能体编排操作步骤中第一步的平台配置选择环节。
在 AI 大模型配置中选择模型凭证。
图片展示了智能体编排中AI大模型配置界面。在“选择AI凭证”处,显示“租户算力运行时凭证-2299c99d-aff3-4988-830c-72119defcf7c (openai)”。下方“模型配置模式”为“从可用模型列表中选择”,右侧“运行大模型(Model)”为“deepseek-v3-2-251201”。该图片与上下文紧密相关,是智能体编排操作步骤中,在AI大模型配置中选择模型凭证的展示,直观呈现了操作界面及当前选择状态。
选择可用模型,或手动输入自定义模型名称。
编写提示词,明确角色、任务边界、输出格式和禁止事项。
该图片呈现了智能体编排过程中编写提示词的相关配置界面,其对应的上下文为智能体编排的操作步骤。界面顶部标注“人设与回复逻辑”,核心设置区域为提示词(Prompt)输入框,说明需在此处指定智能体的角色定位、工作流程和回复风格,例如“你是一个专业的客服助理,始终用温柔幽默的语气回答用户有关产品退换货的问题...”。输入框下方设有“推荐模板快捷填充”板块,提供“客服助手”“文案专家”两个预设选项,方便用户快速设置符合对应角色的提示词内容。
配置开场白,让用户进入对话后知道怎么提问。
图片展示的是智能体编排中对话体验的配置界面。界面包含开场白(Prologue)、开场白预制问题、智能追问建议等部分。开场白示例为“您好!我是您的智能退换货助理。今天有什么可以帮您?”。开场白预制问题区域显示“未配置预制问题”,并有“添加问题”按钮。智能追问建议部分有“开启”按钮,可自动生成3个推荐提问。该图片与上下文紧密相关,直观呈现了智能体编排中对话体验的配置内容。
配置开场白预制问题,引导用户快速开始。
如已配置知识库,开启知识库引用。
图片展示了智能体配置中“知识(引用知识库)”的相关设置。开启后,智能体在问答时会检索关联知识库文档。可选择具体知识库,如2222、1111等,若不勾选,默认检索租户下所有知识库文档。该图片与上下文紧密相关,上下文提到如已配置知识库,可开启知识库引用,此图直观呈现了开启及选择知识库的操作设置,帮助用户了解配置详情。
选择具体知识库;不选择时,系统会默认检索租户下可用知识库。
使用右侧聊天预览测试效果。
保存智能体。
提示词建议写业务规则,不要只写「你是一个助手」。例如客服类智能体要写清退换货口径、不能承诺的事项、需要转人工的条件。
教程文档:
四、接入 Coze 智能体
先在 授权中心 配置 Coze 老版授权。
回到智能体编辑器。
平台配置选择 Coze。
图片展示的是智能体编辑器中选择智能体平台的界面。界面上方有“选择智能体平台”及红色星号标识。下方有多个平台选项,其中“Coze”平台以蓝色高亮显示,其右侧有蓝色圆点标识。其他平台选项包括“Dify”“Coze新版”“腾讯元器”“文心智能体”“系统智能体”“三方智能体”,各平台右侧有不同颜色的圆点标识。该图片与上下文关系紧密,是智能体编辑器中选择Coze平台配置Coze老版授权步骤中的一个操作界面展示。
选择对应授权。
图片展示的是智能体编辑器中选择授权凭证的界面。上方有“选择授权凭证”字样及红色星号标识必填项。下方下拉框中显示“coze老版”选项,左侧有一个蓝色圆点标识。该图片与文档中“接入Coze智能体”教程相关,对应步骤为“选择对应授权”,即在智能体编辑器平台配置选择Coze后,需在此处选择对应的授权凭证。
打开列表选择。
这张图片是接入Coze智能体流程中,用于填写智能体相关标识的操作界面。界面内有一个标注“智能体 ID / Key *”的必填输入栏,栏内有搜索图标,提示文字为“请输入智能体 ID 或唯一标识”。右侧设有两个操作按钮,分别为虚线框样式标有“列表选择”的按钮,以及蓝色背景的“智能获取”按钮,这些按钮用于辅助用户完成智能体ID相关的选择或获取操作,对应接入流程中的相关步骤需求。
选择空间,再选择 Bot。
图片展示的是智能体编辑器中选择智能体的界面。左侧为空间列表,显示了多个空间名称及对应的ID。右侧是智能体列表,包含“课件生成”“视频生成”“小学语文”等多个智能体,每个智能体有名称、版本号及简要介绍。该图片与上下文关系紧密,是用户在智能体编辑器中选择对应授权、打开列表选择空间和Bot,以及导入智能体后检查名称、简介和图标等操作的参考界面。
导入后检查名称、简介和图标。
图片展示的是智能体编辑器中接入Coze智能体的平台配置界面。在“智能体 ID / Key”输入框中输入7631028473595314228,右侧有“列表选择”和“智能获取”按钮。下方显示获取结果,智能体名称为“课件生成”,版本为v1.0,介绍其助力教师快速制作符合教学目标的授课课件,内容逻辑清晰,支持课堂互动与可视化,轻松导出PPT,提升备课效率。提供方为COZE,作者是Coze User。该图与上下文介绍的接入Coze智能体步骤相关,是选择对应授权后的配置界面展示。
使用预览测试对话。
保存。
Coze 中 Bot 的名称和头像可能不适合用户端直接展示,导入后建议在本后台重新包装成业务化名称。
详细教程文档:
五、接入直连类智能体
Dify、Coze 新版、腾讯元器、文心智能体属于直连配置,通常不需要先到授权中心新增凭证。
图片展示的是接入直连类智能体时的配置界面。上方有“API Key / Secret Key”输入框,提示输入Dify App API Key。下方是“Base URL”输入框,已填入“https://api.dify.ai/v1”,右侧有“智能获取应用详情”按钮。底部有“Dify直接授权模式”说明,指出无需在授权中心配置,直接输入App API Key即可关联,系统将自动拉取应用信息。该图片与文档中接入直连类智能体的配置内容相关,直观呈现了配置时的输入项及模式说明。
平台 必填信息 注意事项 Dify App API Key、Base URL 默认 Base URL 为 Dify API 地址 Coze 新版 API Key、Base URL、Project ID Base URL 通常是专属发布域名 腾讯元器 API Token、智能体 ID 依赖平台提供的 Assistant ID 文心智能体 Secret Key、App ID 文心仅支持指定输入形态时要按平台要求配置
保存前要至少发起一次预览对话,确认能返回正常结果。
详细教程文档: 、 、 、
六、接入系统智能体(内置500个)
系统智能体就是系统内置智能体,适合把平台已经预置好的标准能力快速包装到租户用户端,例如标准问答助手、行业工具或平台统一维护的能力。
智能体列表:
操作步骤:
平台配置选择「系统智能体」。
图片展示的是智能体平台选择界面。界面上方有“选择智能体平台”标题,下方有多个智能体平台选项,其中“系统智能体”以橙色高亮显示。下方还有“系统智能体标识”输入框,内有“agent_005”字样,右侧有“列表选择”和“智能获取”按钮。该图片与文档中介绍系统智能体的内容相关,用于说明在平台配置选择系统智能体时的界面情况。
如果入口不可见,先确认租户套餐、部署版本或插件权限是否支持系统内置能力。
可以直接输入系统内置智能体标识,也可以点击列表选择。
在列表中先选择左侧分类,再从右侧选择要使用的内置智能体。
图片展示的是系统内置智能体选择界面。左侧分类列表中,如企业治理、商业思维等分类被展开,可点击选择。右侧智能体列表中,有专门委员会协同方案、年度经营评审报告等系统智能体,每个智能体有名称、简介、图标和版本信息。该图与上下文紧密相关,上下文介绍了选择系统内置智能体的操作步骤,此图直观呈现了选择界面及可选智能体,帮助用户了解如何在列表中先选择分类再选择智能体。
选择后检查自动带出的名称、简介、图标和版本信息。
如页面要求配置运行模型或凭证,选择当前租户可用的模型授权;部分内置能力会直接走系统算力通道。
图片展示的是系统智能体配置界面中的AI大模型配置部分。上方显示“AI大模型配置”标题。下方有“选择AI凭证”区域,已选择“租户算力运行时凭证-2299c99d-aff3-4988-830c-72119defcf7c (openai)”。接着是“模型配置模式”区域,下拉框显示“从可用模型列表中选择”。最后是“运行大模型 (Model)”区域,显示“deepseek-v3-2-251201”。该图片与上下文介绍的系统智能体配置流程相关,展示了配置AI大模型时的部分设置选项。
使用右侧聊天预览做真实问题测试。
保存智能体,并回到项目管理确认展示状态。
注意事项:
系统智能体依赖平台预置能力和租户权限,不是所有租户都会看到该入口。
优先通过列表选择,只有明确知道内置标识时再手动输入。
系统智能体的底层能力由平台维护,租户主要负责前台展示、售卖策略和上线测试。
如果预览失败,优先检查租户权限、系统能力状态和模型运行通道。
七、接入三方智能体(接入开发者智能体)
三方智能体用于接入外部开发者开放的智能体或工作流。它不是租户自己编排的智能体,也不是系统内置能力;运行稳定性取决于第三方开发者提供的 KEY、请求地址和项目状态。
操作步骤:
先在 授权中心 新增「第三方开发者(KEY + 请求域名)」凭证。
填写第三方提供的请求地址和 KEY,并保存凭证。
这张图片展示的是新增授权的配置界面,对应接入三方智能体操作步骤的第一步:新增第三方开发者凭证的环节。界面需填写的核心内容为授权名称、选择平台类型为「第三方开发者(KEY + 请求域名)」,还要填写第三方提供的请求地址(API根地址)和对应申请到的KEY,同时说明敏感信息(如私钥)将被自动加密存储,不会明文展示。界面设有「测试连接」「取消」和「保存」按钮,用于完成当前凭证的配置操作。
回到智能体编辑器。
平台配置选择「三方智能体」。
图片展示的是智能体平台选择界面。界面上方有“选择智能体平台”及红色星号标识,下方有多个平台选项,包括智能体编排、Coze、Dify、Coze新版、腾讯元器、文心智能体、系统智能体和三方智能体。其中,三方智能体选项被红色框线突出显示。该图片与文档中接入三方智能体的上下文相关,用于说明在选择智能体平台时,需点击三方智能体选项。
选择已配置的第三方开发者授权凭证。
图片展示的是接入三方智能体时选择已配置的第三方开发者授权凭证界面。上方提示“请选择已配置的授权”,下方有“请选择已配置的授权”和“第三方凭证”两个选项,其中“第三方凭证”被红色圆点突出显示。该图片与文档中“选择已配置的第三方开发者授权凭证”步骤对应,直观呈现了选择授权凭证的操作界面及关键选项。
系统会拉取该凭证下可用的公开智能体或工作流项目。
图片展示的是平台配置选择三方智能体时,系统拉取的第三方开发者授权凭证下可用的公开智能体或工作流项目界面。左侧有全部分类、获客转化、内容增长、企业办公等分类选项,右侧是三方项目列表,如人员编制规划方案、员工信息保密机制等内容,每个项目有名称、分类、状态等信息。右侧还设有搜索项目名称的输入框。该图与上下文紧密相关,直观呈现了系统拉取的三方智能体项目情况,供用户选择。
点击选择三方智能体/工作流,在弹窗中按分类或关键词找到项目。
选中项目后,检查自动带出的名称、简介、图标、输入输出格式等信息。
补充用户端展示信息、售卖策略和展示状态。
使用右侧预览测试。
保存。
注意事项:
如果三方项目列表为空,先检查 KEY、请求地址、第三方项目是否已公开,以及网络是否可访问。
三方项目可能包含智能体或工作流,选择前要确认它适合用户端的交互方式。
三方项目的输入输出结构由外部开发者提供,保存前要用真实业务问题测试一次。
第三方服务异常、项目下架或 KEY 失效,都会导致用户端运行失败。
详细教程文档:
八、售卖和权限设置
配置 含义 会员专享 只有会员用户可使用 源码下载 允许用户下载源码包,需上传 ZIP 单独付费 用户需先购买解锁 扣费模式 免费、按量或按 token 等消耗规则 展示状态 是否在用户端展示
如果同时开启单独付费和扣费,用户通常需要先购买解锁,使用时仍按配置扣费。上线前要确认营销套餐和支付设置已经配置完成。
九、上线前检查
用户端卡片名称能表达业务价值。
智能体能完成至少 3 个真实问题测试。
错误问题、超范围问题有可接受的回复。
知识库引用没有暴露内部敏感内容。
会员、付费、扣费策略符合运营设计。
展示状态只在确认可用后开启。
十、常见问题
为什么保存时提示必填信息不完整?
检查名称、分类、简介是否都已填写。
为什么智能体预览没有回答?
检查平台凭证、API Key、Base URL、模型额度和外部平台项目状态。
挂了知识库但回答不像文档内容怎么办?
先在知识库页面做检索测试,确认问题能检索到相关文档,再优化提示词和文档内容。