Google Antigravity SDK是什么Google官方AI Agent开发框架完整架构解析【免费下载链接】antigravity-sdk-pythonA Python library for building AI agents that leverage the full power of Google Antigravity.项目地址: https://gitcode.com/gh_mirrors/an/antigravity-sdk-pythonGoogle Antigravity SDK 是 Google 官方推出的 Python AI Agent 开发框架SDK让你用几行代码就能构建出安全、可扩展、有状态的 AI 智能体。它底层由 Antigravity 引擎和 Gemini 大模型驱动把复杂的 agentic loop智能体循环封装成基础设施层——你只需要关心智能体做什么而不用纠结它怎么跑。本文带你快速搞懂它的核心概念、三层架构设计和上手路径。一分钟了解Google Antigravity SDK 能做什么一句话概括它是一个 Python 库用于构建能调用 Google Antigravity 全部能力的 AI Agent。它帮你解决了 AI Agent 开发中最头疼的几类问题痛点SDK 提供的方案Agent 生命周期管理复杂Agent类一个异步上下文管理器搞定会话历史、上下文维护繁琐Conversation有状态会话自动累积步骤历史本地/云端/端侧模型切换困难Connection抽象层支持多后端策略工具调用不安全Hooks 钩子 声明式 Policies 策略系统只能一问一答Triggers 触发器支持定时任务、文件监听等后台事件核心源码入口google/antigravity/agent.py安装 Google Antigravity SDK 最快方法安装非常简单一条 pip 命令即可pip install google-antigravity⚠️新手最容易踩的坑SDK 依赖一个编译好的运行时二进制文件Go 编写的 localharness它打包在 PyPI 上各平台的 wheel 包里。只克隆代码仓库是跑不起来的必须从 PyPI 安装才能拿到二进制文件。项目构建配置见 pyproject.toml支持 Python 3.10 ~ 3.13核心依赖包括google-genai、pydantic、websockets、protobuf等。30 秒上手你的第一个 Agent设置好 API Key 后直接运行官方示例即可体验export GEMINI_API_KEYyour_api_key_here python ./examples/getting_started/hello_world.py官方示例文件examples/getting_started/hello_world.py其核心逻辑只有四步创建配置 → 启动 Agent → 发送消息 → 打印回复。system_instructions参数可以自定义系统指令Agent会自动处理二进制发现、工具接线、钩子注册等全部脏活累活。三层架构深度解析Agent / Conversation / ConnectionGoogle Antigravity SDK 采用清晰的三层架构这也是理解整个框架的关键层级定位核心类Layer 1 — 简化层开箱即用的高层入口新手首选AgentLayer 2 — 会话层有状态会话管理历史与便捷方法Conversation、ChatResponse、ToolRunner、HookRunner、TriggerRunnerLayer 3 — 适配层传输与后端的抽象屏蔽运行位置差异Connection、ConnectionStrategy、LocalConnection工作流是这样的你在AgentConfig中声明期望的能力和行为 →Agent根据配置选择合适的连接策略并创建Conversation→Conversation建立底层Connection并维护消息历史 → 你调用agent.chat()时数据经由Connection发送到后端响应以流式方式返回。三个支柱的权威说明文档skills/google-antigravity-sdk/references/architecture.md多后端连接策略Layer 3 亮点SDK 内置了三种连接策略覆盖不同部署场景LocalConnectionStrategy— 通过 WebSocket 连接 Go 编写的本地 harness通信使用 protobuf 消息LiteRTConnectionStrategy— 基于 LiteRT-LM 在设备端本地运行模型LocalOpenAIConnectionStrategy— 对接任意 OpenAI 兼容的本地服务Ollama、LM Studio 等每个策略以独立子包形式组织在connections/下实现、配置、proto 绑定和测试同包存放扩展性极好。详见 google/antigravity/connections/README.md。此外还支持Gemini Enterprise Agent Platform原 Vertex AI在LocalAgentConfig中设置vertexTrue并指定 GCP 项目与地域即可默认使用 Application Default Credentials 认证。核心功能清单6 个让 Agent 生产可用的能力1️⃣ 流式响应Streaming支持实时流式输出ChatResponse可以直接用async for迭代文本 token零额外网络开销。更进阶的用法还能单独订阅模型思考过程response.thoughts和强类型的工具调用事件流response.tool_calls适合做思考气泡、执行进度条等 UI。2️⃣ 多模态输入MultimodalAgent 可以同时接收文本指令 图片、视频、音频、文档附件。既支持从文件路径直接附加自动识别类型和 MIME也支持用Image等内容类直接传入内存字节。3️⃣ 自定义工具Custom Tools把你的 Python 函数注册为工具Agent 就能调用它们查天气、查数据库、操作内部系统——普通同步函数会自动放到独立线程执行不会阻塞异步事件循环。源码google/antigravity/tools/tool_runner.py4️⃣ MCP 集成一行配置即可连接外部 MCP Server将其工具暴露给 Agent轻松复用整个 MCP 生态的工具资产。5️⃣ Hooks 钩子与 Policies 策略系统这是 SDK 的安全核心分为三类钩子类型行为典型用途Inspect只读、不阻塞只能观察不能修改日志、监控Decide只读、阻塞返回 allow/deny 决定是否放行权限检查、护栏Transform可修改、阻塞可改写数据失败即熔断数据脱敏、错误恢复更妙的是声明式策略 APIdeny(*)默认全禁、allow(view_file)放行读文件、ask_user(run_command, ...)执行命令前先问用户——按具体 通配符、拒绝 询问 放行的优先级模型求值且默认 fail-closed失败即拒绝。策略源码google/antigravity/hooks/policy.py完整设计文档google/antigravity/hooks/README.md安全默认值Agent默认以只读模式运行需要写入能力时显式传入capabilitiesCapabilitiesConfig()才会开启全部工具。6️⃣ Triggers 触发器与 Hooks 管Agent 生命周期不同Triggers 管外部事件定时任务如每 60 秒检查部署状态、文件变更监听、Webhook 回调都能把消息推入正在运行的 Agent 会话。源码google/antigravity/triggers/trigger_runner.py仓库目录结构速览路径说明google/antigravity/SDK 核心源码google/antigravity/agent.pyLayer 1 高层入口Agentgoogle/antigravity/conversation/conversation.py有状态会话管理google/antigravity/connections/连接抽象与本地策略实现google/antigravity/hooks/生命周期钩子与策略系统google/antigravity/tools/进程内工具执行google/antigravity/triggers/后台任务与外部事件examples/getting_started/单文件入门示例一个文件一个特性examples/deep_dives/多特性深度实战示例skills/google-antigravity-sdk/内置技能包与参考文档从入门示例到深度实战的学习路线官方示例按学习曲线组织建议按顺序看起步阶段examples/getting_started/单文件、单特性hello_world.py — 最小可运行 Agentstreaming.py — 流式输出custom_tools.py — 自定义工具policies.py / hooks.py — 策略与钩子structured_output.py — 结构化输出persistence.py — 会话持久化cancellation.py — 取消机制进阶实战examples/deep_dives/多特性组合的迷你应用interactive_cli.py — 完整交互式 CLI自定义工具 MCP 钩子审批agent_middleware.py — 钩子堆叠成中间件限流、审计、错误恢复multimodal_pipeline.py — 图像生成 → 盲测视觉分析的流水线doc_maintenance_agent.py — 细粒度策略约束的自主文档维护 Agentasync_chat.py — 完全异步的 Agent 间 P2P 聊天常见问题 FAQQ1克隆仓库就能跑吗不能。SDK 依赖编译好的运行时二进制必须pip install google-antigravity从 PyPI 安装。Q2和直接调 Gemini API 有什么区别Gemini API 是模型接口Antigravity SDK 是完整的 Agent 基础设施内置工具执行、文件操作、会话状态、安全策略、触发器、可观测性OpenTelemetry等一整套能力。Q3Agent 会不会乱改我的文件默认只读模式写操作需要显式开启还可以用策略系统精确到哪个工具、什么参数下允许甚至执行前弹窗征求用户同意。总结Google Antigravity SDK 用三层架构Agent → Conversation → Connection把 AI Agent 开发中最复杂的循环、状态、传输、安全问题全部抽象掉让开发者聚焦业务逻辑。如果你正在寻找一个官方出品、开箱即用又安全可控的 Python AI Agent 开发框架它就是当前值得重点关注的选择。下一步建议先跑通hello_world再对照 examples/README.md 的示例索引按图索骥逐个特性动手实践。【免费下载链接】antigravity-sdk-pythonA Python library for building AI agents that leverage the full power of Google Antigravity.项目地址: https://gitcode.com/gh_mirrors/an/antigravity-sdk-python创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
jsp+servlet家用电器商城课设源码实战：从导入跑通到Filter优化 简介：基于 JSPServlet 的家用电器购物商城管理系统，以完整源码和数据库脚本形式提供，定位为毕业设计及 JavaWeb 课程综合项目。系统前端采用 JSP、jQuery、Layui，后端由 ServletJDBC 实现，分为管理员和用户两类角色&am… · 2026/9/26 19:25:28
Atlas 300V 24G 跑 YOLO 全流程实战：硬件选型、模型转换与推理部署 先说个结论：如果你最近在考虑“用 Atals 300V 24G 跑 YOLO”这件事，那我可以直接告诉你——这条路是通的，而且比大多数人想象中要顺手。华为昇腾这套工具链这两年迭代得很快，跟早年“文档难找、报错靠猜”的体验完全不是一回事。但… · 2026/9/26 20:03:31
室内人头检测YOLOv8数据集927张图训练实践与避坑指南 简介：面向yolo系列目标检测算法学习者与室内监控场景开发者，该数据集包含927张室内人头检测图像及完整标注，可直接用于yolov5、yolov7、yolov8、yolov9、yolov10、yolo11等主流模型的训练与验证测试。压缩包共2000个文件，包含927个… · 2026/9/26 20:03:03
数据库课后习题答案别硬背：当测试用例集刷，效率翻倍 简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21
OpenClaw 替代品？Hermes Agent 踩坑实录：macOS 飞书接入 TaoToken 配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 0:00:40
向下兼容与向上兼容：接口设计中的兼容性策略与工程实践 一次版本升级事故，是很多团队绕不过去的坎。线上环境里，服务端明明已经上线了新版接口，老的移动端还在照着旧文档传参数。请求一到网关，校验直接拒绝，用户操作失败，客服群炸了锅，开发群里开始互… · 2026/9/26 0:00:46
的简介、安装和使用方法、案例应用之详细攻略)
