結論先說
- 安裝必須走標準
pip install google-antigravity:官方 PyPI 發佈的平台專屬安裝包(wheel)裏打包了底層編譯好的運行時二進制程序,不要只拉純源碼目錄硬跑。 LocalAgentConfig預設鎖死在安全只讀模式:不傳額外參數時,拉起的智能體只能查代碼、不能動硬碟上的任何文件;只有顯式傳入capabilities=CapabilitiesConfig()才會解鎖edit_file和run_command。- 全程採用
asyncio異步上下文管理器:用async with Agent(config) as agent:自動接管底層進程啟停與資源回收,await agent.chat(...)會立即返回非阻塞流對象。 - 除了正文 Token,還能分流讀取思考鏈和工具事件:遍歷
response.thoughts與response.tool_calls即可在後台監控智能體每一步幹了什麼。 - 帳號配套與跨平台編程訂閱入口:運行
agy命令行、SDK 與多子代理並發依賴正常可用的谷歌帳號與充裕模型配額,帳號準備見本站 谷歌帳號說明頁,免境外卡開通終端編程會員見 Claude Code 訂閱頁 與 AI 會員充值總覽。

圖:本站根據 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 上下文管理器會自動完成運行時二進制發現、工具接線、鉤子註冊以及退出時的子進程清理,不需要你自己寫繁瑣的進程守護代碼。需要準備獨立開發測試用的個人谷歌帳號時,可先瀏覽本站 谷歌帳號購買說明 或前往自動發卡的 谷歌電郵成品號商品頁(質保政策以商品頁為準)。
二、只讀安全模式、思考流監控與權限攔截對比

圖:本站根據 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 調用與生命週期鉤子、配額的關係
- 聲明式權限與 Hooks 雙保險:SDK 提供了編程式的策略包裝器(如
allow、deny、ask_user)用於在 Python 代碼裏直接攔截特定函數或run_command調用;同時工作區下的.agents/hooks.json鉤子依然能協同生效,底層權限邏輯可對照 Antigravity 終端沙箱與權限策略 與 Antigravity Hooks 生命週期配置。 - 注意批量腳本循環耗盡帳號配額:用
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 充值,實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。
0 條評論
還沒有評論,來搶沙發~