google-antigravity/antigravity-sdk-python

解决的问题

通过提供一个安全、可扩展且具备状态管理能力的基础设施层，简化 AI 代理的创建。它抽象了复杂的「代理循环」（推理与行动的循环），使开发者能够专注于代理的具体功能，而非底层运行时机制。

工作原理

该 SDK 使用三层架构来管理由 Gemini 驱动的代理：

1. 简化层：Agent 类提供一个高层入口，便于快速设置。
2. 会话层：Conversation 类管理有状态会话，跟踪步骤历史和对话轮次。
3. 适配器层：通过 Connection 和 ConnectionStrategy 处理传输和后端抽象。

它与 Gemini 及 Gemini 企业代理平台（Vertex AI）集成，支持多模态输入（图像、视频、音频、文档），并可实时流式传输最终响应和内部模型推理过程（“思考”）。

适用人群

希望在不从零构建代理循环的前提下，结构化管理状态、工具执行和安全策略的 Python 开发者。

主要亮点

• 工具集成：支持将自定义 Python 函数注册为工具，并通过 Model Context Protocol (MCP) 连接到外部服务器。
• 策略系统：声明式系统，可允许、拒绝或要求用户对特定工具调用进行审批。
• 多模态支持：能够处理包含文本和多种文件类型（PDF、图像等）的混合提示。
• 触发器：支持后台任务，可根据外部事件或定时器向代理推送消息。
• 流式传输：原生异步流式传输文本标记、内部推理过程和工具调用事件。