对话、Work 智能体与协作能力
对话、Work 智能体与协作能力:操作步骤、配置说明与图解。依据已整理的飞书教程迁入。
本教程迁自此前整理的飞书全功能教程,原整理日期为 2026 年 10 月 17 日,迁入日期为 2026 年 10 月 28 日。功能入口、模型、权限及费用以当前站点实际配置为准;历史模式和未开放功能会在正文说明。截图中的示例账号与参数仅用于说明。
七、对话、Work 智能体与协作能力
(一)、普通对话角色与全局配置
1.进入“AI功能配置 → 对话管理”,维护角色;
先填写角色名称、说明与提示内容,再选择适用模型和展示条件。角色说明应告诉用户适合解决什么问题,提示内容则约束模型如何回答,二者分开填写。
2.在“全局配置”中调整公共对话设置;
全局项会影响多个用户,应先明确作用范围再保存。普通对话的设置不能代替 Work 基础设置,也不会自动改变画布、短剧的业务提示词。
3.从前台新建普通对话,核对角色、模型和附件能力;
验证记录分别在普通对话与工具对话中查询。排查时核对用户、时间、模型和错误信息,避免只按聊天标题寻找。
图解:对话管理
本图编号定位:1. 查询;2. 编辑。
图解:新增对话角色
本图编号定位:1. 是否发布;2. 名称;3. 图标;4. 预设内容;5. 输入提示;6. 确定。
图解:对话配置
本图编号定位:1. 对话LOGO;2. 保存设置。
(二)、Work 基础提示词与工作任务
1.进入“AI功能配置 → Agent智能体 → 基础设置”;
先留存当前内容,再修改 Work 系统提示词。保留页面要求的服务端占位符;误删占位符可能使任务缺少必要运行信息。
2.保存修改;需要恢复默认时,恢复后仍须保存;
“恢复默认”只更改当前草稿,不等于已经写入线上。保存成功后重新读取核对,再验证新任务的行为。
3.从前台“新工作任务”提交清楚的目标,在任务记录中跟踪;
普通问答使用“对话”,需要多步处理、调用能力、形成成果时使用“工作”。用户可能补充信息、批准请求、停止或恢复任务,运营者应按任务 ID 和状态排查。创建项目、搜索历史、置顶或改名属于用户组织会话的操作,不会自动重新执行任务。
(三)、专家与专家团
1.进入“Agent智能体 → 专家管理”,先配置分类;
分类用于让用户找到合适专家。名称、简介应描述能力和适用场景,避免只写模糊的“万能助手”。
2.选择“创建 Work Agent”或“创建专家团”;
单个专家填写身份、任务说明、模型及所需资源。专家团还要明确成员、岗位分工、负责人和执行方式,避免成员重复执行或无人负责最终交付。
3.绑定已可用的 Skill、知识库及连接器;
Skill 必须启用且有已发布版本,知识库必须启用;连接器需要测试通过并启用。写在简介里不会自动获得相应工具,必须在资源绑定处选择。
4.保存编辑内容,发布版本,再按需要上架商店;
草稿、发布版本、可见范围与启用状态分别核对。上架前需要发布版本;下架商店改为租户可见;停用会阻止任务继续使用该资产。旧专家转换入口用于迁移,转换后仍要检查资源和发布版本。
5.在普通用户“专家中心”检查展示与执行;
确认用户能看到正确版本、说明与价格,实际任务使用已绑定资源。私有资源不会仅因后台存在就自动公开。
图解:专家管理
本图编号定位:1. 专家分类配置;2. 创建专家团;3. 创建 Work Agent;4. 类型 请选择;5. 搜索名称或简介;6. 创建者 ID;7. 可见范围 可见范围;8. 查询;9. 编辑。
图解:创建专家
填写专家名称与说明,设置提示词、能力和可见范围。保存与发布版本分开核对;只有配置了当前可用版本的专家才能供前台正常使用。
本图编号定位:1. 名称;2. 简介;3. 工作指令;4. 模型 请选择;5. Skill 请选择;6. MCP 与连接器 请选择;7. 知识库 请选择;8. 保存草稿。
(四)、Skill 技能与版本
1.进入“Agent智能体 → Skill管理”,创建或导入技能;
填写名称、简介、使用说明和执行指令;需要配套文件时一并维护。导入已有包后先检查指令、文件及运行依赖,再给其他用户使用。
2.按所需能力配置执行环境、依赖与超时;
Python、JavaScript 等执行能力受服务端运行环境和依赖白名单约束。把依赖写在说明中不等于服务器已安装;缺依赖应由维护人员核对运行环境。
3.保存草稿,发布明确版本,再绑定到专家或应用;
修改草稿不会自动替换已固定绑定的版本。需要更新专家所用技能时,同时核对专家绑定的版本并发布相应修改。
4.通过一次受控任务核对输入、执行与交付文件;
成功不只看模型说“完成”,还要检查实际成果、文件可打开性和运行记录。停用前核对依赖它的专家、应用及定时任务。
图解:Skill管理
本图编号定位:1. 创建 Skill;2. 搜索名称或简介;3. 创建者 ID;4. 可见范围 可见范围;5. 查询;6. 编辑。
图解:创建技能
填写技能名称和说明,准备具体执行规范与允许使用的工具;检查可见范围和版本,再按本节说明发布。
本图编号定位:1. 名称;2. 简介;3. 分类;4. SKILL.md 指令;5. 可执行 Skill 在隔离 Runner 中运行固定版本源码并交付文件。;6. 保存草稿。
(五)、公共知识库、个人知识库与智谱配置
1.进入“素材中心 → 公共知识库”,点击“创建知识库”;
先填写名称和简介并保存草稿,再进入该库维护资料。后台公共知识库、用户自己的知识库及扣子知识库是不同管理对象,不要在错误入口重复上传。
2.导入文件或文本,等待处理状态完成;
处理失败时先核对格式、大小和错误原因。仍在处理中或导入失败的文件不能当作已可检索资料。
3.在“模型管理 → 智谱知识库”核对服务参数;
根据当前实际方案配置检索服务;Embedding 用于把资料转成可检索表示,重排用于优化候选顺序,召回参数决定找回范围。不要只追求更大的数量,先用能从资料中直接回答的问题检验结果。
4.启用并绑定到目标专家,测试具体问题;
知识库停用后新任务无法使用,运行中的任务仍会检查权限和撤销状态。更新资料后也要核对同步状态与版本快照,不能只看文件已出现在列表。
图解:公共知识库
本图编号定位:1. 创建知识库;2. 搜索知识库名称或简介;3. 查询。
图解:创建公共知识库
填写知识库名称及描述,保存后再导入资料;处理完成并启用后,才把它关联到对应专家或工作任务。
本图编号定位:1. 名称;2. 简介;3. 保存草稿。
图解:用户知识库
本图编号定位:1. 查询。
图解:智谱知识库
本图编号定位:1. 智谱 API Key;2. 检索模式 混合检索;3. Embedding 模型 Embedding-3;4. 上下文增强 适合长文档、跨段落和指代问题。智谱知识库升级后不可逆;存量文档需要重新处理,首次建索引时间会增加。;5. 混合召回向量占比(%);6. 初始召回数量;7. 最终返回数量;8. 相似度阈值;9. 启用 Rerank 对初始召回结果再次排序,可提升最终相关性;会增加每次检索的延迟和调用费用。;10. Rerank 模型 rerank;11. 保存设置。
(六)、MCP、HTTP 与飞书连接器
1.进入“模型管理 → 工具模型”中的“MCP 与连接器”;
选择当前服务支持的连接类型,填写名称、说明、服务地址、超时及鉴权信息。共享连接器和用户私有连接器分开管理,密钥只放在鉴权字段。
2.HTTP 工具按接口定义填写输入 Schema;
字段类型、必填项和接口接收格式一致;MCP 连接则通过工具发现核对实际暴露的工具。飞书连接配置应与所需应用权限和服务范围匹配。
3.先保存,再测试;测试成功后才启用;
新建时处于停用、未测试状态。编辑后会再次停用并清除测试状态,需要重新测试;不能把旧的成功结果当作新配置已验证。
4.更换鉴权时核对保留与清除行为;
鉴权头按键合并,明确清除整组秘密才会清空原鉴权。编辑或停用连接器可能暂停依赖它的桌面定时任务,恢复后还需逐项检查。
5.绑定到专家后,以对应用户确认工具可见与调用权限;
连通性测试成功只证明连接可用,不等于所有用户都有权使用每个工具。涉及写入外部系统的工具,应在用户确认的范围执行。
图解:MCP 与连接器
先核对连接器类型、允许的域名和认证方式;在当前版本能正常打开配置表单时填写并保存,再测试连接,测试通过后启用。
本图编号定位:1. 使用此配置。
本图编号定位:1. 编辑。
(七)、定时任务、项目和成果分享
1.在“Agent智能体 → 定时任务”查看计划;
按用户、项目、状态与执行环境查找,核对一次性、固定间隔或 Cron 规则及其时区。把本地时间误当作另一时区会导致执行时间不一致。
2.检查依赖、执行记录和失败原因;
任务需要的专家、Skill、连接器、模型和额度必须可用。桌面本地任务还依赖相应设备和执行环境,网页关闭与桌面退出的影响应按任务环境分别判断。
3.修改或恢复前先确认是否仍有任务运行;
避免同一业务并行重复执行。定时任务不支持用 Web 个人自定义 API 替代系统模型。
4.核对成果、文件、分享范围与撤回;
用户可在任务中预览、下载、导出和复用成果;分享前应确认公开范围。停止分享与删除原始成果是不同操作。运营者排查时按用户及项目归属查找,并核对文件归档及公开内容状态。
专家分类导入导出图解
图解:维护专家中心的分类与关联
在“专家管理”点击“专家分类配置”。每行配置分类标识、排序、启用状态以及简体中文、繁体中文、英文名称,再选择关联专家或专家团。需要多组时点击“新增分类”。
图中编号:1 分类标识;2 排序;3 启用;4 简体中文名称;5 繁体中文名称;6 英文名称;7 关联专家 / 专家团;8 保存分类。
检查关联对象后点击“保存分类”,刷新前台专家中心核对。仅启用分类显示;移除分类会移除分类关联,但不会删除专家。分类标识与展示名称分开维护,不要只填一种语言后忽略目标客户端显示。
图解:按筛选范围或指定对象导出专家
点击“导入 / 导出”,在“导出专家”页选择当前筛选全部或指定专家,核对数量后点击“导出”。
图中编号:1 当前筛选全部(118);2 指定专家(0)。
导出最新草稿,没有草稿时导出已发布配置。每次最多1000个专家,文件最大20MB;文件中保留的资源引用还需目标站点具备对应资源。导出前先确认筛选范围,避免把私有配置发给不应接收的人。
图解:导入专家为新草稿
切换“导入专家”,点击“选择文件”,选择本入口导出的 JSON 文件,再点击“导入草稿”。
图中编号:1 选择文件;2 导入草稿。
导入批量创建新专家草稿,完成后逐项核对并手动发布。文件保留 Skill、知识库、连接器及执行器引用,不包含资源本体、凭据或示例附件;目标站点缺对应资源时,该专家导入失败。不要把导入成功等同于已具备全部执行条件。
专家团折叠字段图解
图解:展开负责人或成员,填写具体分工
点击负责人或成员卡片左侧的小三角展开。填写该成员的名称、职位、头像和内部指令,再检查执行用途与专家模型。
图中编号:1 添加;2 名称;3 职位;4 内部指令;5 该角色使用的执行用途;6 专家模型 · 语言。
图中编号:1 职位;2 简介;3 表单底部说明;4 最多任务数;5 团队并发数;6 单角色并发数;7 任务超时(毫秒);8 最多模型轮数;9 自动重试上限;10 保存并试运行;11 保存草稿。
内部指令写给这位专家执行时使用,应明确负责什么、输入是什么、交付给谁;团队简介面向用户,两者用途不同。每个成员都需分别检查,不能只配置负责人。使用上移、下移调整顺序后,再检查负责人和成员的最终分工。
图解:成员能力与资源绑定
在成员卡片内展开“成员能力与资源设置”,填写简介、标签、职责、专业领域,按需选择知识库与Skill固定版本。
图中编号:1 名称;2 职位;3 内部指令;4 该角色使用的执行用途;5 专家模型 · 语言;6 简介;7 标签;8 职责;9 专业领域;10 允许的工具 ID;11 知识库;12 Skill 与固定版本。
图中编号:1 添加;2 职位;3 简介;4 表单底部说明;5 保存并试运行;6 保存草稿。
“允许的工具ID”用于限制可用工具,按当前实际工具标识填写,不能填展示名称或随意编写。知识库需可用;Skill需选中已发布的固定版本。资源设置应与内部指令一致,说明文字不等同于实际授权。不同成员可绑定不同资源,请逐个核对。
图解:运行限制与完整保存位置
向下滚动弹窗内部,直到看到全部运行限制和底部保存按钮。不要只滚动页面背景。
图中编号:1 允许的工具 ID;2 知识库;3 Skill 与固定版本;4 添加;5 职位;6 简介;7 表单底部说明。
图中编号:1 最多任务数;2 团队并发数;3 单角色并发数;4 任务超时(毫秒);5 最多模型轮数;6 自动重试上限;7 自动返工上限;8 预览;9 保存并试运行;10 保存草稿。
最多任务数限制任务拆分规模;团队并发数与单角色并发数分别约束整体与单个成员;超时单位为毫秒;模型轮数、重试上限、返工上限需要分别检查。图中的数值是演示站当前默认展示,不应直接视为所有业务的推荐值。保存草稿后重新打开核对,发布版本后再检查用户端可见范围。
图解:添加一个选填参数
在“选填参数”区点击“添加”,配置稳定标识、标签、类型、占位提示、帮助说明、图标地址、展示方式、最大长度和默认值。
图中编号:1 添加;2 职位;3 简介;4 表单底部说明;5 稳定标识;6 标签;7 类型;8 占位提示;9 帮助说明;10 图标地址;11 展示方式;12 最大长度;13 默认值。
图中编号:1 最多任务数;2 团队并发数;3 单角色并发数;4 任务超时(毫秒);5 最多模型轮数;6 自动重试上限;7 自动返工上限;8 预览;9 保存并试运行;10 保存草稿。
稳定标识用于区分字段,填写后保持稳定;标签写给用户看,例如“目标受众”。占位提示告诉用户如何输入,帮助说明解释规则。参数都是选填,用户可清除默认值;类型改变后应重新检查默认值与展示方式是否匹配。上移、下移调整顺序;复制后要检查标识和文案,避免多个字段重名。删除及清除默认值会改变当前草稿,确认后再保存。
专家团逐项图解
图解:专家团的分类、名称与品牌资料
入口为“Agent智能体 → 专家管理 → 创建专家团”。先选择所属分类,再填写团队名称、简介及图标。
图中编号:1 名称;2 团队主题色;3 简介;4 允许使用的模型;5 团队默认模型;6 添加。
图中编号:1 预览;2 保存并试运行;3 保存草稿。
分类支持多选,清空表示暂不归类;停用分类不在专家中心显示。团队主题色用于标题、头像边框和负责人标识,清除后自动适配。图标支持PNG、JPG、WebP、SVG,最大2MB,也可手动填写图标地址。简介说明团队适合解决什么问题,补充团队资料用于完善说明。
图解:专家团的允许模型与团队默认模型
在“专家团模型配置”中按执行用途设置允许模型和团队默认模型,再检查团内负责人和成员。
图中编号:1 名称;2 团队主题色;3 简介;4 允许使用的模型;5 团队默认模型;6 添加。
图中编号:1 预览;2 保存并试运行;3 保存草稿。
允许模型留空表示允许全部可用模型。缩小范围时,原成员超出范围的个人模型会恢复为团队默认模型。点击“应用到所有相关专家”会覆盖该用途下个人模型设置,其他用途保持原配置;保存草稿后才生效。检查各成员职责和资源绑定,不能只写简介就认为已经获得工具权限。
图解:专家团的选填参数与运行限制
点击“更多高级配置”展开。按需添加选填参数、角色命令、推荐提问,再检查下方运行限制。
图中编号:1 名称;2 团队主题色;3 简介;4 允许使用的模型;5 团队默认模型;6 添加。
图中编号:1 职位;2 简介;3 表单底部说明;4 保存并试运行;5 保存草稿。
选填参数都允许用户不填,默认值也可被用户清除,清除后不会自动重新填回。职位、简介和表单底部说明用于解释角色及填写方法。运行限制分别包括最多任务数、团队并发数、单角色并发数、任务超时(毫秒)、最多模型轮数、自动重试和自动返工上限;按业务规模及模型能力逐项核对,不要把毫秒当成秒。先预览检查展示,再点“保存草稿”;“保存并试运行”还会触发执行,需确认资源与费用。草稿保存后仍需发布版本并核对可见范围,用户才可按发布状态使用。