Beaver/beaver_project
6
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

```

Browse Source 
feat(engine): 优化智能体循环中的助手消息处理逻辑

- 在没有工具调用时才添加助手消息到上下文
- 确保工具调用响应正确添加到消息上下文中
- 修复了消息构建的条件逻辑

fix(cron): 改进定时任务调度的时间解析功能

- 添加正则表达式导入用于时间显示解析
- 实现从显示文本中提取毫秒间隔的功能
- 增强整数转换的安全性，避免类型错误
- 优化定时任务配置的解析逻辑

feat(outlook): 增强Outlook集成的功能和稳定性

- 将默认超时时间从10秒增加到180秒
- 为状态检查函数添加可选的验证参数
- 串行执行邮件概览获取操作而非并行
- 改进连接状态验证逻辑

feat(channel): 添加设备名称作为会话标识的选项

- 为终端WebSocket适配器添加新的配置选项
- 实现基于设备名称生成会话对等ID的功能
- 记录原始对等ID和设备名称的元数据
- 支持从设备名称创建会话对等ID

feat(skills): 完善技能学习评估系统和进度跟踪

- 在应用启动时自动调度待评估的技能草稿
- 为技能评估工作创建独立的循环工厂
- 实现异步技能评估任务的取消和清理机制
- 添加技能评估进度报告和状态跟踪功能
- 扩展会话列表API以包含更多详细信息
- 防止对不存在的会话进行操作
- 优化技能草稿提交和评估的业务逻辑

perf(skills): 提升技能评估的并发性能

- 实现并行技能案例评估以提高效率
- 添加最大并行案例数的环境变量控制
- 实现实时评估进度更新和回调机制
- 优化评估过程中的资源管理和同步

refactor(services): 创建隔离的智能体循环实例

- 添加创建独立智能体循环的工厂方法
- 确保新循环继承运行时服务配置
- 支持技能评估等需要隔离环境的场景
```
This commit is contained in:
steven_li
2026-06-15 14:48:16 +08:00
parent 8aeb97a5fc
commit 4b0bf65ace
53 changed files with 4328 additions and 292 deletions
Download Patch File Download Diff File Expand all files Collapse all files

435
docs/presentations/beaver-management-demo/beaver-management-demo.md Normal file
View File

