使用指南
面向开发者与 AI Agent 的技术文档

快速开始：三种接入方式

AI陪练 提供三种接入方式，按使用场景选择。都不需要写代码，复制粘贴即可。

通过 Skill 安装

方式一：自然语言提示词（给 AI 客户端）

在支持 Skill 的 AI 客户端对话里发送以下提示词：

读取 https://aipeilian.cn/install/skill.md
按文档完成 AI陪练 Skill 的安装，
安装完成后，用「客户砍价」场景陪我练一场。

Agent 会自动读取安装规范、完成参数校验与安装，全程无需手动操作。

方式二：CLI 命令（给开发者）

# 安装全部官方 Skill
npx skills add aipeilian/skills

# 只装某一个（例：客户砍价对练）
npx skills add aipeilian/skills --skill objection-arena

SKILL.md frontmatter 规范

自建对练场景需在 SKILL.md 头部声明以下字段：

场景与数据结构

四大内置运营场景开箱即用，定义在前端 SCENES 数组中。切换场景时，左侧 AI 客户视频、右侧对话面板与 Coach Tip 同步更新。

SCENES 数组字段

{
  "id": "previsit",
  "name": "拜访预演 · 客户砍价",
  "video": "assets/videos/customer-1.mp4",
  "tags": ["价格敏感", "握有竞品报价", "决策快"],
  "dialog": [
    { "role": "customer", "text": "你别讲虚的，隔壁便宜 15%。" },
    { "role": "you",      "text": "王总，您更看重交付快还是三年不折腾？" },
    { "role": "tip",      "text": "先接住情绪，再拉回价值锚点。" }
  ]
}

自定义场景：复制数组内任意对象，改 id / name / dialog 即可，前端自动注册到顶部横幅与场景切换。

素材规范

AI 客户的「会开口」效果来自真实视频素材，按以下约定放置即可被自动加载：

• 视频：assets/videos/customer-1.mp4 ~ customer-4.mp4，与场景顺序一一对应；muted + loop + playsinline 自动播放。
• 场景图：同目录下按内容哈希命名的 .jpg（如 0b7d2e04.jpg），用于「技能建课」模块的场景示意。
• 回退机制：视频缺失或加载失败时，自动切换为矢量说话人插画（含口型、眨眼与声波动画），页面不报错、布局不跳动。

MCP 接入

把陪练引擎装进你自己的 Agent：AI陪练 提供 MCP Server，暴露场景列表、对练会话与评分复盘三类工具，30+ 主流 Agent 客户端均可直连。

• 工具集：list_scenes（拉取可用场景）／start_session（开启一场对练）／submit_utterance（提交一句话并得到实时提示与评分）／get_review（获取逐句复盘报告）。
• 已支持的客户端：Workbuddy、千问办公、豆包工作、OmniMay 等。

{
  "mcpServers": {
    "aipeilian": {
      "command": "npx",
      "args": ["-y", "@aipeilian/mcp-server@latest"]
    }
  }
}

完整参数、鉴权与示例见 MCP 接入专页 →

AI Agent 读取入口

本页同时提供机器可读版本。让 Agent 直接读 Markdown 镜像，比解析网页更稳：

读取 https://aipeilian.cn/guide.md
按文档完成 AI陪练 Skill 的安装与场景配置，
然后用「异议处理攻防」场景陪我练一场。

• Agent 镜像：guide.md（与本页内容同构，Markdown 纯文本）。
• 本页为语义化 HTML：章节均带 id 锚点，表格为标准 <table>，代码块为 <pre>，Agent 抓取无需特殊处理。
• 机器可读数据：window.AIPL_SKILLS（Skill 库）与 SCENES（内置场景）均为纯 JSON 结构。

六维评分模型

每一句话术实时打分，一场对练结束生成逐句复盘报告，六个维度加权合成总分：

团队版在个人维度之上叠加成长曲线与团队数据看板，用于销售管理复盘。

常见问题