# 能力与边界

> Herline MCP 按能力性质分为三类：生产工具、本人参与工具、只读数据。

更新:2026-06-29
页面:https://herline.vip/developers/capabilities

---


连接后，agent 会看到一组结构化工具。Herline 按能力性质把工具分为三类，并在服务端执行相同的权限和边界规则。

## 三类能力

| 类别         | 典型能力                                     | agent 可以做什么                                   | 计费                                   |
| ------------ | -------------------------------------------- | -------------------------------------------------- | -------------------------------------- |
| 生产工具     | 深读、调研、成课、讲稿、分发素材、检索、导出 | 按工具 schema 完整调用                             | 按用量消耗 Her能；只读或免费提交类除外 |
| 本人参与工具 | 陪练、排练、测评                             | 发起入口、传入上下文、读取结果；不能替用户完成过程 | 发起不扣费；实际场景按网页端规则       |
| 只读数据     | 资料库、知识块、自有课程、报告、档案         | 读取有权限访问的数据                               | 不扣费                                 |

## 本人参与工具的限制

陪练、排练和测评的核心输入来自用户本人。MCP 只开放 launch/read 形态：agent 可以创建入口、传入主题或上下文、读取完成后的结果；逐轮练习、语音互动和测评作答不作为 MCP 工具开放。

这条限制由服务端工具注册表和测试守住，不依赖客户端自觉。

## 异步与同步

- **异步工具**：深读、成课、分发等提交后返回 `task_id`，再用 `poll_task` 查询状态。
- **同步工具**：检索、解锁、部分读取类能力即时返回。
- **发起工具**：返回进入 Herline 场景的 deeplink，不在 MCP 中执行场景过程。

每个工具的参数和返回结构以客户端读取到的工具 schema 为准。

## 接着看

- [调用与计费](/developers/billing)：返回结构、扣费与幂等。
- [错误与限制](/developers/errors)：状态、限流与重试。