第3章 角色管理操作
3.1 角色管理模块
3.1.1 创建角色
- 点击角色管理-新建角色-填写信息-创建角色
部门:测试部, 模型配置:选择当前系统默认,推理参数覆盖(留空使用配置默认值: temp=0.7、 top_p=1、 max_tokens=4096)-推荐默认, 简介:角色需要做什么介绍(测试:测试mylnc系统,保障系统质量), 通知渠道在角色详情-编辑配置。


- 角色创建成功后,点击角色管理一级菜单,看是否有你创建的角色。

绿色框框:详情,可进入角色详情,工作流在这里
黄色框框:编辑:可编辑修改这个角色信息
蓝色框框:运行情况:运行中/停止运行
红色框框:删除角色
3.1.2 角色详情
角色详情中有对话、目标驱动、工作流、运行记录评估、审批队列、记忆、用户、技能、知识库、文件等,如下图:

3.1.2.1 对话
功能:这是与 AI 角色进行实时互动的核心窗口。 主要用途: 即时测试:发送文本消息,验证角色的回复逻辑、语气和知识储备。 技能触发:通过自然语言指令触发角色已绑定的技能(如截图中显示的 describe_self)。 上下文验证:检查多轮对话中的记忆能力和逻辑连贯性。如下图:

3.1.2.2 驱动目标
功能:配置角色的长期任务或自主行为模式。 主要用途:设定角色的自动执行的任务链。例如,让“测试员”自动巡检某个接口,或者每天定时生成一份报告,而无需人工每次下达指令。如下图:

3.1.2.3 工作流(重点)-这个第4章节详细介绍
功能:可视化的业务流程编排中心 逻辑编排:将复杂的业务逻辑拆解为多个节点(如:工作类型 ->信息输入 ->信息校验-> 信息审批 ->信息执行结 -> 发送通知)。 自动化执行:定义当特定事件发生时,角色应如何一步步执行操作。这是实现复杂自动化任务的核心模块如下图:

3.1.2.4 运行记录
功能定义:角色的历史活动日志与审计追踪。 主要用途:查看角色在过去一段时间内执行了哪些任务、调用了哪些 API、出参入参以及任务的执行状态(成功/失败)。用于排查问题和复盘。如下图:

3.1.2.5. 评估
功能定义:对角色表现进行打分和质量监控的模块。 主要用途: 人工评测:管理员对角色的回答进行点赞/点踩或打分。 自动化评测:配置测试集,批量运行并对比模型输出与标准答案的差异,用于优化 Prompt 或模型参数。如下图:

3.1.2.6 审批队列
功能定义:人机协同的安全网关。 主要用途:当角色执行高风险操作(如删除数据库、发送邮件、支付)时,系统会暂停执行并将请求放入此队列,等待人工确认后方可继续。确保 AI 行动可控。如下图:

3.1.2.7 记忆
功能定义:管理角色的长短期记忆库。 主要用途: 短期记忆:查看当前的对话上下文窗口。 长期记忆:查看角色从历史对话中提取并存储的关键信息(如用户偏好、重要事实),支持向量检索,让角色越用越聪明。如下图:

3.1.2.8 用户
工作流审批中指定的用户,必须是真实用户,非角色。(配置飞书审批)如下图:

