用途：ai 是面向 Python 的 AI SDK，用于在 Python 中调用各类模型并构建智能体。需 Python 3.12+，安装命令为 uv add ai。
主要能力：支持语言模型、图像、视频、语音、嵌入、转写、重排与评估等模型操作；提供消息、事件与序列化、结构化输出、复杂流式输出、缓冲式语言模型调用；支持工具、高级工具与流式工具、智能体、子智能体与多智能体、自定义智能体循环、人工介入与审批钩子、无服务器恢复、持久执行、遥测与追踪，以及 AI SDK UI 后端和自定义提供方。
使用方式：无前缀模型 ID 走 AI Gateway，需 AI_GATEWAY_API_KEY；直连提供方用 provider:model 形式并安装对应 extra，例如 uv add "ai[openai]" 配 OPENAI_API_KEY、ai.get_model("openai:gpt-5")，或 uv add "ai[anthropic]" 配 ANTHROPIC_API_KEY、ai.get_model("anthropic:claude-sonnet-4")。单次模型调用可用 ai.stream 配合 ai.system_message、ai.user_message 等消息，遍历事件读取 TextDelta，并从 stream.output、stream.message 取结果。需要执行 Python 工具并管理历史时用 ai.Agent，工具以 @ai.tool 装饰，通过 agent.run 遍历事件并读取 run.output、run.messages。
进阶：更复杂任务可查阅 https://ai-python.dev/docs/ 下对应页面，如 providers、streaming、model-operations、messages-and-events、tools、agents、testing、subagents-and-multi-agent、custom-loops、human-in-the-loop、durable-execution、telemetry、ai-sdk-ui 等；精确 API 见 reference.md 及相关 reference/*.md。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；部分进阶主题仅给出文档路径，未展开细节。