用途:面向需要在 AI SDK for Python 中为新上游 API 编写适配器的开发者。Provider 只发出模型事件,不运行 Python 工具;ai.stream 将事件收集为 Message,ai.Agent 再补充工具执行、hooks 与 replay。
主要能力:实现 ProviderProtocol 与 Provider,定义 stream 异步生成器,按顺序产出事件(StreamStart、TextStart、TextDelta、TextEnd、StreamEnd),并实现 default_protocol、list_models、probe 等方法。自 0.4.0 起可在 StreamEnd 设置响应元数据,并将上游停止原因规范化为 stop、length、content_filter、tool_call、error、other,原始值保留在 provider_metadata;如上游返回 response_id 与 response_model 也一并设置。
工具调用:对 Python 工具依次发出 ToolStart、ToolDelta、ToolEnd,流收集器会聚合为 event.tool_call,再由 Agent 解析并运行工具。若 provider 自带内置工具,改用 BuiltinToolStart、BuiltinToolDelta、BuiltinToolEnd、BuiltinToolResult。
用法要点:组合 ai.Model 与自定义 Provider 实例后使用。
限制:官方资料明确建议普通应用配置不要实现自定义 provider,应优先使用 ai.get_provider(...)、ai.get_model(...) 或协议覆盖,除非确实在新增上游 API 适配器。中文简介以外未提供收费、价格、平台支持等信息。