用途:本资料是 Amplifier 模块开发的权威指导,说明如何按契约创建各类模块,包括协议实现、入口点、mount 函数与测试模式。
主要能力:覆盖五类模块——Provider(LLM 后端集成)、Tool(智能体能力)、Hook(生命周期观察与控制)、Orchestrator(智能体循环执行策略)、Context(对话记忆管理)。每类契约文档包含用途、协议引用(含 interfaces.py 行号)、入口点模式、配置、范例与验证方式。核心事实以代码为准:协议定义位于 amplifier_core/interfaces.py,数据模型位于 models.py、message_models.py、content_models.py。
使用方式:通用模式为——1)从 interfaces.py 实现对应 Protocol;2)提供 mount() 函数完成初始化与注册;3)在 pyproject.toml 的 [project.entry-points."amplifier.modules"] 中注册入口点。Tool 需实现 name、description 与 async execute 并返回 ToolResult;Provider 需实现 name、get_info、list_models、complete、parse_tool_calls 五个方法并报告 token 用量;Hook 以 call 处理事件并返回 HookResult,动作包括 continue、deny、modify、inject_context、ask_user。配置通过 Mount Plan 提供。
适用场景:为 Amplifier 生态开发扩展模块时,按类型查阅对应契约并参照范例实现。
限制:资料多处截断,Hook 与 Orchestrator、Context 的完整细节、定价与平台支持暂未提供;协议细节应以代码 docstring 为准。验证命令为 amplifier module validate ./my-module。