# 在线教育助教 (/docs/solutions/course-assistant)



让学员在你的课程页面里获得与当前课时有关的解释和复习提示，把提问留在学习过程里，课程内容、品牌和学员关系仍归你。

## 适合谁 [#适合谁]

适合拥有课程网站的教育机构、课程创作者，以及为其建设学习平台的开发者。你需要准备可供助教使用的课时介绍、要点和回答边界，并能改动课程页面、连接现有登录体系。

先选一门资料完整的课程验证。助教依据你提供的内容与页面状态回答，并不会因为页面上有视频就自动理解全部音视频。涉及课程之外的知识、考试评分或个别学习判断时，应明确说明需要教师确认。

## 能做到的几件事 [#能做到的几件事]

* **围绕当前课时提问**：把课程名称和课时信息传给助教，学员不必每次重复“我正在看哪一课”。
* **读取播放进度**：页面工具可以读取播放器当前位置，让“我看到哪里了”这样的提问有具体依据。
* **在学习页面调整播放**：接入对应页面工具后，助教可以配合学员的请求跳到指定位置或切换课时；具体动作由你的播放器实现。

页面信息用于理解学习场景，不用于判定课程购买权限。学员能否访问某门课仍由你的网站决定；不能把浏览器报告的课程名称或进度当作成绩和结业凭据。

## 方案组成 [#方案组成]

| 学习体验           | 接入入口                                                          |
| -------------- | ------------------------------------------------------------- |
| 定义助教角色、知识范围与口吻 | [服务智能体](/docs/developers/agent)                               |
| 在课程旁展示助教       | [选择嵌入方式](/docs/developers/agent/embed/overview)               |
| 提供当前课时与播放位置    | [前端工具与页面上下文](/docs/developers/agent/embed/client-tools)       |
| 关联登录学员         | [嵌入令牌与终端用户](/docs/developers/agent/embed/tokens)              |
| 将组件接入已有账户页面    | [SaaS 嵌入配方](/docs/cookbook/scenarios/saas-embedded-assistant) |

## 怎么上线 [#怎么上线]

1. 按[智能体快速开始](/docs/developers/agent/quickstart)建立助教，准备课程介绍、课时要点和范围外问题的处理方式。
2. 按[网页嵌入指南](/docs/developers/agent/embed/quickstart)把助教接到课程页面，让后端根据当前登录学员签发令牌。
3. 按[前端工具与页面上下文](/docs/developers/agent/embed/client-tools)接入课时信息与播放器。先接读取进度，再根据需要接入跳转或切换动作。
4. 在不同课时、不同进度提问，核对回答使用当前状态；检查学员切换、退出登录与工具失败时的行为。确认教师认可回答范围后，再向学员开放。

**交给你的代理**：

```text
目标：给我的课程网站接入助教。阅读本站 /docs/solutions/course-assistant，并沿链接完成接入。
请确认课程页面地址、登录方式、智能体、课时资料、播放器接口，以及允许助教执行的动作；凭证只配置在后端。
完成判定：助教可对话；切换课时后识别新课时；报告的播放进度与页面一致；允许的播放动作可验证；范围外问题引导联系教师。
交付验证记录，以及暂停助教入口、不影响课程播放的方法。
```

## 成本估算 [#成本估算]

成本估算待补。[公开定价](/docs/developers/account/pricing)尚不足以给出完整的课程助教费用。先用一门课程采集活跃学员数、每位学员的问答轮数与模型用量，再制定预算；视频托管和你现有教学系统的费用应分别统计。

## 演示 [#演示]

打开[好物集课程助教](https://praxis-kit-demo-develop.jshansince93.workers.dev/courses/earbuds-101)，选择演示账户并打开助教。切换课时、拖动播放进度，再问“我现在学到哪里了？”并对照页面验证。

演示使用模拟播放器，展示的是课时、进度与助教之间的交互，不是实际课程的视频分析。可以继续请求跳到某个位置，观察播放器是否执行了相应动作。

## 下一步 [#下一步]

从[页面工具指南](/docs/developers/agent/embed/client-tools)接入你实际使用的播放器。上线前阅读[嵌入安全](/docs/developers/agent/embed/security)，并为助教无法回答的问题保留教师联系入口。
