WorkBuddy 企业版 · 管理后台学习手册（技术 + 销售）

先认清：企业版和员工版是两个入口

员工用的是 WorkBuddy 客户端 / 网页端（干活的地方）；管理员用的是 企业管理后台（管人、管权限、管钱、管安全的地方）。
给客户讲的时候，先讲员工端能干什么，再讲后台能管什么 —— 顺序反了，客户会以为这是个 IT 系统，不是生产力工具。

👤 员工端（WorkBuddy）

桌面端 / 网页版 / 小程序 / App / 鸿蒙。
员工在这里跑任务、用专家、用技能、接资料库。
卖点是"活有人干了"。

🛠 管理后台（Admin）

网址：www.workbuddy.cn/admin/overview
管组织、管 AI 资产、管安全、管用量、管合规。
卖点是"老板敢用、IT 敢签字"。

登录与控制台识别

项目	说明
控制台网址	https://www.workbuddy.cn/admin/overview（域名走 HTTPS，直接输入即可）
谁能登录	企业超级管理员、以及被授予后台权限的自定义角色成员。普通员工账号登不进后台。
登录方式	企业已接入统一身份（OneID / SSO）的，用企业账号单点登录；未接入的用管理员账号密码。
顶部区域	左上角显示产品标识（WorkBuddy / CodeBuddy）+ 企业名称/Logo；右上角是账号、产品切换与消息入口。企业名称与头像可在「企业设置 → 基础设置」里改。
左侧主菜单	控制台的骨架。菜单项会随企业已开通的产品模块和当前账号的权限动态变化 —— 所以不同企业、不同角色看到的菜单不完全一样，这是正常现象，不是故障。
首页（组织概览）	管理员登录后的第一个页面，是一张"驾驶舱"：聚合订阅时长、席位占用、额度余量三类关键指标，并内嵌操作指引与客户端安装、帮助文档入口。定位是"开箱引导 + 状态速览"。

演示时的第一句话应该是什么？登录进后台别急着点菜单，先说："这是企业管理员的总控台，第一屏就能看到还有多少天到期、买了多少席位、这个月额度还剩多少 —— 老板最关心的三件事，打开就有。" 客户的眼神会立刻不一样。

控制台导航地图（官方文档口径）

WorkBuddy 企业管理后台把上千个开关收进 11 个功能板块（官方白皮书按能力归为"六大板块"，实际菜单更细）。技术岗要背下这张表，销售岗至少要知道每一格"是干什么用的"。

#	板块	一句话	谁最关心
1	组织概览	订阅时长 / 席位占用 / 额度余量驾驶舱 + 开箱引导	老板、行政
2	企业智能体	Agent 构建、发布、运行、评测（核心）	IT、业务负责人
3	AI 资产管理	模型 / Skill / 专家 / Playbook / Connector 的下发与策略	IT
4	客户端配置	客户端自定义菜单 + 助理渠道开关	IT、行政
5	安全设置	约束成员在客户端能读写什么、能跑什么、能连什么	IT、合规
6	订阅与用量	套餐/席位/额度 + 成员·部门·应用三维用量与明细	老板、财务
7	成员授权	对接 OneID 同步组织架构、成员管理与客户端授权	IT、HR
8	企业设置	企业名称头像 / 网络白名单 / 计量周期口径	IT
9	开发与集成	组织架构同步 + 开放 API / OAuth 2.0	IT、乙方开发
10	日志管理	操作日志（六要素留痕）+ 对话日志（记录开关）	IT、合规
11	订单管理	订单列表 + 合同跳转腾讯云	采购、财务

销售只需要记住三个数字 + 一句话：后台管三件事 —— 管人（成员授权/席位）、管钱（订阅与用量）、管安全（安全设置/日志）；再加上一个"管 AI 资产（模型/技能/专家/连接器）"。四句话说完全部后台，客户就懂了。

11 个板块逐个拆（技术要会用，销售要会讲）

每张卡片：上半部分是功能事实（照着念不会错），下半部分绿色框是给客户的一句话（面谈时直接用）。

1组织概览必看

能力：管理员登录后的单页驾驶舱，聚合订阅时长、席位占用、额度余量三类关键指标，内嵌操作指引与客户端安装、帮助文档入口。 "打开就是老板视图：还剩多少天、几个人在用、额度还能撑多久。"

2企业智能体核心

能力：Agent 构建与运行治理。

快速开始：模板或自然语言创建 Agent；Test Run 测试
基础配置：名称、模型、System Prompt、归属部门、可见范围
技能/专家/MCP 工具配置；高级设置与记忆（跨轮次保持上下文）
Manifest 模板查看与导出
Agents 列表：名称/ID/模型/版本/状态/创建人/Session 数，可发布并限定下发范围
Runtimes / Sessions 列表：沙箱模板、状态、关联关系
自动化任务：单次/定时/间隔 + 提示词，Agent 自动执行
评测中心：Agent 评测、Skill 评测、多组对比评测，自动算分

"你公司最懂业务的那个人，把经验做成一个 Agent 发下去，全公司都能用同一套标准干活。"

3AI 资产管理IT 最关心

模型管理：内置模型 + 新增自定义大模型；白名单（只能用什么）、黑名单（禁止用什么，优先级高于白名单）；成员自定义模型四档管控：允许所有用户 / 白名单模式 / 黑名单模式 / 禁止所有用户。
Skill 管理：上传自定义技能、分类管理（分类名在客户端「企业市场」可见）、下发白/黑名单；另有限定策略（排他，成员只能用指定的几个）与屏蔽策略（只禁个别）。成员自定义 Skill 同样四档。
专家管理：专家列表上传、分类管理、下发白/黑名单。
Playbook：精选 Agent 范例 + 一键导入 manifest，降低冷启动成本。
Connector 管理：官方内置 + MCP 协议对接第三方自定义连接器（支持 MCP OAuth 2.1 / API Key，http streamable 与 sse 两种协议）。 "不是给员工一个万能工具箱，是给每个部门配好他们该用的那几个 —— 研发只能研发的模型，财务只开财务的技能。"

4客户端配置好用

客户端自定义菜单：管理端自动下发自定义菜单到客户端，员工打开就看到公司要他用的入口。
助理渠道设置：管控企业可用的助理渠道（如企微助理渠道），可全部关闭或指定人员可见。开关变更即时生效，客户端约 5 分钟内同步。 "员工不用去找功能，公司要用的那几个入口，我们直接给他摆在桌面上。"

5安全设置决策关键

四个维度统一约束成员在客户端能做什么：文件读写范围、可执行命令、网络访问、内置运行时是否开放。
生效规则：企业策略是基线，员工可在此基础上叠加更严格的个人配置，但不可突破企业限制；一人命中多条策略时，只有优先级数字最大的那条整体生效。
时效：策略保存/启停后，成员重启客户端立即生效；不重启则约 10 分钟周期自动同步。 "它不是'装了个 AI 就管不住'。能读哪些文件、能跑哪些命令、能连哪些网站，都是管理员在白名单里定的，员工改不了底线。"

6订阅与用量老板必看

订阅信息：套餐版本、到期时间、剩余天数、席位三态（全部 / 已授权 / 未授权），可跳转续费与扩容。
月固定用量：固定额度 / 已用 / 剩余，可跳成员用量明细。
加量包：剩余额度与充值记录。
三层用量视角：成员用量（可导出、支持单个/批量调限额）、组织用量（按部门）、应用用量（按应用）。
用量明细：细到 RequestID、积分消耗、成员 ID/名称/部门、模型、消耗类型、客户端、使用时间。 "钱花在谁身上、花在哪个部门、花在哪个模型上，后台一行一行都能查，还能导出给财务。"

7成员授权IT 实施

对接通讯云统一身份（OneID）做组织架构同步、成员管理、客户端授权。
7 种数据源：飞书、钉钉、Windows AD、OpenLDAP、私有化企微、企业微信、微软 Entra ID。
单点登录协议：OIDC、CAS、OAuth 2.0、SAML 2.0、JWT。
管理员角色：支持添加超级管理员，支持配置角色权限赋予对应用户。 "你们现在用企业微信还是钉钉？组织架构直接同步过来，不用重新建一遍人。"

8企业设置开箱

基础设置：企业名称与头像。
网络设置：配 IP 白名单网段，非白名单 IP 无法登录客户端。
计量设置：限量周期口径可切换（默认按订阅生效日切片 / 自然月每月 1 日 00:00 刷新）。 "可以限定只能公司内网或固定出口 IP 用 —— 员工把账号带回家也用不了。"

9开发与集成IT/集成商

组织架构同步：手动从 OneID 拉取人员与部门。
开放平台：提供开放 API + OAuth 2.0 授权框架，供第三方应用安全集成核心功能。 "你们有自己的 OA / ERP 想接进来也行，我们提供开放 API 和授权框架，不是黑盒。"

10日志管理合规

操作日志：操作、操作内容、操作端、操作人、IP、时间六要素留痕。
对话日志：可查看，并且记录开关可控 —— 合规场景需要"能不记录"，也支持需要审计时开启。 "谁在什么时候、用哪台电脑、做了什么操作，全有记录；对话要不要留痕，你们自己开关。"

11订单管理采购

订单号、时间、生效时间、类型、产品、规格、数量、付费方式、状态、金额；可跳转腾讯云处理订单合同。 "采购流程走腾讯云，发票合同都是正规的，不是我们私账收钱。"

常见混淆点（技术岗和新销售最容易答错）

问题	正确答案
白名单和黑名单哪个优先？	黑名单优先。命中白名单只保留白名单内模型，若同时命中黑名单则再移除黑名单里的。
一个员工命中多条安全策略怎么办？	只有优先级数字最大的那一条整体生效，不是叠加。
「限定策略」和「屏蔽策略」有什么区别？	限定 = 排他，成员只能用你选的这几个 Skill，其他全部（含以后新增的）都禁用；屏蔽 = 只禁掉个别。
策略改完什么时候生效？	安全策略：重启客户端立即生效，否则约 10 分钟自动同步。助理渠道开关：即时生效，客户端约 5 分钟内同步。
普通员工能进后台吗？	不能。后台账号 = 管理员或已授权角色。
不同企业看到的菜单一样吗？	不一样。菜单随已开通产品模块与账号权限动态变化，这是正常的。

SOP-A 开通后 30 分钟初始化（交付必做）

企业设置 → 基础设置

填企业名称与头像。名称会出现在客户端和企业市场里，先填对，别用默认名。

企业设置 → 网络设置

确认是否需要配 IP 白名单网段。配了之后非白名单 IP 登不上客户端，务必先确认客户的办公网出口 IP，别一上来就把自己锁在外面。

企业设置 → 计量设置

跟客户确认限额周期口径：按订阅生效日切片（默认）还是自然月 1 日 00:00 刷新。这个决定了客户对账单的预期，必须提前对齐。

成员授权 → 组织架构

接 OneID 数据源（飞书 / 钉钉 / AD / LDAP / 企微 / Entra ID 共 7 种），同步部门与人员；需要 SSO 的配认证源（OIDC / CAS / OAuth 2.0 / SAML 2.0 / JWT）。

成员授权 → 角色管理

先把超级管理员之外的角色建好（如"IT 管理员""部门管理员"），按最小权限赋权，别全员超管。

订阅与用量 → 订阅管理

核对套餐版本、到期时间、席位总数；授权人员（全部 / 已授权 / 未授权三态）。没授权的成员登不上客户端。

客户端配置 → 助理渠道 / 自定义菜单

按客户习惯决定开了哪些渠道（如企微助理）；把公司要推的入口做成自定义菜单下发。

交付验收

让 1 名员工用真实账号登录客户端跑一个真实任务，跑通即验收。别忘了同时跑一遍管理员账号看用量是否开始记账。

SOP-B AI 资产下发（模型 / Skill / 专家 / 连接器）

先定基线，再做例外。默认不下发限制时，员工可用其全部模型。所以策略要"少白名单、多默认" —— 一开始只给必须收口的部门配白名单。
模型策略三步：①确认客户已采购/启用的模型 → ②给指定部门配白名单（例：给研发部配模型 A、B，则研发部只能见这两个）→ ③给实习生等角色配黑名单（禁用模型 A）。
成员自定义模型四档：允许所有用户 / 白名单模式 / 黑名单模式 / 禁止所有用户。默认谨慎：先"禁止所有用户"，验证后再放开。
Skill 下发：上传自研技能 → 分类管理（分类名客户端可见，写短写清楚）→ 配白/黑名单。只想禁个别用屏蔽策略；要"只能用这几个"才用限定策略（排他，慎用）。
专家下发：上传自研专家 → 分类 → 白/黑名单。
Playbook：给客户导入精选 Agent 范例，一键导入 manifest，快速让客户看到"用起来是什么样"。
Connector：优先用官方内置；自建走 MCP，认证优先选 API Key（MCP OAuth 2.1 要求 C 侧使用者在企业智能体有账号并注入 AccessToken，否则可能认证失败）。

实施经验：给客户做下发策略时，先只配 1 个部门试跑 3 天，再全量铺开。策略配错最典型的后果是"某个部门打开客户端发现模型不见了"，现场很难解释。

SOP-C 安全策略配置（四维度）

维度	默认行为	建议配置
文件读写范围	默认全盘可读，仅 WorkSpace 可写，其他路径不可写，凭据/配置等高危路径强制禁止	保持默认。确有需要（如要处理 D 盘项目文件）再按部门放宽
可执行命令	询问名单（需人工确认）+ 放行名单（直接执行）；WSL、wmic、sc、reg、schtasks 等系统级工具默认禁止	财务/行政等部门可进一步收紧；研发可适当放开
网络访问	默认收敛，支持一键禁网、域名/URL/IP 黑白名单、统一代理出站	数据敏感客户可禁外部网络，仅放行内部域名
内置运行时	决定是否开放内置运行时（Python / Node.js / Git 等工具链）	不用开发的岗位可关闭，减少暴露面

三条硬规则：① 企业策略是底线，员工只能比它更严，不能更松；② 一人命中多条策略，只生效优先级最高的那一条（不是合并）；③ 改完策略让员工重启客户端，否则要等约 10 分钟。

SOP-D 用量与成本管理（每月必做）

月初看订阅：剩余天数、席位三态。有临近到期或席位不足，提前提醒客户续费/扩容。
月中看用量：成员用量明细导出 → 找出"零用量席位"（买了不用）和"超量个人"（需要单独调限额）。
按部门/应用拆分：组织用量 + 应用用量，给客户算清"哪个部门 ROI 最高"，这是第二年续费最好的弹药。
加量包：固定额度快用完时提醒客户，避免月中服务中断。
明细交付：用量明细支持 RequestID 级别，客户 IT 要审计时直接导出给他。

SOP-E 日志与合规（客户要审计时）

操作日志：操作 / 操作内容 / 操作端 / 操作人 / IP / 时间六要素，满足"谁干了什么"的基本审计。
对话日志：先跟客户确认"要不要留痕"。合规要求"不留"的，关掉开关；要求"可追溯"的，开启并说明保留策略。
配套对外话术：WorkBuddy 已通过中国信通院「可信 AI—智能助理智能体」与云端 OpenClaw 基线能力评估（国内首批），并获 CCIA 智能体 PIA 二星+级标识（全国首批且唯一，智能体场景最高级）；支持麒麟 / 统信 UOS / 鸿蒙国产化适配与私有化部署。

为什么要给客户看后台？（先想清楚这个）

员工端演示解决的是"这东西真好用"；后台演示解决的是"我敢让全公司用"。
中小企业老板、学校校长、工厂厂长 —— 他们掏钱前最后一个顾虑永远不是"AI 聪不聪明"，而是"会不会出事、钱会不会失控、人走了资料带不带走"。后台就是回答这三个问题的。

对老板

讲钱和数据：用量明细到人、部门成本可拆、日志可追溯。

对 IT / 技术负责人

讲可控：模型黑白名单、Skill 下发、安全策略四维度、SSO 对接。

对行政 / HR

讲省事：组织架构自动同步、席位一键授权、离职转交。

5 分钟后台演示动线（照着走，别乱点）

先讲三件事：还剩多少天、买了多少席位、额度还剩多少。"老板打开后台第一眼看到的就是这三件事。"

成员授权 → 组织架构

说一句："你们现在用企业微信还是钉钉？组织架构直接同步，不用重新录一遍人。" 顺手指出"支持 7 种数据源 + SSO 单点登录"。

AI 资产管理 → 模型策略 / Skill 下发

这是 IT 最买账的一屏。讲："研发部只能用哪几个模型、财务部只开哪几个技能，都是这里配的。"

安全设置

讲四个维度：能读什么文件、能跑什么命令、能连什么网络、运行时开不开。收一句："底线在企业这边，员工改不了。"

订阅与用量 → 成员用量明细

点开明细表，讲："谁用了多少、花在哪个模型上，一行一行都在，还能导出给财务。" 这一屏对老板杀伤力最大。

日志管理

讲操作日志六要素 + 对话日志开关可控。"要不要留痕，你们自己定。"

收口：回到组织概览，抛下一步

"后台我给您留个测试账号，您让 IT 和行政各看一遍。这周我们把您公司 3 个高频场景做出来跑一遍，您再决定要不要全公司开。"

时间不够时的压缩版（90 秒）：组织概览（三件事）→ 安全设置（四维度）→ 用量明细（一屏）→ 收口约下一步。这三屏足以让 80% 的老板点头。

每个模块"对客户一句话"（背下来，随取随用）

模块	对客户说
组织概览	"打开就能看到还剩多少天、几个人在用、额度够不够。"
企业智能体	"把最懂业务的那个人的经验做成一个数字员工，发下去全公司用同一套标准。"
AI 资产管理	"每个部门能用什么模型、什么技能，您说了算，不是员工自己乱下。"
客户端配置	"公司要用的几个入口，我们直接摆到员工桌面上，他不用找。"
安全设置	"能读什么、能跑什么、能连什么，管理员定底线，员工改不了。"
订阅与用量	"钱花在谁身上、哪个部门，后台一行一行都能查，还能导出给财务。"
成员授权	"你们用企微还是钉钉？组织架构直接同步过来，不用重建。"
企业设置	"可以限定只能公司网络用，账号带回家也登不上。"
开发与集成	"有自己的 OA / ERP 想接进来，我们有开放 API 和授权框架。"
日志管理	"谁在什么时候做了什么，全有记录；对话要不要留痕您自己开关。"
订单管理	"采购走腾讯云，合同发票都正规。"

客户看完后台最常问的 8 个问题

Q1：员工会不会拿它干私活、或者把公司资料传出去？

两道闸：网络访问可配黑白名单甚至一键禁网，数据外发有出口检测拦截；再加上操作日志六要素留痕、敏感信息在企业本地脱敏（明文不进模型上下文）。可以直说："能读到什么、能发到哪儿，是管理员配的。"

Q2：怎么防止费用失控？

成员用量支持单个/批量调限额并按周期设限；组织用量 / 应用用量按部门和应用分摊；加量包余额实时可见；用量明细细到 RequestID。等于给每个人设了额度卡。

Q3：员工离职了，他做的 Agent 和资料怎么办？

企业智能体、Skill、专家、知识资产都挂在企业账号下，不是个人账号；成员授权由管理员统一管理，席位可回收转授。腾讯文档 / 网盘侧也提供离职成员文档与文件转交能力。

Q4：能不能只用我们自己的大模型？

可以。模型管理支持新增自定义大模型接入，并用白名单把指定模型限定给指定部门；配合成员自定义模型四档策略管控。

Q5：合规审计要资料，能出什么？

操作日志（操作/内容/端/人/IP/时间六要素）+ 对话日志（开关可控）+ 用量明细导出。另可提供中国信通院评估、CCIA PIA 二星+标识等认证材料，以及数据不留存、不用于训练的合规承诺协议。

Q6：我们数据特别敏感，能不出内网吗？

三种交付形态可选：SaaS（多租户逻辑隔离）→ VPC 专有云（独享 VPC，数据不出内网）→ 私有化（部署在客户自有 IDC，完全内网隔离），并支持国产化全栈适配（麒麟 / 统信 UOS / 鸿蒙）。

Q7：要不要 IT 天天维护？

不需要。组织架构同步、SSO、席位授权是一次性配置；后续日常只有两件事：月初看用量、有新人来得授权。云端的数字员工运行在托管底座上，不用客户自己运维。

Q8：这后台看着挺复杂，我们没人会弄啊。

这正是我们陪跑服务的内容：开通初始化、组织同步、资产下发、安全策略、第一次员工培训，我们上门（或远程）一起做完，并留一份贵司专属的后台操作手册。

产品价值演示（能力层）

这条讲的是"WorkBuddy 能替公司干什么"，适合放在面谈开头，先把价值讲透。

▶ WorkBuddy 企业版 · 价值演示（约 2 分 20 秒）

内容：一句话出方案 / 数据汇总 / 7×24 自动化 / 知识库 / 安全生态 / 落地服务六大能力场景，晓晓语音解说，结尾含联系方式。

管理后台实操讲解（真实界面版）

正在制作中
本视频将全程使用 WorkBuddy 企业版真实管理后台界面（www.workbuddy.cn/admin/overview）逐屏讲解：
登录 → 组织概览 → 成员授权 → AI 资产管理 → 安全设置 → 订阅与用量 → 日志管理 → 订单管理。
（旧版《管理后台演示》为示意界面，与实际产品不一致，已不再作为讲解主素材使用。）

演示纪律：给客户讲后台时，必须用真实后台、真实数据（或已脱敏的真实数据）。用过时的示意界面讲，客户一旦发现对不上，整场信任就崩了。

后台演示五条铁律

只演示真实后台。不做自制示意图冒充产品界面。不确定的地方宁可不点，也不要"我猜这里应该是……"。
不承诺菜单里没有的功能。客户问"能不能 XX"，不确定就记下来当天回复，不要当场答应。
不用模拟数据当真实案例。要说"这是演示账号的示例数据"，或者提前把客户的真实数据脱敏后放进去。
报价口径统一。SaaS 198 元/人/月、VPC 316 元/人/月、私有化 License 按年订阅；Managed Agents 另有计费（Runtime 0.8 元/活跃小时 + 100 元/2000 Credit）。给折扣、给优惠必须走公司审批，现场不拍板。
不在客户后台做危险操作。演示账号只读为主；改策略、改授权这类动作，讲清楚"这里可以改"，但不要真的在客户生产环境点下去。

新销售最容易犯的 4 个后台演示错误

错误	后果	正确做法
一上来就点"企业智能体"讲 Agent 构建	客户（尤其老板）听不懂，觉得是技术玩具	从"组织概览"讲三件事开始，最后才到 Agent
把员工端和后台混着讲	客户分不清"我的人用哪个"	先明确两个入口：员工端干活、后台管控
只讲功能不讲钱	老板没感觉，因为没算成本	必讲"用量明细 + 部门分摊 + 限额"
讲完后台就走了	没有下一步动作，线索凉掉	必带收口动作：留测试账号 / 约场景共创

配套资料

📗 销售上岗培训手册

含「企业版后台必会」与「分行业演示」两个模块，新人 3 天路径必学。

🎯 分行业演示作战手册

幼儿园 / 学校 / 教育局 / 酒店 / 工厂 / 装修 / 教培 / 医美八个行业，各行业演示场景与逐步操作指引。

📙 陪跑专业详版

产品六大价值、版本报价、安全合规、15 则案例、省积分选型、异议应对。

📝 销售上岗考核包

笔试 40 + 话术演练 40 + 情景模拟 20，含评分表与分级标准。

这一页是什么 / 怎么用

这一页是把官方那份 《WorkBuddy 企业版后台使用说明》（约 3.2 万字）按"技术要会做、销售要会说"重新编排的浓缩版。
左边是操作路径（技术岗照着做），右边是对客户一句话（销售岗照着讲）。
原文全文已存档，可在「知识库检索」里搜任意关键词直接跳到官方原句 —— 需要引用原文时用它。

技术岗

按 ①→⑥ 顺序读一遍，重点记住：Agent 的五个概念、SSO 四步/五步、模型六字段、知识库三参数、Skill 双策略、日志六字段。带客户开通时照着做。

销售岗

只需读每个小节的浅绿底色那句"对客户这么说"，以及最后的「客户最爱追问的 8 个后台问题」。别背配置字段。

① 企业智能体：Agent 的全生命周期（后台核心）

这是企业版后台最核心、也是技术含量最高的一块。客户问"你们的企业智能体到底是什么"，答案就在这四个概念里。

概念	是什么	关键点
Agent	一个 AI 助手的完整配置：用什么模型、什么角色（System Prompt）、有哪些技能和工具	企业账号下的资产，不是个人资产
Runtime	Agent 真正跑起来的云端沙箱环境（完整 Linux 文件系统 + 终端）	每个 Runtime 含 Manifest 配置 + 1 个或多个 Session
Session	一个用户与 Agent 的完整会话（独立对话历史 + 独立文件）	超 10 分钟无访问自动休眠，再访问自动唤醒
Manifest	Agent 的声明式配置（JSON），定义身份、能力、工作空间、运行环境	可在后台直接编辑

创建一个 Agent（5 步）

登录分配了企业坐席的个人账号 → 右上角进入企业智能体 → 新建 Agent。
基础配置：填 Agent 名称、选模型（Auto 自动选，或选模型管理里的内置模型）、写 System Prompt（角色/行为规范/约束）。
配置技能 / 专家 / MCP：挂技能包、绑专家、填 MCP Server。这些会自动同步进 Manifest。
高级配置：记忆（跨轮次记住重要信息）、知识库（关联官方库和企业自建库，走 RAG 检索）。
右上角发布完成；左侧对话框切 Test Run 可先用当前配置测效果。

Manifest 配置项（技术岗要认得的字段）

分组	字段	说明
基础	id / name / manifestVersion	三个必填。manifestVersion 当前为 1.0
	system_prompt	系统提示词（与 system_prompt_file 互斥）
	system_prompt_file	提示词文件 URL
能力	rules / skills / plugins	规则文件、预定义技能（pdf、xlsx 等）、扩展插件
	mcp	MCP 服务配置
	subagents	可调用的子 Agent
	workspaces[]	name（必填，映射 /workspace/<name>/）、repository、downloadUrl、ref、initShellCommand、initCommand
	secrets / envs	敏感信息走安全通道注入（不写进沙箱文件）；环境变量写入 manifest

对客户这么说："企业智能体不是给您一个聊天框，是给您一套能被管理、能回滚、能评测的 AI 员工：谁在跑、跑了几轮、花了多少，后台都看得到。"

接入 / 版本 / 运行 / 评测

接入（两种方式）

① 接入链接：分享给团队成员，每人打开自动获得一个独立 Session；
② API 集成：用企业 API Key 调用，把 Agent 能力接进企业自有系统。

版本管理

在 Agent 的"版本发布"里查看与编辑版本历史，可回滚。Checkpoint / Version 支持随时回到历史状态。

Runtime 三态（排障用）

运行中=沙箱活跃；休眠=空闲超时自动暂停（再访问自动唤醒）；失败=创建或启动异常。
Runtime 没有关联 Session，通常是 Session 已删但沙箱未回收，建议及时清理。

凭据管理

凭据加密存储，仅在 Agent 运行时由代理层解密并注入请求头。Agent 调 MCP / Skill / 外部 API 时自动注入，配置里不用写明文密钥。

Session 列表看什么

调用方字段区分来源：用户=通过分享链接创建；API Key=通过开放平台 API 创建。
删除 Session 会永久清除对话记录和文件。

Agent 评测

选 Agent + 评测数据集 → 自动逐条跑测试用例 → 按指定评分方式算分，量化 Agent 能力。
启动评测会消耗个人积分。

② 管理员与身份：谁能进后台

左侧导航 成员授权 → 管理员角色 → 添加管理员，选成员确认即可（没有可选成员，说明还没加成员）。
添加成功后，该成员具备企业后台管理的所有权限；创建人不能被移除。
旗舰版要看这一条：旗舰版已接入腾讯统一身份做成员管理。除了 CodeBuddy 管理员，还要在账号超级管理员和 CodeBuddy 管理员两个角色下分别添加成员 —— 两个都要加，加不全 → 企业通讯录管不完整。
专享版未接入腾讯统一身份，只加 CodeBuddy 管理员即可获得全部权限。
管理员登录后台的方式和登录客户端一致（如微信登录 → 手机号登录）。

对客户这么说："后台权限和员工账号是分开的。老板给谁开管理员、开完还能不能收回，都在您手上，创建人账号本身也动不了。"

③ 单点登录：企业微信 / 飞书怎么接（技术必会）

客户 100% 会问"能不能用我们自己的账号登录"。答案是能，路径在 企业设置 → 登录认证 → 添加认证源。下面是官方给的完整步骤，交付时照着做。

企业微信 SSO（4 步）

创建企业自建应用

在企业微信管理后台 → 应用管理 → 自建应用，填表创建。

配置自建应用权限（三项，缺一不可）

根据企微"企业自建应用安全性升级公告"，必须完成：① 可信域名 ② 企业可信 IP ③ 网页应用授权回调，否则无法正常登录。
可信域名填企业自有域名，备案主体需与企微主体相同或有关联关系；可信 IP：旗舰版暂不支持，专享版/企业版需联系技术人员获取。

配置认证源信息

管理端 → 企业设置 > 登录认证 → 添加认证源 → 企业微信。把企微企业 ID、自建应用 Agent ID、Secret 填入，并复制回调地址，填回企微自建应用的企业微信授权登录处（Web 网页 → 回调链接，只需填企业域名）。
关联规则建议：开启"每次登录成功时更新用户信息"；未匹配时开启"新建用户"（选"拒绝登录"会导致首次登录失败）。
认证源必须选"企业专属认证账号"，仅新建企业支持，选择后无法更改。

启用认证源登录

后台 成员授权 → 成员与部门 → 前往"腾讯统一身份/通讯录" → 侧边栏 登录 → 认证源 → 打开企微（不需要的其它认证源关掉，只留企微）。
之后企业用户即可选企微登录方式 SSO 登录。

飞书 SSO（5 步）

与企业微信基本同构，差别在两处：权限清单和可用范围。

飞书权限	必要性
获取用户基本信息 contact:user.base:readonly	必要（缺了影响正常使用）
获取用户 user ID contact:user.employee_id:readonly	必要
获取用户邮箱 contact:user.email:readonly	建议（缺了无法同步邮箱）
获取用户手机号 contact:user.phone:readonly	建议（缺了无法同步手机号）

①创建自建应用：飞书开放平台创建企业自建应用。
②配权限：按上表在"权限管理 → API 权限"搜索并开通，权限缺失会导致服务无法正常使用。
③配可用范围：飞书自建应用有可用范围限制，只有范围内成员能 SSO 登录。版本管理与发布 → 创建版本 → 编辑"可用范围"（全部成员 / 部分成员）。
④配认证源：填入 App ID、App Secret，复制回调地址填到飞书"安全设置 → 重定向 URL"。
⑤启用：同企微第 4 步，在认证源里打开飞书。

对客户这么说："员工不用记新密码 —— 您用企微还是飞书，我们用您现有的账号体系登进来，组织架构也能直接同步，人员变动自动跟着变。"

④ AI 资源管理：模型 / 知识库 / Playbook / Skill / 专家 / 指令 / 连接器

这一组是"企业版和员工版最本质的区别"—— 员工版有什么用什么，企业版是您决定谁能用什么。七个模块统一在左侧 AI 资源管理 下。

4.1 模型管理：企业级模型治理

路径：AI 资源管理 → 模型管理。列表含内置官方模型 + 企业自定义模型。

配置项	必填	说明
模型名称 / 模型 ID	是	显示名；模型 ID 要查提供商的 API 文档
鉴权方式	是	API Key（单一令牌，随请求明文传输）或 AK/SK（密钥对请求签名，服务端验签放行）
模型部署地址	是	提供商的 API 基础地址（base_url）
API Key / Secret ID+Key	条件	按鉴权方式二选一

填完点测试验证连通 → 通过后 保存并启用，成员即可在客户端切到该模型。
列表操作：启用/关闭、编辑（改配置或可见范围）、删除。内置官方模型不支持启用/关闭和删除，编辑时只能调"权限配置 → 可见范围"。
成员自定义模型策略（四档）：允许所有用户（默认）/ 白名单模式 / 黑名单模式 / 禁止所有用户。策略变更立即生效，影响所有成员。
合规提示（要如实告知客户）：自定义模型的费用由客户直接付给第三方；输入内容直达第三方模型，WorkBuddy 仅作通信链路，处理规则按客户与第三方的协议执行。

对客户这么说："您自己的模型也能接进来（比如买的混元），后台配一次，全公司都能用；同时谁能自己加模型、谁不能，也是一个开关的事。"

4.2 知识库：两种库 + 三个参数

官方知识库

平台预置，按需启用/禁用。现含：Spring Boot / Spring AI / React / Vue / LeaferJS / LangChain / 腾讯云 API / 微信云开发 / 云原生构建 CNB / Unreal Engine 4.5 等。启用后自动纳入 RAG 检索上下文。

自定义知识库

企业自己的文档与代码资产。支持 .md / .docx / .pdf / 代码文件（单文件 ≤30MB）与 .zip / .tar / .tgz / .tar.gz / .gz 压缩包（≤300MB），也支持 GitHub/GitLab 仓库导出包。
编码仅支持 UTF-8 或 GBK。

新建自定义知识库（4 步）

基础配置：名称（≤20 英文 / ≤10 中文）、描述（≤30 / ≤15）、可见范围（默认全部成员，可指定部分）。
上传文件：拖拽或点选。压缩包由后端自动解压并索引，列表会显示每条的索引状态。
配置检索参数：Top K 返回相似度最高的片段数（推荐 3~5）；Score Threshold 相关性阈值（推荐 0~0.5）。Top K 越小越精确；阈值越低召回越多、越高精度越高。
启用：状态为「索引中 / 索引失败」不可启用，变为「已完成」后默认已启用。索引失败先查文件编码或格式。

员工怎么用：企业账号登录客户端 → 对话框输入 @ 选 Docs → 打开知识库列表 → 点击引用即可。原理是"用户提问 → RAG 检索 → 上下文增强 → LLM 生成回答"。

客户三个常见疑问的标准答案：①回答没引用知识库 → 检查知识库是否启用、文件是否"已完成"索引、是否在对话里 @ 引用了；②索引失败 → 检查文件编码（UTF-8/GBK）与格式；③检索不准 → 调 Top K 与 Score Threshold，或把文档切分得更清晰。

4.3 Playbook：预配置工作流模板

路径：AI 资源管理 → Playbooks。面向"想用 AI 干活但不懂提示词"的人（产品经理、设计师等）。一个 Playbook 包含：名称 / 模型 / Agent ID / System Prompt。

点开某个 Playbook → 查看 Manifest 摘要、场景说明、工作流设计、SDK 调用范例。
点 使用此 Playbook 创建 Agent → 进入新建 Agent 页面，System Prompt 自动注入、指定的 MCP 自动激活、定义的 Skill 自动加载。

4.4 Skill 管理：统一分发 + 双层策略

内置 Skill 当前 301 个（成员直接用）；企业也可上传自定义 Skill（.zip）统一下发。

策略维度	控制什么	典型场景
Skill 下发策略	成员能使用哪些 Skill	只允许研发团队用代码审查 Skill
成员自定义 Skill	成员能否自行上传 Skill	开放或限制成员创建个人 Skill

优先级：黑名单 > 白名单 > 默认允许；"下发策略"与"客户端上传策略"相互独立。上传 3 步：填基本信息（标识/显示名/分类必填）→ 配置分类 → 设下发策略（保存即时生效）。

4.5 专家管理

专家来源两种：企业自建（管理员上传维护）+ 内置市场（平台预置，开箱即用）。上传企业专家需填基本信息和专家包，并配置权限范围；下发策略同样是白名单 / 黑名单，黑名单优先于白名单（被拉黑的人无法通过白名单获得权限）。后台还支持"权限查询"：快速查某成员对某专家的最终访问权限。

4.6 自定义指令

管理员为团队定义可复用的标准化提示词模板，成员在客户端输入 / 即可调用。每条指令含：指令名称、指令描述、提示词描述（核心 Prompt）、上下文配置（可选：关联知识库 / 引用文件）。
注意：全局提示词已不再对客户端生效，官方建议改用客户端的"规则"功能。

4.7 Connector 管理：接外部系统

让 Agent 能读写 GitHub、Figma、腾讯文档等平台数据。内置官方连接器（GitHub / Notion / Supabase 等），也支持自建。创建三步：

填基础信息

标识（仅英文/数字/中划线/下划线，创建后不可改，系统自动加 enterprise_ 前缀）、显示名称、描述、首页 URL。

配认证与凭证（三选一）

MCP OAuth 2.1：只需在第三步填 MCP Server URL，凭据走标准 OAuth 自动建立；
OAuth 2.0 授权码：填 Client ID / Secret / Authorization URL / Token URL / Scopes / User Info Endpoint（回调地址要填进第三方的回调白名单）；
API Key：只填 Header Name（默认 X-API-Key）。

配 MCP 服务端

填第三方 API 的 MCP 接入地址（如 https://docs.qq.com/openapi/mcp），系统自动生成 Gateway 与 MCP 配置 → 保存。新连接器状态为待启用。

对客户这么说："这不是又一个 App，是让 AI 能真的动您系统里的数据 —— 填一次 URL，全公司成员不用各自配密钥。想要只读还是能写，权限在您手里。"

⑤ 安全与合规：客户签字前的最后一公里

5.1 IP 白名单

路径：企业设置 → 网络设置。生效于客户端插件，被限制的 IP 无法登录插件。规则要一字不差地记：

填法	效果
多个 IP 用英文逗号隔开（逗号前后不加空格）	允许这些 IP 访问
只填 127.0.0.1	等于禁止所有 IP 访问
不填	允许所有 IP 访问
填网段如 10.10.10.0/24	允许该网段访问

5.2 日志管理：可查看、可追溯

管理员登录企业后台即可查。支持日期快捷筛选（昨日/今日/本周/本月/近 7 天/近 30 天）+ 手动选日期，支持按操作内容模糊搜索，支持导出。

字段	内容
操作	后台登录、插件登录、网页对话登录、邀请成员、审批成员、添加成员等（可筛选可搜索）
操作内容	具体做了什么，如"导出数据""登录企业后台"
操作端	企业管理后台 / IDE 插件 / 网页对话 / API
操作人	企业内所有成员，含已删除成员
IP 地址	操作时的 IP
操作时间	时间戳，精确到秒；最新在前

5.3 研效度量：把"提效"变成数字给老板看

研效看板：适合度量企业整体。含活跃情况（活跃/补全活跃/对话活跃用户数）、对话指标（对话次数、指令次数、智能体次数、知识库次数、代码段操作次数）、补全指标（按次/按行/按字符三种口径，可按语言分析）。支持指标视图与趋势视图切换、时间维度筛选与数据导出。
成员数据：看每个人的数据，支持按姓名或 ID 筛选，一键导出 Excel。
核心指标"补全生成率"：按行 =（补全采纳行数 ÷ 总新增行数）×100%；按字符同理。20% 即每 100 行代码有 20 行由 AI 生成 —— 这是衡量投产比的那句话。
统计口径要注意：复制或导入超过 5 行属"大幅度键入"，不计入总新增；删除的代码也不倒扣。研效数据同步需 15 分钟。

对客户这么说："上线三个月后我能给您一张表：多少人真在用、AI 生成了多少代码、每个部门花了多少额度。这个数字能直接拿去汇报。"

⑥ 基础设置：对外露出的品牌都是您自己的

旗舰版能改

企业名称、企业头像。改完对所有成员生效，Web 端管理后台与插件端（如 VS Code）都会跟着变。

专享版 / 企业版额外能改

企业简称、英文简称、企业二维码；产品定制化（产品名称、产品英文名、产品图标）；以及插件打包下载。

企业简称 / 英文简称必填：长度 1~50，官方建议 5 个字符以内。
企业头像 / 二维码 / 产品图标：建议 640×640、≤1MB，视觉元素保持在矩形区域内（产品图标只允许 png）。
企业域名只支持修改一次，改前要慎重。
插件打包：产品名称、产品英文名、企业简称、企业英文简称任一发生变更后，需重新打包，才能下载 VS Code 插件 / JetBrains IDEs 插件。
信息更新后各端展示：插件端（登录界面 + 底部 icon 菜单）、Web 端（管理后台 + 登录页 + WebChat）。

对客户这么说："员工打开看到的是您公司的名字、您公司的 Logo，装的是您自己打包的插件 —— 对外它就是您公司的 AI 平台。"

客户最爱追问的 8 个后台问题（标准答法）

1. 员工上传到 AI 里的资料，人走了能带走吗？

带不走。Agent、Skill、专家、知识库都挂在企业账号下，不是个人账号；席位管理员可回收并转授他人。

2. 能不能限制员工只能访问公司内网？

两个层面：安全设置四维度限制客户端能连什么网络；企业设置 → 网络设置 → IP 白名单限制哪些 IP 能登录插件（不填=允许所有）。

3. 不同部门能不能给不同的模型和技能？

能。模型、Skill、专家都支持可见范围 + 白名单/黑名单策略；同一对象同时命中时，黑名单优先。

4. 员工自己乱装技能怎么办？

后台有"成员自定义 Skill / 自定义模型"策略，四档可选（允许所有 / 白名单 / 黑名单 / 禁止所有），改完立即生效。

5. 能出审计报告吗？

能。日志管理含操作 / 操作内容 / 操作端 / 操作人 / IP / 时间六个字段，可按时间与内容筛选并导出；研效度量也能导出 Excel 给财务。

6. 我们自己的模型能接吗？谁付费？

能接，走模型管理 → 新增自定义模型（API Key 或 AK/SK 鉴权）。费用由客户直接付给模型提供方，WorkBuddy 只做通信链路。

7. 能不能让 AI 直接查我们内部文档？

能。把文档打包成 自定义知识库（单文件 ≤30MB / 压缩包 ≤300MB，UTF-8 或 GBK），员工在对话里 @ Docs 引用即可。

8. AI 能不能直接操作我们的系统和数据？

能，走 Connector 管理接第三方 MCP 服务（GitHub / 文档 / 内部 API 都行）。管理员配置一次全组织可用，认证方式支持 MCP OAuth 2.1、OAuth 2.0、API Key 三种。

配套：原文与检索

上面所有内容都来自官方文档原文。需要引用原句、或查更细的字段说明时，用「知识库检索」页 —— 输入关键词，点结果直接跳到官方原文那一段。

📚 知识库检索（推荐）

8 篇官方文档全文检索，点结果即跳转并高亮。
打开检索页 →　模型选型指南 →

🔗 官方分享页原文

workbuddy.link 的原始分享页（含截图与图示）。
打开原文 →

知识库检索：搜一句，直接落到官方原文那一段

官方分享页里其实藏着 8 篇文档、约 15.5 万字（后台说明 · 白皮书 · 从入门到精通 · 企业版入门 · 模型选型指南 · 三个实战案例）。这一页把它们做成可检索、可点击直达的工具：
输入关键词 → 出结果列表 → 点一下自动跳到原文那一段并高亮，不用在长页面里翻。

📚 打开检索页

进入知识库检索 →
左栏点目录直达章节；顶部搜索或点「常见问题」直接落到答案原文。

收进的 8 篇

企业版后台使用说明 · 模型选型指南 · 产品白皮书与案例 · 从入门到精通 · 企业版入门 · 学校场景 · 家庭教育专家 · 客服 4 步法

用法三条：① 左侧「目录」点标题 → 直接滚到那一节；② 顶部搜关键词 → 点结果 → 自动切文档并高亮该段；③ 「常见问题」里的词点一下就到答案，例如"企微怎么登录""知识库传什么文件""该给客户配哪个模型"。