能力与边界

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

三类能力

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

本人参与工具的限制

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

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

异步与同步

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

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

接着看

• 调用与计费：返回结构、扣费与幂等。
• 错误与限制：状态、限流与重试。