本课目录(11 节)
5.6 WMA 与积分口径
概念
前面讲了企业管理后台的成员和能力下发,现在进入本章最抽象也是客户最难理解的部分——WMA 与积分消耗。
WMA 全称是 WorkBuddy Managed Agents,它的定位是"让 Agent 跑在云端而不是某个人的电脑上"。7×24 运行、数据不出域、可评测、可 API 集成。但要给客户讲清楚 WMA,你需要一个直觉性的心智模型。
心智模型:Agent 是图纸、Runtime 是厂房、Session 是一次生产
| 概念 | 类比 | 通俗解释 |
|---|---|---|
| Agent | 图纸 | 定义了 AI 要做什么、用什么工具、调什么知识库 |
| Runtime | 厂房 | 执行 Agent 的运行环境,有 GPU、有模型、有工具调用能力 |
| Session | 一次生产 | Agent 在 Runtime 上跑一次,从开始到结束 |
🖼 图:Agent / Runtime / Session 关系:1 个 Agent 可创建 N 个 Runtime,1 个 Runtime 可包含 N 个 Session,Session 彼此独立、上下文隔离。
客户最常问的问题是:"Agent 和 WMA 是什么关系?"用这个心智模型来回答:
-
Agent 是设计图 ——你在后台配的 Agent 定义(Prompt、工具、知识库),就是一张图纸
-
WMA 是工厂运营方 ——它管理 Runtime(厂房),负责把图纸变成产品
-
每次调用产生一个 Session ——就像工厂接了一个订单,跑完出货
所以,WMA 不是某个具体的东西,而是一套让 Agent 自动运行的管理机制。
Manifest:声明式配置
Manifest 是 Agent 的声明式配置(JSON),创建时传入,可在企业后台编辑管理。
最小配置
{
"id": "my-agent",
"name": "My Agent",
"manifestVersion": "1.0"
}
| 配置组 | 关键字段 |
|---|---|
| 基础 | id、name、manifestVersion(三者必需);system_prompt 与 system_prompt_file 互斥 |
| 能力 | rules 行为规则、skills 预定义技能、plugins 扩展插件、mcp MCP 服务、subagents 可调用的子 Agent |
| 工作空间 | workspaces[].name(必需,映射到 /workspace//)、repository、downloadUrl、ref、initShellCommand、initCommand |
| 环境 | secrets 敏感信息(通过安全通道注入,不写入沙箱文件)、envs 环境变量 |
提示
安全写法:
secrets支持${VAR_NAME}引用环境变量,避免硬编码密钥。系统会自动注入AGENTOS_RUNTIME_ID。另有凭据管理功能:Agent 调用 MCP、Skill 或外部 API 时自动注入认证凭据,凭据加密存储、仅运行时由代理层解密注入请求头,不在配置中明文暴露。
交付出去:两种接入方式
接入链接
点 接入 → 复制链接 分享给团队成员,每个人打开链接都会自动获得一个专属的独立 Session,对话历史和产出文件互不干扰。
API 集成
开发集成 › API 集成:通过企业 API Key 调用,把 Agent 能力集成到客户自有系统中。Session 列表里「调用方」会显示 API Key。
提示
为什么这一条对 FDE 是杠杆:过去要让客户全员用上,得一台台装、一个个教。现在发一条链接就能让几十人各自拿到独立环境——第 7 章讲的 PEV 里「实证」环节,让真实用户上手的成本被压到几乎为零。试点扩面从「一周排期」变成「一条链接」。
运维视角:Runtime 与 Session 状态
| 状态 | 含义与处理 |
|---|---|
| 运行中 | 沙箱正在活跃服务 |
| 休眠 | 空闲超时后自动暂停,再次访问自动唤醒。Session 超过 10 分钟无访问会自动休眠以节省资源 |
| 失败 | 沙箱创建或启动异常。Session 出问题时在 Runtime 页排查沙箱模板、状态和错误原因 |
提示
两条运维提醒:① 通常 Session 与 Runtime 一一对应,如果 Runtime 没有关联 Session,可能是 Session 已删除但沙箱资源未回收,建议及时清理释放资源;② 删除 Session 将永久清除对话记录和文件,交付给客户前要把这条写进操作手册。
Agent 评测:把「感觉不错」变成分数
通过标准化的评测任务衡量 Agent 的回答质量:选择目标 Agent 和评测数据集,系统自动逐条运行测试用例并按指定评分方式计算得分。
提示
这个功能直接对应第 7 章的「验收标准怎么定」。 FDE 最常见的失败是验收标准事后补、于是「感觉不错」就算通过。有了评测数据集,验收从主观判断变成可复算的数字。评测集要精选而不是堆量。建议做法——把试点期收集的失败样本整理成评测集,这样每次迭代都在和自己最差的表现赛跑。
Playbook:不用从零写 System Prompt
Playbooks 是预配置的工作流模板,面向泛开发者——产品经理、设计师以及任何希望完成任务但未必精通提示词工程的用户。它把上下文、工具和指令打包成可复用模板。
| 配置项 | 说明 |
|---|---|
| 名称 | Playbook 的显示名称 |
| 模型 | 使用的模型,支持指定或自动选择(auto) |
| Agent ID | 唯一标识符,用于引用和调用该 Playbook |
| System Prompt | 引导 Agent 行为的背景上下文和指令,定义角色、工作流程和输出规范 |
用法:在 AI 资源管理 › Playbooks 点开某个模板,查看 Manifest 摘要、场景说明、工作流设计、SDK 调用范例,然后点 使用此 Playbook 创建 Agent。
提示
FDE 的用法:Playbook 是「模板化沉淀」的官方载体。你在客户 A 做熟的一套工作流,抽象成 Playbook 后,客户 B 的同类场景可以直接套。这正是第 8 章「成本曲线」能压下来的具体机制之一——第五个项目应该在「组装」,不是在「构建」。
用法
WMA 的三种触发方式
| 触发方式 | 类比 | 适用场景 |
|---|---|---|
| 定时触发 | 闹钟 | 每天定时跑报表、定时巡检 |
| 事件触发 | 传感器 | 业务系统产生事件后自动响应 |
| API 触发 | 下单 | 外部系统通过 API 调用 Agent |
积分消耗口径:一张表讲清钱花在哪
客户一定会问。官方口径高度一致:管理和配置动作不消耗积分,真正跑任务才消耗。
| 动作 | 是否消耗 | 官方口径 |
|---|---|---|
| Skill 浏览 / 上传 / 管理 | 不消耗 | 成员在客户端调用 Skill 执行任务时,由客户端根据任务内容消耗 |
| 知识库上传 / 解析 / 索引 | 不消耗 | 对话中 @ 引用后,检索、汇总和生成回答时消耗 |
| 连接器读写操作 | 不消耗 | 客户端对连接器返回的外部数据做理解、汇总、生成回答时消耗 |
| Playbook 浏览 / 选择 | 不消耗 | 基于它创建 Agent 后,对话中调模型、执行代码、访问外部服务时消耗 |
| 专家创建 / 修改 / 打包 | 不消耗 | 与专家对话时消耗 |
| Agent 评测 | 消耗 | 启动评测将消耗个人积分 |
提示
报价时用这张表。客户常担心「配置阶段就烧钱」。事实是建设期成本极低,成本发生在真实使用时——这恰好支持第 8 章讲的定价逻辑:不按人天,按实际产生的价值和用量。 ⚠️ 注意:旗舰版、专享版均含 2000 Credits/人、每月刷新、积分团队内共享使用、对话问答不限频。积分消耗的具体数值和计费规则因部署形态和合同条款而异,不要在客户面前随口报数字。如果客户问"跑一次大概多少钱",你需要根据合同约定的积分单价和 Agent 的平均 Token 消耗来估算。如果不确定,请先跟商务团队确认。
示例
用心智模型解释 WMA 积分消耗的完整对话:
客户 CIO:"WMA 到底怎么收费的?我们一个月大概要花多少积分?"
FDE:"我打个比方。Agent 是一张图纸,Runtime 是厂房,
每次跑一个 Session 就像厂房开了一次生产。
关键原则是:配置不花钱,执行才花钱。
你上传 Skill、建知识库、配连接器——这些都不消耗积分。
真正消耗积分的是:
- 客户端调用 Skill 执行任务
- 对话中 @ 引用知识库后的检索和生成
- 连接器返回数据后的理解和汇总
- Agent 评测启动
旗舰版每月每人 2000 Credits,团队内共享。
要估算月度消耗,我建议先试运行一周看看实际消耗,
然后根据试运行数据来估算月度预算。"
客户 CIO:"那如果我们在私有化版本上跑呢?"
FDE:"私有化企业版无用量限制,对话问答不限频。
但 WMA 的管理和调度仍可能有基础消耗,具体看合同约定。"
**⚠️ 风险提示:**在给客户讲积分消耗时,一定要强调"先试运行、再估算"。不要在没数据的情况下给客户报数字,一旦实际消耗超了预期,客户会质疑你的专业性。建议在交付初期设置积分预算上限和告警,避免意外消耗。另外,积分团队内共享意味着某个成员跑一个大批量任务,消耗的是团队池子,试点期一定要提前跟客户对齐用量预期。
随堂测
逐题作答,即时反馈
1. 按 5.6 节给客户讲 WMA 用的心智模型,Agent、Runtime、Session 分别类比为什么?
2. 客户 CIO 问「哪些操作会消耗积分」,按官方口径下列说法正确的是?
3. 关于 WMA 中 Session 的运维细节,符合课文的是?