首页/ 使用指南

使用指南
快速上手深维陪练

三种开练方式,按需选择一种即可。个人推荐直接使用网页版;想在自己的 AI 或 Agent 中使用,再查看 Skill 与 MCP 接入。

v1.6.0 GUIDE 更新:2026-10-22 预计阅读 5 min
01 · QUICKSTART

快速开始:三种接入方式

按使用习惯选择一种方式即可,日常训练建议从网页版开始。

推荐

A网页版直接练

打开训练平台注册登录,无需任何配置。

coach.megaview.com →

B装开源 Skills

一条命令把技能装进你的 AI 工具,建课、出题、推荐、诊断即说即用。

查看安装方式 ↓

CMCP 接入 Agent

把陪练引擎作为 MCP Server 挂进你自己的 Agent 工作流,适合自动化与批量训练。

MCP 接入说明 →
02 · SKILL INSTALL

安装 Skills

技能开源在 github.com/omnimay/coach_skills。每个技能是独立的 SKILL.md 文件夹,兼容任何支持 Agent Skills 的 AI 工具;安装后 AI 会在匹配场景自动加载对应技能,无需手动编写 prompt。

方式一:Skills CLI 一键安装(推荐)

terminal
npx skills add omnimay/coach_skills

CLI 会从 GitHub 拉取仓库并把技能装进你的工具技能目录,提示时选择全部或仅需要的技能。前置要求:Node.js ≥ 22.20.0(含 npx)。技能需手动更新,按技能名执行:

terminal
npx skills update ai-customer-design flashcard-design recommend-courses coach-mcp-connect

更新后,宿主工具下次会话自动加载新版本。

方式二:手动安装

terminal
git clone https://github.com/omnimay/coach_skills.git

把需要的 skills/<name>/ 文件夹复制到你的工具技能目录即可。脚本功能(文档上传、二维码渲染、MCP 连接诊断)需要 Python 3.10+。

包含的 4 个技能

技能功能
ai-customer-design创建/修改 AI 客户对练课程、上传资料、生成练习链接
flashcard-design对话式创建/编辑学习闪卡,支持文档出题与验题
recommend-courses从分析报告提取学员短板,自动匹配或创建课程并批量下发任务
coach-mcp-connectMCP 连接诊断与恢复,连接问题自助排查
i未连接 MCP 时技能会降级运行(无错误、不阻塞),但课程创建、任务下发等能力不可用——要解锁完整能力,继续看 MCP 接入。
03 · MCP INTEGRATION

MCP 接入

MCP 服务「深维智讯・销售陪练」把课程创建、资料上传、任务下发等陪练能力以标准 MCP 工具开放,适合接入企业 AI 工作台或自动化业务流程。第 2 节安装的技能默认通过它调用这些能力。

  • 服务协议:MCP over Streamable HTTP;服务器名 enterprise-training。生产地址 https://mcp.omnimay.com/coach/mcp,以管理后台「MCP 管理」显示为准。
  • 鉴权方式:优先 OAuth 浏览器授权,token 由宿主连接器管理;也可使用组织机器人 API Key(sk_mcp_...,需具备课程管理权限)。
  • 核心能力:创建 AI 客户课程与学习闪卡、上传参考资料、多轮 AI 改课(异步任务)、生成练习链接、下发培训任务、查询课程与学员数据。
  • 已接入客户端:Workbuddy(连接器要求客户端 ≥ 4.24.0)与千问办公。Workbuddy 审核上线后可直接在连接器市场搜索安装,授权由客户端账号体系完成。

准备组织 Key(备选鉴权)

  1. 进入 AI 陪练管理后台,打开「MCP 管理」。
  2. 确认 MCP 服务已启用,并复制当前环境的服务地址。
  3. 创建机器人,授予课程管理权限,签发并复制有效 Key。

配置连接

支持 MCP 的客户端在连接器配置里添加服务即可,mcp.json 示例(Streamable HTTP):

mcp.json
{
  "mcpServers": {
    "enterprise-training": {
      "type": "streamableHttp",
      "url": "https://mcp.omnimay.com/coach/mcp"
    }
  }
}

优先在连接器页完成 OAuth 授权;OAuth 不可用时改用组织 Key,安装/配置时对 Agent 明确说明:

install-prompt.txt
请为本智能体配置该 MCP 服务,优先走 OAuth 授权;
OAuth 不可用时直接用下面的 Key 连接,不要走 OAuth:
sk_mcp_xxxxxxxx

核心工具

工具用途
training.ai_customer.create 等AI 客户对练课:create 创建课程、update 多轮改课(异步任务)、update_status 轮询进度、get 读取配置。建课完成以 get 返回 create_status_created 且 stages 非空为准
training.flashcard.create 等学习闪卡:创建(管理员/学员权限自动路由)、对话式改题、轮询、验题
training.file.upload_document / training.file.status上传参考资料与轮询解析状态;上传经技能包内 upload_document.py 脚本完成
training.task.create_open_project生成练习链接,或向指定学员批量下发培训任务
training.course.list / .label_list / .label_batch_create课程查询与标签管理(按标签匹配课程、给新课打标)
training.organization.tree / organization.user.batch_resolve组织成员树找人、批量工号解析

其他工具和参数以客户端 tools/list 返回的 schema 为准。update / update_status 提交成功后不要重复发送,超时或结果不确定时先用 get 读课程配置确认状态。

文档读完,来一场实战

AI 客户已经就位,带着脾气和隐藏顾虑等你开口。

▶ 免费开练 查看 Skill 接入