@ -0,0 +1,435 @@
# Beaver 管理层演示方案
对象：公司管理层
时长：60 分钟
目标：让老板看懂 Beaver 是什么、现在已经能做什么、可以用在公司哪些地方，以及为什么值得继续投入。
## 一句话定位
Beaver 不是一个聊天机器人，而是一个企业内部 Agent 工作台：它能执行任务、使用文件和工具、保留过程证据、等待人工验收，并把成功的工作方式沉淀成可复用的企业技能。
## 演示主线
不要按页面逐个介绍，而是讲一个业务故事：
> 假设这是公司里普通的一天：老板需要经营晨报，产品团队需要从客户反馈里判断优先级，项目团队需要提前识别风险，团队还要准备管理层汇报、沉淀可复用方法，并让周期性工作自动运行。Beaver 就是承载这些 Agent 工作的地方。
## 60 分钟流程
| 时间 | 环节 | 目的 |
| --- | --- | --- |
| 0-5 分钟 | 开场 | 定义 Beaver 是 Agent 工作系统，不是聊天产品 |
| 5-12 分钟 | 场景 1：老板晨报 | 展示多信息源汇总和管理层摘要 |
| 12-20 分钟 | 场景 2：客户反馈到产品决策 | 展示从杂乱反馈中提炼业务判断 |
| 20-28 分钟 | 场景 3：项目风险与行动计划 | 展示风险识别和管理层决策支持 |
| 28-38 分钟 | 场景 4：复杂任务与可追踪执行 | 展示聊天转任务、过程、修订和验收 |
| 38-48 分钟 | 场景 5：企业技能复用 | 展示 Beaver 的长期复利价值 |
| 48-55 分钟 | 场景 6：定时任务与治理 | 展示主动执行、状态、日志和控制能力 |
| 55-60 分钟 | 收尾讨论 | 讨论 Beaver 下一步适合在哪些内部场景试点 |
## 需要提前上传的文件
文件目录：
```text
docs/presentations/beaver-management-demo/upload-files/
```
建议上传顺序：
1. `sales-weekly.csv`
2. `project-risks.md`
3. `customer-feedback-q2.md`
4. `meeting-notes.md`
5. `project-status.md`
6. `support-tickets.csv`
7. `weekly-ops-metrics.csv`
## 开场话术
可以这样开场：
> 今天不把 Beaver 当成聊天机器人演示。我们把它当成一个企业内部 Agent 工作台来看：员工可以把真实工作交给 Beaver，Beaver 可以使用文件和工具，生成可交付结果，留下执行过程，等待人来验收或要求修改。如果这个工作以后会重复，Beaver 还可以把被认可的方法沉淀成可复用技能。
然后补充业务背景：
- 聊天工具能回答问题，但企业工作需要可交付结果。
- 管理层需要过程证据，而不是只有一段看起来流畅的文字。
- 企业落地 AI 需要私有部署、边界、权限和运维控制。
- 重复发生的工作应该沉淀成组织能力，而不是每个人反复写提示词。
## 场景 1：老板晨报
### 业务问题
老板每天不想手动看销售表、项目记录、客户反馈和会议纪要，只想快速知道今天最重要的经营判断和需要拍板的事项。
### 演示目标
展示 Beaver 可以把分散的内部信息整理成管理层能直接看的经营晨报，并标注信息来源。
### 使用文件
- `sales-weekly.csv`
- `project-risks.md`
- `customer-feedback-q2.md`
- `meeting-notes.md`
- `weekly-ops-metrics.csv`
### 提示词
```text
请基于我上传的文件，生成一份给 CEO 的今日经营晨报。
要求：
1. 用管理层语言，不要技术细节
2. 分为：关键结论、风险预警、需要老板决策的事项、建议行动
3. 每个关键结论都标注来自哪个文件
4. 最后给出今天最重要的 3 件事
5. 控制在 800 字以内
```
### 演示步骤
1. 打开 Beaver 聊天工作台。
2. 到 `Files` 页面快速展示已经上传的文件。
3. 回到聊天页，发送提示词。
4. 打开生成的任务或任务详情页。
5. 展示结果、时间线，以及文件/工具相关证据。
6. 现场要求修改：
```text
把这份晨报改成更适合 10 分钟管理层晨会使用的版本，只保留最关键的判断和行动。
```
7. 展示修订结果，并点击接受。
### 讲解话术
> 这里重点不是 Beaver 写了一份摘要，而是这件事已经变成了一项可追踪任务：有原始材料、有执行过程、有结果、有修订、有人工验收。这比一个普通聊天回答更接近真实工作。
### 老板视角价值
- 减少阅读分散信息的时间。
- 把多个信息源整理成决策导向的简报。
- 过程和来源可查看，方便追问和复核。
### 翻车预案
如果现场生成较慢，就先展示上传文件和预期输出结构，然后打开提前跑好的任务或聊天历史。
## 场景 2：客户反馈到产品决策
### 业务问题
客户反馈通常很杂：销售记录、客服工单、访谈纪要里都有不同声音。管理层真正关心的是哪些问题影响收入、续约和试点成功，哪些可以后排。
### 演示目标
展示 Beaver 能从非结构化反馈中提炼主题、判断优先级，并形成产品投入建议。
### 使用文件
- `customer-feedback-q2.md`
- `support-tickets.csv`
### 提示词
```text
请分析这些客户反馈和支持工单，输出一份产品决策建议。
要求：
1. 聚类出 5 类主要问题
2. 判断每类问题的业务影响
3. 给出优先级：P0 / P1 / P2
4. 区分“必须马上做”和“可以进入路线图”
5. 给老板一个 90 天产品投入建议
6. 最后列出还需要进一步验证的假设
```
### 演示步骤
1. 打开 `Files`，展示 `customer-feedback-q2.md` 和 `support-tickets.csv`。
2. 回到聊天页发起分析任务。
3. 展示输出结构：主题聚类、优先级、业务影响、90 天建议。
4. 要求 Beaver 改写成一页管理层备忘录：
```text
请把这个结果改成一页管理层备忘录，重点突出投入产出比和不做的风险。
```
### 讲解话术
> 这个场景说明 Beaver 对管理层的价值不只是写文案，而是把大量不规整的信息转成可以讨论和决策的材料。
### 老板视角价值
- 更快从客户噪声里抓住信号。
- 让产品优先级讨论更有依据。
- 把产品投入和业务影响连接起来。
### 翻车预案
如果输出太长，就直接追问：
```text
请压缩成老板只需要看 5 分钟的一页摘要。
```
## 场景 3：项目风险与行动计划
### 业务问题
项目延期通常不是突然发生的，早期信号可能已经出现在会议纪要、状态周报、风险记录里，例如验收标准不清、依赖延期、资源不足、审批阻塞。
### 演示目标
展示 Beaver 可以作为 PMO 助手，提前识别项目风险，并给出管理层应该介入的事项。
### 使用文件
- `project-status.md`
- `project-risks.md`
- `meeting-notes.md`
### 提示词
```text
你现在是项目管理办公室 PMO。
请基于这些项目材料，判断哪些风险可能导致延期。
输出：
1. 风险清单
2. 每个风险的影响、概率、责任人建议
3. 本周必须推进的行动项
4. 哪些事项需要管理层介入
5. 一份可以发给项目负责人的跟进邮件
```
### 演示步骤
1. 在聊天页发送 PMO 提示词。
2. 展示 Beaver 生成的风险矩阵和行动项。
3. 打开任务详情页，说明过程证据。
4. 追问一个管理层问题：
```text
如果老板今天只能拍板 2 件事，应该是哪 2 件？请说明原因和不拍板的后果。
```
### 讲解话术
> Beaver 适合处理这种需要判断、需要留下结果、还需要人来审核的工作。这里它把项目材料转成了风险清单、决策清单和跟进邮件。
### 老板视角价值
- 更早发现项目风险。
- 明确责任人和行动项。
- 提高向上升级问题的质量。
### 翻车预案
如果 Beaver 漏掉某个风险，不要回避，可以把它变成修订演示：
```text
你漏掉了“验收标准变化”这个风险，请重新评估它的影响，并更新行动计划。
```
## 场景 4：复杂任务与可追踪执行
### 业务问题
真实企业工作不是一个问题一个答案，而是需要拆解、分析、起草、审核和修改。
### 演示目标
展示 Beaver 和普通聊天工具的核心区别：复杂请求可以变成可管理的任务，而不是一次性聊天回复。
### 使用文件
这个场景可以复用前面文件，也可以不依赖文件。
### 提示词
```text
请帮我为 Beaver 准备一份给公司老板看的项目汇报框架。
目标是说明：
1. Beaver 是什么
2. 现在已经能做什么
3. 可以用在哪些企业场景
4. 为什么值得继续投入
5. 下一阶段建议做什么
请先拆解任务，再生成最终汇报大纲。少讲技术，多讲业务价值、风险控制和投入产出。
```
### 演示步骤
1. 在聊天页发送提示词。
2. 展示 Beaver 如何从对话进入任务执行。
3. 打开任务详情页。
4. 展示时间线、中间步骤、最终结果和验收控件。
5. 要求修改：
```text
把这个汇报框架改得更像董事会材料：每一部分都要回答“为什么重要、现在有什么进展、下一步要什么资源”。
```
6. 展示修订后的结果，并点击接受。
### 讲解话术
> Beaver 的核心产品想法是让 AI 工作可检查。对管理层来说，重要的是能看到问了什么、做出了什么、怎么修改过、什么时候被人接受。
### 老板视角价值
- 把模糊需求转成结构化工作。
- 支持带上下文的连续修订。
- 让 AI 工作具备内部使用所需的可审查性。
### 翻车预案
如果任务模式没有明显触发，就继续在聊天里演示，然后打开 `Tasks` 页面展示历史任务记录。
## 场景 5：企业技能复用
### 业务问题
企业里很多好方法会反复使用：周报、风险复盘、客户反馈分析、项目更新、事故总结。普通 AI 聊天每次都要重新教，经验无法自然沉淀。
### 演示目标
展示 Beaver 可以把成功工作保留下来，形成可复用技能，从而产生长期组织能力。
### 使用文件
复用前面场景的输出即可，不需要新增上传文件。
### 演示步骤
1. 打开 `Skills` 页面。
2. 展示已发布技能，例如文件操作、搜索、Outlook、定时任务、终端、技能编写等。
3. 解释技能生命周期：
- 已接受任务
- 技能候选
- 草稿生成
- 安全检查和 replay 评测
- 人工审核
- 发布
- 后续任务复用
4. 如果页面展示评测覆盖率或报告，顺手点出来。
5. 回到聊天页，发起一个类似任务：
```text
请按刚才的管理层汇报风格，再生成一版项目周报。保留同样的结构：关键结论、风险、需要老板决策的事项、下一步行动。
```
### 讲解话术
> 这是 Beaver 的复利价值。第一次运行得到一个结果；一次被接受的成功工作，可以变成可复用的方法。时间久了，公司积累的是自己的 Agent 能力库，而不是每个人自己的提示词经验。
### 老板视角价值
- 减少重复说明。
- 沉淀公司自己的工作方法。
- 在广泛复用前保留审核和治理环节。
### 翻车预案
如果现场完整技能生成流程不够稳，不要强行演示。展示 `Skills` 页面和生命周期即可，把它作为可治理能力说明。
## 场景 6：定时任务与治理
### 业务问题
很多管理动作应该周期性发生，而不是靠人每天想起来：日报、周报、风险检查、客户反馈汇总、项目提醒。
### 演示目标
展示 Beaver 可以从被动聊天变成主动运营，并且管理员可以看到状态和日志。
### 使用文件
- `sales-weekly.csv`
- `project-risks.md`
- `customer-feedback-q2.md`
- `weekly-ops-metrics.csv`
### 演示步骤
1. 打开 `Cron` 页面。
2. 新建或展示一个定时任务：
```text
每天上午 9 点生成经营晨报，汇总销售、项目风险、客户反馈和运营指标。
```
3. 展示启停、运行记录，或手动触发一次。
4. 如果已有结果，打开 `Notifications` 展示定时运行产物。
5. 打开 `Status` 和 `Logs`。
6. 说明管理员可以查看 provider 配置、运行状态、连接器状态和失败记录。
### 讲解话术
> 这一步说明 Beaver 可以从助手变成运营系统：周期性 Agent 工作可以被配置、监控和审核。
### 老板视角价值
- 让重复工作主动发生。
- 管理员能看到运行状态。
- 有失败记录和配置入口，企业落地更可控。
### 翻车预案
如果现场没有可用的定时运行结果，就只演示创建配置，并说明生成结果会进入任务或通知。
## 收尾话术
可以这样收尾：
> Beaver 当前最适合先在三类内部场景试点。第一，管理层信息汇总，比如晨报、周报和项目汇报。第二，围绕客户、产品、运营、项目的重复分析工作。第三，需要证据、审核和人工验收的 AI 任务。它的战略价值不是替代某个人，而是把 AI 从临时问答变成可控制、可复用、可治理的工作系统。
## 推荐试点场景
先选 2-3 个窄场景，不要一开始铺太大。
| 试点工作流 | 为什么适合 Beaver | 成功信号 |
| --- | --- | --- |
| CEO 或部门周报 | 多文件输入，需要简洁管理层输出 | 一轮以内修订后可接受 |
| 客户反馈分析 | 输入混乱，但输出能支持决策 | 产品负责人把结果用于优先级会议 |
| 项目风险评审 | 需要证据和管理层行动 | 风险在升级会议前被识别 |
| 每周支持工单总结 | 高频重复，适合技能复用 | 同一技能连续复用 3 周 |
| 内部事故复盘 | 需要时间线、证据和后续行动 | 审核人能从 Beaver 输出理解事件经过 |
## 演示前检查清单
演示前：
- 确认 Beaver 实例能登录。
- 确认 provider/model 配置可用。
- 上传 `upload-files/` 里的所有文件。
- 提前跑一遍场景 1，并保留结果。
- 提前跑一遍场景 4，并保留任务详情页。
- 提前打开这些页面：Chat、Files、Tasks、Skills、Cron、Status、Logs。
- 准备一份提示词备份，本 Markdown 可以直接作为备份。
演示中：
- 不要解释每一个页面。
- 反复回到同一个主线：任务、证据、验收、复用、治理。
- 如果现场生成慢，切到提前跑好的历史任务。
- 如果输出不完美，就用它演示修订和人工验收。
## 可放进 PPT 的一页总结
```text
Beaver = 企业 Agent 工作台
1. 执行真实工作，不只是聊天
2. 使用文件、工具、任务和连接器
3. 保留过程证据，方便审核
4. 通过人工验收保证可信输出
5. 把成功工作沉淀成可复用技能
6. 支持私有部署和运维治理
```