3.1.2.9 技能
功能定义:角色的能力扩展插件中心。如下图:
3.1.2.10 知识库
功能定义:角色的专属外部大脑(。 主要用途:上传企业文档、PDF、Word 或 Markdown 等文件。当用户提问时,系统会从这些文档中检索相关信息喂给大模型,解决大模型不知道内部数据的问题。如下图:

3.1.2.11 文件
功能定义:资源管理中心。 主要用途:管理该角色在运行过程中产生或引用的所有文件资产,如生成的报表、上传的素材图片等。如下图:

3.1.2.12 定时任务
定时任务工作流配置:去「工作流」→「信息来源」编辑,触发定时任务来此模块看触发情况.

3.1.2.13 自学习
3.1.2.13.1 功能概括
自学习是智能体(Agent)进化的核心引擎。系统会自动监测 Agent 在历史任务中的成功路径,将其提炼为可复用的“技能”。通过本模块,您可以控制学习策略、审核新技能提案、调整优化规则,并实时监控 Agent 的成长数据,实现“越用越聪明”的自动化闭环。
3.1.2.13.2 全局策略配置
页面顶部的控制面板决定了自学习系统的运行逻辑与发布标准:
-
启用/禁用自学习:控制引擎总开关。启用后系统实时监测并提炼新技能;禁用后停止自动提炼,但已生效技能仍可正常使用。
-
需要用户确认:
- 开启(推荐):系统提炼的新技能需经人工审核通过后方可上线,确保业务安全性。
- 关闭(全自动):当系统判定置信度达标(如 ≥ 70)时,自动发布技能,无需人工干预,适合快速迭代场景。
-
全局默认:一键将当前配置应用为所有角色的默认标准。

3.1.2.13.3 核心数据看板
仪表盘实时展示 Agent 的“智力”成长状态:
-
已提炼技能:当前已生效的技能总数及近期新增数量。
-
待确认提案:等待人工审核的新技能数量。
-
经验命中率:历史任务中成功复用已有经验的比例,数值越高代表自动化程度越高。
-
学习成熟度:综合评分(满分 100),直观反映 Agent 的智能化水平。

3.1.2.13.4 技能提炼管理
此区域是技能的“加工厂”,分为待确认和已学习两部分:
待确认提案
- 系统根据近期工具调用序列检测到的重复模式会在此处展示。
- 若设置为“需要用户确认”,新技能将在此停留等待审核。
已学习技能
-
技能卡片信息:展示技能名称、存储路径(如
草稿 · workspace/)、自动化序列(工具调用链)、近30天调用次数、成功率及节省 Token 数。 -
操作按钮:
-
详情:查看技能的完整代码逻辑、参数配置及触发示例。
-
发布:将草稿状态的技能正式上线,使其对 Agent 可见可用。
-
删除:移除该技能记录。
-

3.1.2.13.5 经验记录
此列表记录了每一次技能提炼或匹配的上下文详情:
-
相似度阈值
:控制“同案重查”的宽松程度。
- 值越高越严格:必须几乎一致才算命中。
- 值越低越宽松:类似意图都会归组。
- 注:拖动滑块后自动保存,立即生效。
-
搜索摘要:支持通过关键词快速检索历史记录。

3.1.2.13.6 优化规则
此区域用于微调技能触发的灵敏度,确保 Agent 既不会“乱动”也不会“漏动”:
-
命中阈值:意图相似度达到此值才触发优化器。低于此值则忽略。
-
直接命中阈值
:达到此值时跳过 LLM 验证直接执行。
- 左侧滑块(宽松):大范围召回,可能误命中。
- 右侧滑块(严格):同类意图高命中(推荐)。
-
状态管理:可针对特定规则进行“启用”或“禁用”操作,也可设置置信度条来可视化当前的匹配概率。

3.1.2.13.7 常用操作指引
-
如何上线一个新技能? 进入“技能提炼”页签 -> 在“待确认提案”中找到目标技能 -> 点击“详情”检查逻辑无误 -> 点击“发布”。
-
如何提高 Agent 的响应速度? 在“优化规则”中适当调低“直接命中阈值”,让更多相似任务跳过复杂的 LLM 思考过程,直接复用已有经验。
-
如何强制系统学习历史数据? 点击右上角的“立即扫描”按钮,系统将重新分析近期的运行记录,挖掘潜在的新技能。
3.1.2.14 配置与编辑配置(右上角)重点配置飞书渠道
功能定义:角色的基础设置入口。 主要用途:修改基础信息、选择的模型(如 DeepSeek-v4-pro)以及温度参数、渠道接入等属性;下面是飞书渠道接入详细介绍。如下图:

- 渠道接入:飞书操作配置 重点

-
注册成功-点击开发者后台-创建企业自建应用-填写应用名称、应用描述-创建

-
创建应用成功-点击创建的应用进去信息界面-添加应用能力-配置机器人-填写信息-配置成功

-
点击权限管理-开通权限-搜索机器人-绑定权限--确认开通-开通权限成功

-
开通后搜索:im:message:send,im:message,im:message:send_as_bot,contact:user.employee_id:readonly,contact:contact.base:readonly-开通应用权限
-
搜 contact:user.employee_id:readonly →「获取用户 user ID」→ 开通
-
搜 contact:contact.base:readonly →「以应用身份读取通讯录(基本信息)
-
上面均开通完成后-权限均开通成功,如下图:


- 权限开通完成-去【事件与回调】-【事件配置】-使用 长连接 接收事件-保存


- 【事件配置】完成后-【回调配置】-使用 长连接 接收事件-保存

- 用python运行(SDK指南),也可以golang、java等-事件与回调均已运行成功-回到事件订阅和回调订阅点击像wifi图形验证是否连接成功-连接成功(sdk需要对应应用的id和secret)


- 事件配置-添加事件-搜索机器人-全部添加-保存-去发布-发布成功-客户端会发来开发小助手发布成功提醒




- 去系统对-需要配置的对应角色-角色详情-编辑配置-渠道接入-飞书中填写应用的App ID、App Secret和token-保存

- App ID、App Secret在飞书开发平台凭证与基础信息中,token在事件与回调的加密策略中



3.1.2.13 停止 (红色按钮)
功能定义:紧急制动开关。 主要用途:强制终止当前正在运行的任务或工作流,防止 AI 陷入死循环或执行错误操作。如下图:
