CloudCareEE IT服务管理
更新日志
产品简介
基础概念
账号体系
注册登录
密码重置
用户名找回
工作空间
基础信息
功能模块
首页看板
系统管理
账号管理
角色管理
配置管理
多云账号管理
公有云账号
观测云工作空间
观测云云巡检
CloudLinker账号
资产管理
资产组
资产同步
资产分类
资产成员
项目管理
项目计划
项目列表
项目成员
情报管理
情报概览
情报团队
情报策略（已废弃）
调度规则
情报汇总
情报设置
报告管理
报告列表
报告版本
定期报告
报告成员
流程审批
流程列表
流程模板
流程成员
云上甄选
账户概览
账单详情
发票管理
知识库
知识库列表
知识库成员
回收站
OKR管理
目标概览
目标管理
目标对齐
周期管理
OKR成员
AI Hub
快速上手
概览
模型列表
API 密钥
调用记录
账户流水
账单管理
AI Hub成员
CloudCare助手
常见问题
H5微应用
钉钉群添加H5酷应用
飞书群H5卡片鉴权
钉钉消息卡片
钉钉消息卡片显示异常
报告说明
DMS运维报告
报告附加内容
阿里云资产全览报告（word）
配置文档
SSO单点登录配置
模型 API Key 配置
Workbuddy（腾讯）
CodeBuddy（腾讯）
TRAE Work（字节跳动）
TRAE SOLO（字节跳动）
LobsterAI（网易有道）
Dify 配置
-
+
首页
Workbuddy（腾讯）
# CloudCare Enterprise AI Hub 接入 WorkBuddy 使用指南 ## 一、产品介绍 ### 1.1 WorkBuddy 简介 **WorkBuddy** 是面向个人办公与通用任务的桌面 AI Agent 工具，可通过对话协助处理内容创作、信息整理和本地工作流任务。本指南使用其“自定义 / Custom”模型入口，将 CloudCare Enterprise AI Hub 的 OpenAI 兼容接口配置为本地模型；API Key 只保存在使用者本机的模型配置中。 ### 1.2 AI Hub 接入能力 CloudCare Enterprise 的 **AI Hub** 为本地 AI 工具提供统一的 OpenAI 兼容接入。用户在 AI Hub 中创建 API Key，复制请求地址与 Key，并从模型列表取得调用用的 `model_name` 后，即可配置到支持 OpenAI 兼容协议的客户端。 接入前请准备以下三项信息： 1. 请求地址（base URL） 2. API Key 3. 模型名称（`model_name`） > 请求地址应从 AI Hub 的“API 调用信息”直接复制。不要把某个环境的地址写死到团队模板中。 | AI Hub 模块 | 本指南中的用途 | | --- | --- | | 概览 | 查看个人或空间维度的请求次数、Token、费用与趋势。 | | 模型列表 | 选择可用模型；接入工具时填写列表返回的 `model_name`，而非仅使用展示名称。 | | API 密钥 | 创建、查看脱敏 Key、打开 API 调用信息并复制接入参数。 | | 调用记录 | 配置后核验请求是否进入 AI Hub；记录数据按产品设置周期刷新。 | | 成员 / 账户管理 | 空间管理员可设置成员月度 Token 或费用额度，并维护空间治理策略。 |  #### 接入安全要点 - 密钥列表与详情只展示脱敏值；完整 API Key 不会出现在列表或详情接口中。 - 完整 Key 仅该 Key 的创建者可从“API 调用信息”复制；请由创建者完成工具配置。 - AI Hub 的管理员、读写、只读角色拥有不同操作范围；完整 Key 的复制始终额外校验“是否为该 Key 创建者”。 ### 1.3 使用前权限与账号要求 接入 WorkBuddy 前，请确认当前账号已加入目标工作空间，并获授 AI Hub 角色。权限以 AI Hub 角色为主，同时受工作空间范围、成员状态和 Key 创建者限制。 | 角色 | 可完成的 AI Hub 操作 | 接入 WorkBuddy 时的含义 | | --- | --- | --- | | 系统超级管理员 / 系统管理员 | 作为 AI Hub 管理员的上层角色，在已授权工作空间内管理成员、空间配置和 Key。 | 可为成员授予 AI Hub 角色，并协助治理。完整 Key 仍只能由创建者复制。 | | 管理员（AI Hub） | 管理 AI Hub 成员、查看所有空间内 Key、创建 Key、启停 / 删除 Key、查看模型、统计、调用记录和钱包流水。 | 适合空间治理与成员开通；为降低密钥扩散风险，建议由实际使用人自行创建 Key。 | | 读写（AI Hub） | 创建 Key、修改自己创建 Key 的名称 / 备注 / 到期时间、启停自己创建 Key；查看模型、概览、调用记录和余额。 | 适合需要接入本地工具的普通使用成员；可复制自己创建的完整 Key。 | | 只读（AI Hub） | 查看 Key 的脱敏信息、模型、概览、调用记录、余额和日账单。 | 可核验模型与调用情况，但不能创建、修改、复制或删除 API Key。 | > **Key 复制的双重限制**：权限矩阵允许管理员和读写成员使用“复制 API Key”，但后端会继续校验创建者身份。仅该 Key 的创建者可以取得完整 Key；管理员查看其他成员的 Key 时只能看到脱敏值，不能代为复制。 #### 成员与范围限制 - AI Hub 管理员添加成员前，目标用户必须已是同一工作空间成员；AI Hub 角色还必须与工作空间角色兼容，否则系统会拒绝保存。 - 成员处于禁用状态时，不能创建或操作 API Key；系统会同时禁用该成员在该空间的 API Key。 - 空间级看板、成员管理、钱包流水和空间配置仅对 AI Hub 管理员开放；读写与只读成员可查看自己的使用情况及其有权访问的记录。 - 所有接入参数均以当前选择的工作空间为边界。跨空间切换时，请重新检查模型、Key、余额与成员权限。 --- ## 二、安装部署 ### 2.1 系统要求 | 客户端 | 操作系统 | 最低版本 | 说明 | | --- | --- | --- | --- | | WorkBuddy（macOS） | macOS | 12 及以上 | 按芯片选择 ARM64 或 X64 安装包。 | | WorkBuddy（Windows） | Windows | Windows 10 及以上 | 下载 `.exe` 安装包并按向导安装。 | ### 2.2 获取方式 WorkBuddy 是桌面 AI Agent 工具，支持在设置页以可视化方式添加 OpenAI 兼容的自定义模型。它将自定义模型配置（含 API Key）保存在本地 `workbuddy/models.json`，不会同步到云端。 | 项目 | 说明 | 下载 / 文档地址 | | --- | --- | --- | | 官方下载 | WorkBuddy 最新安装包 | [workbuddy.cn](https://www.workbuddy.cn/) | | Windows | Windows 10 及以上；下载 `.exe` 后按向导安装 | [Windows 安装说明](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide) | | macOS | macOS 12 及以上；按芯片选择 ARM64 或 X64 的 `.dmg` | [macOS 安装说明](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Mac-Guide) | ### 2.3 各平台安装步骤 1. 从上表的官方下载页获取与系统、芯片匹配的安装包。 2. Windows：双击 `.exe`，阅读并同意协议后，按安装向导完成安装。macOS：双击 `.dmg` 后将 WorkBuddy 拖入 Applications。 3. 启动 WorkBuddy 并完成登录；在左下角个人中心可检查更新。 > 请仅从官方页面下载。企业设备如有软件安装限制，请由终端管理员完成安装或授权。 ### 2.4 首次启动配置 1. 启动 WorkBuddy 并完成登录。 2. 在左下角个人中心检查客户端版本，按需要更新。 3. 完成下文的 AI Hub 自定义模型配置后，再在对话页选择该模型开始使用。 --- ## 三、模型配置 ### 3.1 获取 AI Hub 接入信息 以下步骤在 CloudCare Enterprise 的 AI Hub 模块中完成。请在安装 WorkBuddy 前先准备好接入参数。 #### 3.1.1 创建 API Key 1. 进入 **AI Hub > API 密钥**，点击右上角“创建密钥”。 2. 填写易识别的备注，例如“WorkBuddy-个人电脑”。可按需设置过期时间；未设置则不过期。 3. 点击“确认”创建。创建完成后，列表中仅显示脱敏 Key，请通过操作栏打开 API 调用信息。   #### 3.1.2 复制请求地址与 Key 1. 在该密钥所在行打开“API 调用信息”（操作栏的调用信息 / 复制入口）。 2. 确认协议类型为 **OpenAI**；复制“请求地址”和“API Key”，也可以使用“一键复制全部”。 3. 将 Key 直接粘贴进 WorkBuddy 的 API Key 字段。不要通过聊天、邮件、工单或截图传递完整 Key。  > 上图 API Key 已脱敏。若 Key 有泄露迹象，请立即在 AI Hub 禁用或删除旧 Key，再创建新 Key 并更新 WorkBuddy 配置。 #### 3.1.3 选择模型 1. 进入 **AI Hub > 模型列表**，按需要选择模型。 2. 记录“模型名称 / `model_name`”。这是 API 调用参数；展示名称仅用于阅读，不应替代模型名称。 3. 若希望使用工具调用、图片输入或推理等能力，先确认所选模型及客户端均支持，再按后文的可选推荐配置开启。 ### 3.2 添加 AI Hub 自定义模型 #### 3.2.1 配置步骤 WorkBuddy 的添加模型页面明确支持 OpenAI 兼容协议，适合对接 AI Hub。以下字段请以本次在 AI Hub 中复制到的实际值为准。 1. 在 WorkBuddy 左下角进入 **设置 > 模型**，点击“添加模型”。 2. 在“提供商”中选择“自定义 / Custom”。 3. 填写接口地址、API Key 与模型名称；接口地址使用 AI Hub API 调用信息中复制的请求地址，模型名称使用 AI Hub 模型列表中的 `model_name`。 4. 保持“自定义协议”关闭（默认）。在默认状态下 WorkBuddy 按标准 `/chat/completions` 路径校验并补全地址。 5. 保存后，回到对话页，在模型选择器中选择新添加的模型。   | WorkBuddy 字段 | 填写 AI Hub 信息 | 说明 | | --- | --- | --- | | 提供商 | 自定义 / Custom | 选择 OpenAI 兼容的自定义接入方式。 | | 接口地址 | AI Hub 请求地址 | 粘贴 API 调用信息中的 base URL；默认不勾选自定义协议。 | | API KEY | AI Hub API Key | 粘贴完整 Key，仅保存在本机配置文件中。 | | 模型名称 | AI Hub `model_name` | 必须是模型列表的调用名称，不是任意别名。 | > **何时开启“自定义协议”**：仅当企业网关明确提供了非标准完整请求路径、且需要 WorkBuddy 不做路径补全时才开启。常规 AI Hub 接入保持关闭。 --- ## 四、核心功能与推荐配置 ### 4.1 发起首次任务 在 WorkBuddy 对话页选择刚添加的 AI Hub 模型，使用不含敏感信息的简短任务验证连接，例如“用三句话概括当前文件”。首次调用成功后，即可按实际办公或协作任务继续使用。 ### 4.2 推荐配置（可选） | 设置项 | 推荐值 | 启用条件 | | --- | --- | --- | | 工具调用 | 默认关闭 | 确认所选 AI Hub 模型支持工具调用后，再开启。 | | 图片输入 | 默认关闭 | 仅在模型支持图片输入，且任务确实需要时开启。 | | 推理模式 | 默认关闭 | 仅在模型支持推理且接受更高时延 / Token 消耗时开启。 | | 输入 / 输出 Token | 使用提供商默认值 | 只有已知模型上下文与输出上限时再手动限制。 | ### 4.3 验证与调用观测 1. 在 WorkBuddy 选择刚添加的模型，发起一个无敏感数据的短任务，例如“用三句话概括当前文件”。 2. 回到 **AI Hub > 概览**，查看请求次数、Token 与费用是否变化；再到调用记录按时间、模型或成员确认调用。 3. 若请求失败，先检查 Key 是否仍启用且未过期、模型名称是否为 `model_name`、请求地址是否来自当前 AI Hub 环境。 > AI Hub 调用记录按产品设置周期更新；刚完成配置时，可先查看概览指标，再等待调用记录刷新。 ### 4.4 常见问题 | 现象 | 优先检查 | | --- | --- | | 模型下拉中没有新模型 | 确认已保存；返回对话页重新选择模型；检查模型名称与 AI Hub `model_name` 一致。 | | 鉴权失败 | 确保粘贴的是完整 API Key，而不是列表中的脱敏 Key；由创建者重新打开 API 调用信息复制。 | | 请求地址错误 | 从 AI Hub 重新复制当前环境请求地址；常规接入不要手动补路径，也不要开启自定义协议。 | | 消耗不符合预期 | 在 AI Hub 概览和调用记录按模型 / 成员分析；按需关闭图片、推理或工具调用。 | | 上下文长度参数错误 | 在 自定义模型配置中 设置模型输入输出上下文长度，输入推荐262144（256K）输出：65536（64K） | --- ## 附录：官方链接与依据 - [WorkBuddy 官方下载](https://www.workbuddy.cn/) - [WorkBuddy Windows 安装说明](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Win-Guide) - [WorkBuddy macOS 安装说明](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Installation-Mac-Guide) - [WorkBuddy 模型配置说明](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)
吴晓俊
2026年8月28日 15:48
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码