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 條評論

登入 後參與評論

還沒有評論,來搶沙發~