插件类型与接口细节
这一页的重点不是罗列名字，而是帮你判断：你到底应该写哪个插件，为什么是它。
适合什么时候读
- 你已经确认需要做插件开发
- 你知道要替换某一类底层能力，但还没判断 owner surface
- 你需要从协议接口角度理解各插件边界
你会学到什么
- 五类核心插件分别负责什么
- 每类插件的典型场景和最小实现关注点
- 什么情况下不应该写某类插件
五类插件概览
1. PromptGenerator
负责把结构化 Prompt 变成文本或消息列表，并生成输出模型。
适合：
- 自定义提示词格式
- 自定义消息组织结构
2. ModelRequester
负责生成请求参数、发送请求、统一输出事件流。
适合：
- 接新模型协议
- 接私有网关或多云路由
3. ResponseParser
负责消费事件流并生成 text_result / parsed_result / result_object。
适合：
- 自定义输出解析
- 自定义结构化结果收敛
4. ToolManager
负责工具注册、工具检索、执行与 MCP 接入。
适合：
- 多租户工具隔离
- 沙盒、权限和审计
5. Session
负责 full/current/memo 三类会话数据与 resize 策略。
适合：
- 自定义记忆策略
- 外部存储型会话系统
一个简单判断表
| 你要改什么 | 对应插件 |
|---|---|
| Prompt 组织结构 | PromptGenerator |
| 模型请求协议 | ModelRequester |
| 输出解析方式 | ResponseParser |
| 工具生态与调用控制 | ToolManager |
| 对话记忆与会话策略 | Session |
常见误区
- 想改请求前后逻辑，却直接写插件，而不是先看扩展。
- 同时改多个层，却没有先确定主要 owner surface。
- 只看接口名字，不看它在调用链中的职责。
下一步去哪
- 想回到插件总览：看 插件开发概览（高级）
- 想看高级模板：看 高级场景与工程模板
Related Skills（可选）
agently-playbook