Antigravity Python SDK(google-antigravity)入门:安装、异步流式输出与工具权限控制

怎么在自己的 Python 自动化测试流水线或后台脚本里直接租用 Google Antigravity 智能体?本文按官方 SDK 文档整理 pip 安装要求、只读与读写能力配置、异步流式捕获思考链及策略拦截写法。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

  1. 安装必须走标准 pip install google-antigravity:官方 PyPI 发布的平台专属安装包(wheel)里打包了底层编译好的运行时二进制程序,不要只拉纯源码目录硬跑。
  2. LocalAgentConfig 默认锁死在安全只读模式:不传额外参数时,拉起的智能体只能查代码、不能动硬盘上的任何文件;只有显式传入 capabilities=CapabilitiesConfig() 才会解锁 edit_file 和 run_command。
  3. 全程采用 asyncio 异步上下文管理器:用 async with Agent(config) as agent: 自动接管底层进程启停与资源回收,await agent.chat(...) 会立即返回非阻塞流对象。
  4. 除了正文 Token,还能分流读取思考链和工具事件:遍历 response.thoughts 与 response.tool_calls 即可在后台监控智能体每一步干了什么。
  5. 账号配套与跨平台编程订阅入口:运行 agy 命令行、SDK 与多子代理并发依赖正常可用的谷歌账号与充裕模型配额,账号准备见本站 谷歌账号说明页,免境外卡开通终端编程会员见 Claude Code 订阅页 与 AI 会员充值总览。

Python SDK 接入智能体四步入门

图:本站根据 Antigravity Python SDK 官方仓库 整理的示意图

本文根据 Google Antigravity 官方 Python SDK 文档(github.com/google-antigravity/antigravity-sdk-python)整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Google 官方网站。

适用于谁

  • 想把 Antigravity 的代码检索、修 Bug 或写单测能力集成进自家 Python 脚本与 CI 质检管线的后端工程师;
  • 不满足于在图形界面手动点对话框,想用代码批量调度智能体并实时采集工具调用日志的人;
  • 刚装好 google-antigravity 跑示例时发现智能体只能读文件不能改文件,卡在默认权限开关上的人。

一、安装要求与最小可运行异步示例

打开终端激活你的 Python 虚拟环境,执行官方安装命令:

bash
pip install google-antigravity

确保本机已完成谷歌开发者账号认证后(账号登录与地区条件排查见 Google Antigravity 登录排错指南),新建 demo_agent.py 即可跑通完整的异步流式对话:

python
import asyncio
import sys
from google.antigravity import Agent, LocalAgentConfig, CapabilitiesConfig

async def main():
    # 默认不传 capabilities 时为安全只读模式;传入 CapabilitiesConfig() 开启改文件与跑命令能力
    config = LocalAgentConfig(
        system_instructions="你是负责代码库巡检与单元测试补全的资深 Python 助手,请用中文简明输出结论。",
        capabilities=CapabilitiesConfig(),
    )

    async with Agent(config) as agent:
        response = await agent.chat("扫描当前目录下的 Python 文件,列出缺少异常处理的函数名。")

        async for token in response:
            sys.stdout.write(token)
            sys.stdout.flush()
        print()

if __name__ == "__main__":
    asyncio.run(main())

上面这段代码背后的设计非常省心:Agent 上下文管理器会自动完成运行时二进制发现、工具接线、钩子注册以及退出时的子进程清理,不需要你自己写繁琐的进程守护代码。需要准备独立开发测试用的个人谷歌账号时,可先浏览本站 谷歌账号购买说明 或前往自动发卡的 谷歌邮箱成品号商品页(质保政策以商品页为准)。

二、只读安全模式、思考流监控与权限拦截对比

Python SDK 默认模式与进阶控制对比

图:本站根据 Antigravity Python SDK 文档 整理的对比示意图

在把智能体放进自动化流水线时,按任务性质精确控制读写边界与可观测性至关重要:

应用场景核心代码配置写法行为边界说明
自动化 PR 代码只读审查LocalAgentConfig(system_instructions="...")(省略 capabilities)百分百只读,哪怕提示词被恶意注释干扰也无法篡改仓库文件或跑危险 Shell
自动生成补丁与跑单测LocalAgentConfig(capabilities=CapabilitiesConfig())允许调用写文件与终端命令工具,建议配合沙箱与策略包装器限制高危命令
审计后台推理与工具轨迹异步遍历 response.thoughts 与 response.tool_calls强类型捕获每次 call.name 与 call.args,方便写入企业内部审计日志
快速拉起终端交互循环调用 google.antigravity.utils.interactive 下的 run_interactive_loop(agent)十行代码把配好自定义系统指令的专属智能体变成交互式命令行助手

下面演示如何在同一个脚本里同时捕获智能体的内部思考增量(Thoughts)与每一次工具调用参数:

python
async with Agent(config) as agent:
    response = await agent.chat("检查 tests/ 目录下的失败用例并定位根因。")

    async for thought in response.thoughts:
        print(f"[思考过程] {thought}")

    async for call in response.tool_calls:
        print(f"[调用工具] {call.name} 参数: {call.args}")

    async for token in response:
        sys.stdout.write(token)

三、SDK 调用与生命周期钩子、配额的关系

  1. 声明式权限与 Hooks 双保险:SDK 提供了编程式的策略包装器(如 allow、deny、ask_user)用于在 Python 代码里直接拦截特定函数或 run_command 调用;同时工作区下的 .agents/hooks.json 钩子依然能协同生效,底层权限逻辑可对照 Antigravity 终端沙箱与权限策略 与 Antigravity Hooks 生命周期配置。
  2. 注意批量脚本循环耗尽账号配额:用 for 循环一次性并发拉起十几个 Agent 实例跑大仓库,会迅速吃光当前账号的周期模型限额。建议在脚本里做好串行限流,并按任务复杂度合理选模型,详见 Antigravity 额度限制与模型选择。

常见问题

问:在 Linux 容器里从源码拷目录跑报找不到底层二进制怎么办?

答:官方明确提醒 SDK 依赖随各操作系统架构打包进 PyPI wheel 的编译二进制文件。在 Dockerfile 构建镜像时请直接执行 pip install google-antigravity,让 pip 自动匹配对应架构(如 manylinux、macosx_arm64)的二进制包。

问:SDK 拉起的智能体能自动读取仓库里的 AGENTS.md 和 .agents/skills/ 吗?

答:只要在目标仓库工作目录下启动,底座同样遵循工作区定制发现机制,能复用你写好的项目规则与技能手册。

问:只想在终端手动敲命令对话,有必要自己写 Python 脚本包一层吗?

答:没必要。纯手工交互直接装官方 agy 命令行更轻量,斜杠指令更全,见 Antigravity agy 命令行进阶指南;只有需要把智能体嵌进你自己的 Python 业务逻辑或自动化测试框架时才用 SDK。

问:跑多子代理和终端工具时没有合规谷歌账号或海外信用卡怎么办?

答:可在 本站充值中心 通过支付宝、微信支付或 AlipayHK 即买即发获取 谷歌邮箱成品号,或免上号自助兑换 Claude Pro 自助卡密 与 Claude Max 充值,实时价格与售后边界(封号不在质保范围)以对应商品页为准。

相关教程

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 单独备份导出 NotebookLM 笔记本与 Gemini 记录:只勾选指定服务不下载整个云端硬盘的步骤

    想把 NotebookLM 里的几十个研究笔记本、来源副本与音频概览,连同 Gemini 聊天记录一起备份到本地,又怕 Google Takeout 把整个云端硬盘和相册全打包?本文讲清先取消全选、精准勾选两项服务、解压目录查看与跨号迁移的做法。

    Gemini0
  2. 02

    Google Workspace 企业/教育版管理员怎么在后台给成员开启 Gemini 应用、NotebookLM 与设置年龄访问权限

    团队成员或学校师生登录 Google Workspace 账号时提示无权使用 Gemini 或打不开 NotebookLM?本文按 Google 管理控制台官方文档整理服务开关路径、组织部门(OU)与群组放行、18 岁年龄访问权限设置及对话保留合规配置。

    Gemini0
  3. 03

    安卓手机默认助手换成 Gemini 后设闹钟、发短信或控制智能家居失灵怎么办:Workspace 与实用程序扩展开启步骤

    安卓手机把默认语音助手从 Google Assistant 换成 Gemini 后,喊它定闹钟、开手电筒、发短信或开关智能灯全都没反应?本文按官方帮助中心整理实用程序(Utilities)、Google Home 与 Workspace 关联应用开启步骤及锁屏放行设置。

    Gemini0
  4. 04

    Gemini 写长代码或长文档到一半突然停住、格式截断怎么无缝续写:锚点接续指令与 Canvas 分块修改技巧

    让 Gemini 写几百行代码或万字长文时经常写到一半突然停住、Markdown 代码块没闭合,直接回「继续」又重头抄一遍?本文整理字面锚点续写指令、代码块防乱码补齐法与 Canvas 局部圈选修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音频播客(Audio Overview)高阶玩法:用自定义引导词控制对谈深度、受众水平与重点章节(附模板)

    NotebookLM 生成的中文音频播客总是泛泛而谈、漏掉核心章节或夹杂生僻英文缩写?本文按官方帮助中心整理来源勾选过滤、四种播客格式搭配与三维自定义引导词写法,附 4 套可直接复制的中文控场模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 视频、网页或扫描版 PDF 提示「无法导入来源」怎么办:无字幕、反爬与纯图 PDF 逐项解决

    往 NotebookLM(Gemini Notebook)塞 YouTube 链接、外文网页或扫描教材时总是亮红叹号提示无法导入来源?本文按官方帮助中心逐项排查无字幕视频、反爬动态页与加密纯图 PDF 的替代导入步骤。

    Gemini0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~