MTClaw × BossAgents 数字员工集成验证报告

MTClaw × BossAgents 数字员工集成验证报告

一、项目概述

1.1 目标

为HICOOL开发者挑战赛·MTClaw智能体赛道完成数字员工与MTClaw的完整集成验证,证明三场景流程能走通,具备进入复赛资格。

1.2 三场景定义

  • 场景A:MTClaw调度 + Ollama端侧模型(gemma3:4b)
  • 场景B:MTClaw调度 + 云端模型(deepseek-r1:8b)
  • 场景D:无MTClaw,BossAgents直接执行

1.3 核心认知

  • MTClaw是工具路由代理,不是工作流引擎
  • MTClaw只路由到worker入口,不干预worker内部执行
  • BossAgents负责worker内部的多步骤工作流编排(规则引擎+LLM)
  • MTClaw的加速收益来自"把高频确定性操作从大模型链路中剥离出来"

二、技术架构

2.1 架构图

用户请求
    ↓
【场景A/B】MTClaw路由层
    ├─ 匹配工具? → 本地执行wrapper → 调用BossAgents API → 返回结果
    └─ 不匹配? → 透传给上游大模型 → 返回结果
    
【场景D】BossAgents直接执行
    └─ 规则引擎判断 → LLM推理 → 返回结果

2.2 关键组件

  1. MTClaw配置C:\Users\Administrator\.function-router\config.json
  • routing.model: gemma3:4b(调度模型,快速路由)
  • upstream.model: deepseek-r1:8b(上游模型,处理复杂请求)
  1. BossAgents配置D:\bossagents\server\data\demo\config.json
  • mtclaw.enabled: true
  • mtclaw.base_url: http://127.0.0.1:18790/v1
  1. Wrapper脚本C:\Users\Administrator\.function-router\scripts\*.js
  • 8个数字员工对应的wrapper脚本
  • 每个wrapper调用BossAgents API并返回结果

三、集成过程

3.1 已解决的问题

#### 问题1:编码问题

现象:BossAgents传递中文给MTClaw时编码错误,MTClaw收到乱码无法理解意图

解决方案

headers: { 'Content-Type': 'application/json; charset=utf-8' },
body: new TextEncoder().encode(JSON.stringify({...}))

#### 问题2:Wrapper脚本问题

现象:原始wrapper脚本只返回路由决策,没有真正调用BossAgents API

解决方案:修改wrapper脚本,真正调用https://ylxt.chat/api/digital-staff/run

示例:

const result = await makeRequest('https://ylxt.chat/api/digital-staff/run', {
  staff_id: 'procurement_assistant',
  input: input
});

3.2 已完成的工作

  1. MTClaw编码修复
  • 添加UTF-8编码头
  • 使用TextEncoder确保中文正确传递
  1. Wrapper脚本创建/修复(8个数字员工)
  • procurement_assistant.js
  • vendor_manager.js
  • cost_optimizer.js
  • SCSAI_creator.js
  • ecr_reviewer.js
  • data_clerk.js
  • system_health.js
  • content_generator.js
  1. BossAgents MTClaw配置
  • 启用MTClaw:enabled: true
  • 配置base_url:http://127.0.0.1:18790/v1
  1. 三场景验证
  • 场景A:MTClaw路由成功,业务执行成功
  • 场景B:MTClaw路由成功,业务执行成功
  • 场景D:BossAgents直接执行成功
  1. 批量测试脚本
  • mtclaw-benchmark.js
  • mtclaw-three-scenario-benchmark.js
  • mtclaw-quick-benchmark.js
  • verify-three-scenarios.js

四、验证结果

4.1 服务状态

  • BossAgents服务:✅ 正常运行(https://ylxt.chat)
  • MTClaw服务:✅ 正常运行(http://localhost:18790)

4.2 三场景验证结果

测试用例:采购助手(procurement_assistant)

测试输入:请帮我查询今天的采购订单

| 场景 | 状态 | 耗时 | 说明 |

|------|------|------|------|

| 场景A | ✅ 成功 | 15974ms | MTClaw + Ollama端侧调度 |

| 场景B | ✅ 成功 | 15572ms | MTClaw + 云端调度 |

| 场景D | ✅ 成功 | 6189ms | BossAgents直接执行 |

4.3 性能分析

#### 路由性能

  • gemma3:4b(调度模型):平均路由时间 5-70ms
  • deepseek-r1:8b(上游模型):平均路由时间 300-1300ms

#### 场景对比

  • 场景D最快:无MTClaw路由开销,直接执行
  • 场景A/B较慢:包含MTClaw路由开销 + LLM推理时间
  • 加速场景:高频确定性操作(如系统健康检查、数据查询)通过MTClaw本地执行可显著加速

4.4 关键发现

  1. MTClaw路由本身很快:5-70ms
  2. 主要耗时在LLM推理:10-15秒
  3. 场景D适合:需要完整工作流编排的复杂任务
  4. 场景A/B适合:需要工具路由 + 工作流编排的混合场景

五、演示页面

5.1 访问地址

https://ylxt.chat/demo/unified-demo.html

5.2 演示功能

  • 三场景切换(A/B/D)
  • 8个数字员工选择
  • 实时执行结果展示
  • 性能指标对比

六、竞赛材料

6.1 代码仓库

  • BossAgents主仓库:D:\bossagents
  • MTClaw配置:C:\Users\Administrator\.function-router\

6.2 关键文件

  1. 配置文件
  • MTClaw主配置:config.json
  • 工具定义:function-builtin.jsonl
  • BossAgents配置:server/data/demo/config.json
  1. Wrapper脚本(8个)
  • 位于:C:\Users\Administrator\.function-router\scripts\
  1. 测试脚本(4个)
  • 位于:D:\bossagents\scripts\
  1. 演示页面
  • D:\bossagents\public\demo\unified-demo.html

6.3 验证命令

# 启动BossAgents服务
cd D:\bossagents
node server.js

# 启动MTClaw服务
cd C:\Users\Administrator\.function-router
node server.js

# 运行三场景验证
node scripts/verify-three-scenarios.js

# 运行性能测试
node scripts/mtclaw-quick-benchmark.js

七、结论

7.1 完成情况

三场景验证全部通过

  • 场景A(MTClaw + Ollama端侧):成功
  • 场景B(MTClaw + 云端):成功
  • 场景D(BossAgents直接执行):成功

7.2 技术价值

  1. 证明了MTClaw × BossAgents集成的可行性
  2. 实现了工具路由 + 工作流编排的分层架构
  3. 提供了三场景的完整实现和验证
  4. 具备进入复赛的资格

7.3 后续优化方向

  1. 性能优化:优化LLM推理速度,减少端到端延迟
  2. 工具扩展:添加更多数字员工和工具
  3. 监控告警:添加执行监控和异常告警
  4. 文档完善:补充API文档和使用指南

报告生成时间:2026-07-22

验证环境:Windows 11, Node.js v18+

服务版本:BossAgents v1.0, MTClaw v1.0

← 返回案例列表
分享:
🤖 Try Now →
🤖
🎁