Google Antigravity SDK 是用于设计、实现和调试自主 AI 智能体及多智能体系统的 Python SDK,包名为 google-antigravity。
用途:在项目中构建自主智能体、多智能体委派与确定性工作流,并调试失败的智能体。
使用前准备:确认项目适合使用该 SDK,检查依赖文件(requirements.txt、pyproject.toml)是否已列出 google-antigravity,并安装该包。
认证:默认使用托管 Gemini 模型(LocalAgentConfig),需要 GEMINI_API_KEY 环境变量或 .env 文件;密钥可在 https://aistudio.google.com/app/api-keys 获取,也可在代码中通过 LocalAgentConfig(api_key="...") 显式传入。Vertex/Gemini Enterprise Agent Platform 支持标准模式(运行 gcloud auth application-default login 并以 vertex=True 配置 project 和 location)和 Express 模式(vertex=True 配合 api_key)。本地模型(LiteRTAgentConfig 或 LocalOpenAIAgentConfig)无需 API 密钥或云凭据,其中 LiteRT 为受支持的端侧运行时。
主要能力:智能体与会话核心概念、智能体配置(模型选择、agent_behavior、连接可靠性)、MCP 服务器集成与工具权限、安全策略与 OS 级沙箱、错误处理与钩子、成本与 token 监控、内置工具、本地模型运行;示例涵盖基础智能体、流式响应、自定义工具、人格配置、多模态(图像与 PDF)、多智能体委派与嵌套层级(max_subagent_depth、allowed_subagents)、工作流(@beta.workflows.define 与 await agent.beta.run_workflow(...))、MCP 工具、周期性触发、钩子、取消、持久化、结构化输出、智能体技能、Web 工具、预算限制与会话限制、上下文压缩等。
适用场景:需要自主或多智能体编排、工具调用、本地离线运行、安全审计或可观测性的 Python 项目。
限制:资料未提供具体版本、许可、硬件要求与完整 API 细节,需查阅对应参考文件与示例。