智能体
智能体概述
AI工作台提供一站式的智能体开发体验,支持创建打通内部业务平台的业务智能体,将AI的理解、规划与执行能力实际融入业务工作场景,为业务团队提供开箱即用的AI服务。
创建智能体
参考以下流程,逐步搭建智能体。
方式一:AI Coding
以自然语言驱动开发,支持通过对话生成、修改与优化代码,将业务需求转化为智能体功能。适用于希望减少手动编码、快速开发迭代,或通过代码灵活扩展业务能力的场景。
Step1:进入创建入口
在AI工作台左侧进入【新建项目】,在操作框中单击选中「智能体」。
Step2:描述项目需求
- 1.通过对话式交互,用户以自然语言描述实际的创编需求,无需复杂参数或流程编排即可快速构建符合预期的智能体。支持语音输入;
- 2.需求描述尽可能清晰且详细。方向可包含:智能体功能描述、业务实现逻辑和约束条件…
生成一个专业的时尚搭配顾问智能体,拥有专业的色彩学、服装搭配和时尚潮流知识,擅长根据用户提供的穿着信息(如颜色、款式、场合等),给出专业的搭配建议。
Step3:增加可选配置
- 1.文件:支持上传图片、json文件、word文档、压缩包等文件,辅助AI生成;
- 2.扩展:平台内提供多种通用资源,用户可按需进行扩展,加强AI生成效果;
- a.智能调用:选择该模式后,模型会根据用户的提示词理解意图,按生产需求自动调用各类资源。在具体资源右侧开启开关,模型会优先加载该资源并评估是否调用
- b.自定义:选择该模式后,由用户决定模型可调用的资源。在具体资源右侧开启开关,则表明允许模型自动调用该资源;反之,表明模型不能调用该资源
- 3.模型:默认是Auto模型,用户可在列表中选择其他通识模型。
Step4:提交等待生成
- 1.完成上述步骤后,即可在输入框中点击发送,页面会跳转至该项目专属编辑页面,可以在此查看实时生成进度;
- 2.平台会自动生成智能体项目的初始名称,可在第一泳道【我的项目】下找到目标智能体项目,点击右侧“…”并选择重命名完成智能体项目名称修改。
过程预计需要几分钟,请耐心等待。
方式二:智能编排
平台提供完整的低代码编辑能力,支持对应用的人设、对话逻辑、技能调用及输出形式进行精细化配置与控制。适用于希望深度干预智能体行为、实现复杂业务逻辑或进行定制化优化的场景。
Step1:进入创建入口
在AI工作台左侧进入【新建项目】,在操作框中单击选中「智能体」。
Step2:创建空壳智能体
- 1.直接点击对话框的发送按钮,页面会跳转至该项目空白编辑页面;
- 2.智能体生成时默认名称为“未命名”。可在第一泳道【我的项目】下找到目标智能体,点击右侧“…”并选择重命名完成智能体名称修改;
- 3.在第三泳道【项目管理】tab下添加【人设】。
Step3:配置专属人设
- 1.配置模型:模型作为智能体的“大脑”,是决定智能体效果的重要因素,因此需从检查清单中一键添加模型,为后续具体编排做准备;
- 2.添加提示词:在人设编辑页输入提示词。支持使用正文、标题、无序/有序列表等格式,分段描述角色背景、能力范围等关键信息。
- a.指令调用:在人设编辑区输入「/」可调起指令和,用于插入如“意图分类”等AI模块,帮助模型更好理解和拆解用户诉求;
- b.引入资源和变量:输入@可调起选择面板,用于插入对应的变量、工具/知识库等资源。
# 角色 你是一位专业的时尚搭配顾问,拥有深厚的色彩学、服装搭配学和时尚潮流知识。你精通四季色彩理论、风格定位、场合着装礼仪,能够根据用户的个人特征(肤色、身材、气质)和穿着需求(颜色、款式、场合等),提供精准、专业且实用的搭配建议。 # 目标 帮助用户解决各种穿搭困惑,提升个人形象和时尚品味。无论是日常通勤、商务会议、约会聚会还是特殊场合,都能为用户提供最适合的搭配方案,让每一位用户都能穿出自信、穿出风格。 # 技能 - 拥有专业的色彩学知识,能够分析用户的肤色类型,推荐最适合的色系搭配 - 当用户上传穿搭图片时,能够使用@图片内容理解工具分析图片中的服装颜色、款式、风格等元素 # 任务 1. 主动询问用户的穿搭需求,包括:穿着场合、个人风格偏好、身材特点、预算范围等 2. 为用户提供多套搭配方案(至少2-3套),包含详细的颜色搭配和款式说明
进阶配置
项目资源
如果在智能体编排过程中,希望进一步拓展智能体的能力与应用范围,那么可以按需接入工具、知识库等平台资源,并调整相关配置。
资源名称 | 说明 |
模型 | 提供理解、推理与生成能力,支撑智能体处理业务需求。 |
工具 | 连接外部服务或业务系统,拓展智能体的数据获取与操作能力。 |
技能 | 封装特定任务的处理方法,为智能体提供可复用的专业能力。 |
知识库 | 将多个处理步骤串联为执行流程,支持复杂业务任务。 |
工作流 | 支持精细化控制任务逻辑与输出,提升智能体在复杂任务中的稳定性和执行质量。 |
协作智能体 | 引入其他智能体的能力,通过分工协作处理业务任务。 |
以工具为例,添加&调试资源流程可参考:
- 1.查看工具:可通过第一泳道中目标智能体展开功能列表或第三泳道中项目管理tab找到【工具】,点击后进入工具展示页面;
- 2.添加工具:在工具列表中可通过不同的分类标准筛选工具,点击工具支持查看详情以判断是否需要添加。如为目标工具,即可对应点工具卡片右下角【添加】;
- 3.调试工具:在已添加工具处,点击目标工具卡片右下角【设置】,可根据实际需求调整工具使用参数;
- 4.移除工具:如果不想再调用该工具,可在已添加工具处,点击目标工具卡片右下角【移除】。
核心配置
变量
人设编辑页点击右上角{x}添加变量,用于做一些动态设定,以及对接渠道系统变量,让智能体更灵活。
- 1.自定义变量:支持用户根据自身需求主动创建的变量,配置后可以在对话预览区调试;
- 2.系统变量:平台预置的内置变量,仅在特定渠道生效。配置后无法在对话预览区进行调试。
智能体记忆
总结用户与智能体聊天对话的内容,并用于更好的回答用户的问题。
- 1.短期记忆:控制模型在单次回答时可携带的历史对话轮数。轮数越多,多轮对话之间的关联性越强,但消耗的Token也会随之增加(上限100轮),适合需要强上下文连续性的场景;
- 2.长期记忆:能够让智能体在不同会话中持续记住用户关键信息,提供更连续、更贴合用户习惯的回复体验;
- a.结构化记忆:用于记录可明确归类的用户信息和偏好,可按需添加记忆分组统一管理;
- b.对话摘要记忆:将历史对话总结为摘要,支持按系统规则或自定义规则控制是否提取以及如何提取,也可以选择“不提取”关闭摘要记忆;
- c.记忆管理:控制长期记忆的保留周期(如 3 个月)及是否在回答中实际使用。
规则与记忆
给当前智能体添加个性化设置,在该项目内遵循特有的规则和记忆。
- 1.项目规则:设置当前项目需要遵循的要求与约束,明确任务处理方式和输出标准,让智能体的执行更符合业务预期;
- 2.项目记忆:开启后,智能体会在项目对话中识别并记录重要信息,保留项目上下文,减少重复说明,提升协作效率;
- 3.全局记忆:开启后,智能体会在对话中读取你的全局记忆,将已有偏好与背景信息带入当前项目,提供更贴合个人需求的协作体验。
触发器
支持为项目设置定时任务,到达设定时间后自动执行指定指令,无需人工触发。
- 1.填写基础信息
- a.任务名称:填写便于识别的任务名,如 "每日早报推送"
- b.创建人:默认为当前用户账号
- 2.选择执行主体
- a.通用Agent:由平台通用Agent持有并执行,保存即生效,无需发布;
- b.项目产物:由当前项目发布的默认产物持有并执行,随项目发布后生效。
- 3.触发配置
- a.执行频率:可按周期/单次/自定义维度选择触发频率;
- b.指令内容:填写任务触发时要执行的具体指令,描述清楚任务目标与要求;
- c.执行动作:可选择通知至飞书私聊/群聊中。
预览与测试
预览页面
智能体生成并配置完毕后,用户可在第三泳道预览tab下与智能体实时对话,测试其表现是否符合预期。如效果不满意,可持续通过AI对话或人设编排进行调整,预览效果即时更新,直至符合需求。
如有批量测试对话需求,可参考效果优化。
对话轨迹
针对AI Coding生成过程,支持查看对话轮次与具体节点,还原智能体运行全流程:
- 1.对话轮次:在对话轮次详情页,支持快速切换上一轮次和下一轮次,在每一个对话轮次下,展示该轮次整体的耗时火焰图、用户query和各节点运行详情;
- 2.具体节点:通过AI对话运行过程或耗时分布图点击具体节点,可快速定位至该节点卡片详情。支持查看节点类型、耗时、事件描述与调用结果,便于用户快速定位异常环节。
异常排查
预览对话支持查看调用日志;如出现调用异常或失败,可点击 ID 旁的【复制】获取 Trace ID/Log ID,自行优化或反馈至技术同学排查。
发布智能体
智能体配置完成并通过校验后,即可发布到线上渠道正式投入使用。
检查清单
配置过程中,系统会实时校验各项内容。所有校验项通过后,才能执行「试运行」「发布」或「更新线上版本」,以确保智能体配置完整、可用。
变更管理
变更管理面向智能体的编排内容本身,记录编辑过程中各版草稿配置的变化,与是否发布到线上无关。在【变更管理】tab中可查看、对比并回退编排版本。
变更详情
支持对变更内容进行diff对比。系统会自动总结变更内容,并在下方展示具体差异——绿色表示新增,红色表示删减。
恢复到版本
支持选择任一历史版本回退编排内容;回退后会自动生成一条新的变更记录。
发布
发布是将编排配置正式同步到线上使用的动作。点击「发布」只会确认当前配置版本,不会自动上线到具体渠道/场景;需在「发布配置」中完成渠道设置,审核通过后才会在线上生效。首次发布后若再次修改编排,可通过「更新线上版本」将最新配置同步到线上。
发布配置
- 1.发布内容
- a.支持查看当前草稿和发布版本的版本对比情况
- b.支持修改该智能体的名称和简介
- 2.应用渠道
- a.选择目标发布渠道,进入渠道详情页完成相关配置
- b.返回「发布配置」点击确认发布,审核通过后即可在线上使用
发布历史
发布历史记录的是每次实际发布到线上的版本,用于追踪线上版本迭代。
- 1.配置对比:可选择任一历史线上版本与当前草稿对比,查看变更摘要与具体差异。
- 2.对话调试:支持用同一 query同时查看两个版本的回复,便于对比对话效果。
管理智能体
增加协作人
- 1.仅支持搜索并添加同一空间内的飞书账号作为协作者,且被添加用户必须具备该空间访问权限,才能进行内容编辑。
※异常情况:如果在团队空间为智能体添加协作者时,搜索不到某人,说明对方不在该空间内,需先将其加入空间后再添加。
- 2.多人协作编辑:默认同一时间仅允许一人编辑,其他人处于锁定状态;支持抢占编辑权限。
删除智能体
- 1.仅支持创建者删除智能体,目前不支持批量删除智能体;
- 2.已发布至线上使用的智能体,需先解除线上关系才能够操作删除。
