當(dāng)開(kāi)發(fā)者需要將AI能力嵌入自有應(yīng)用時(shí)，常見(jiàn)的做法是通過(guò)API調(diào)用遠(yuǎn)程Agent服務(wù)。然而這種方式存在延遲高、定制性差、依賴(lài)網(wǎng)絡(luò)等固有問(wèn)題。Google在I/O 2026大會(huì)上給出了另一種解法——Antigravity SDK，一個(gè)讓開(kāi)發(fā)者可以在本地構(gòu)建、自定義和部署AI Agent的Python庫(kù)。

只需20行符合慣用法的Python代碼，開(kāi)發(fā)者就能創(chuàng)建一個(gè)功能完整的Agent實(shí)例，而驅(qū)動(dòng)它的正是Google Antigravity平臺(tái)自用的運(yùn)行時(shí)引擎(Antigravity Runtime)。

哥們此處回收一下伏筆 ;-) 看別人都在封裝Agent，我也封裝了一個(gè)Agent，但是整個(gè)IDE的【工程化+AI能力】都給我封裝出來(lái)了。

這套運(yùn)行時(shí)最初支撐著Antigravity 2.0網(wǎng)頁(yè)應(yīng)用和命令行工具，如今被封裝成SDK對(duì)外開(kāi)放。開(kāi)發(fā)者在本地創(chuàng)建的Agent繼承了同樣的執(zhí)行環(huán)境：內(nèi)置的工具集、聲明式的安全策略引擎、用于觀察和引導(dǎo)每次工具調(diào)用的生命周期鉤子，以及跨交互持久化的有狀態(tài)多輪會(huì)話。更關(guān)鍵的是，隨著Google對(duì)運(yùn)行時(shí)本身的優(yōu)化——更快的工具執(zhí)行、更智能的規(guī)劃、更好的上下文管理——SDK中的Agent無(wú)需任何代碼改動(dòng)即可自動(dòng)受益。

Agent類(lèi)的使用非常直觀。采用async with模式管理完整生命周期，一段不到15行的代碼就能實(shí)現(xiàn)一個(gè)回答問(wèn)題的Agent：導(dǎo)入必要的模塊，配置LocalAgentConfig，然后通過(guò)agent.chat()方法發(fā)起對(duì)話即可。這個(gè)Agent的邏輯與運(yùn)行環(huán)境完全解耦——未來(lái)只需切換為遠(yuǎn)程運(yùn)行模式，同一套代碼就能部署到云端，而開(kāi)發(fā)者只需關(guān)注Agent要做什么，而不必操心它如何以及在哪里運(yùn)行。

pip install google-antigravity

import asyncio
from google.antigravity import Agent, LocalAgentConfig

 async def main():
    config = LocalAgentConfig()
    async with Agent(config) as agent:
        response = await agent.chat("What files are in the current directory?")
        print(await response.text())

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

每個(gè)Agent在初始化時(shí)就擁有完整內(nèi)置工具集：文件讀寫(xiě)、代碼編輯、Shell執(zhí)行、目錄搜索、圖片生成、子Agent委托等。開(kāi)發(fā)者可以在此基礎(chǔ)上通過(guò)系統(tǒng)指令為Agent設(shè)定身份、添加領(lǐng)域特定的指導(dǎo)，或者完全替換默認(rèn)工具。SDK在設(shè)計(jì)時(shí)特別考慮了AI友好的原則——API表面使用清晰的Python類(lèi)型（Pydantic V2模型、原生Python集合）、結(jié)構(gòu)化輸出和明確的命名約定，這些設(shè)計(jì)決策使得AI Agent能夠像人類(lèi)開(kāi)發(fā)者一樣流暢地讀取、編寫(xiě)和維護(hù)SDK代碼。事實(shí)上，Antigravity本身在構(gòu)建SDK代碼時(shí)也在使用這個(gè)Agent——這意味著Agent對(duì)你的框架有從內(nèi)到外的理解。

SDK支持四類(lèi)工具集，它們共享同一套執(zhí)行管道、流式基礎(chǔ)設(shè)施和安全策略。內(nèi)置工具覆蓋了常見(jiàn)的文件操作和代碼執(zhí)行；自定義Python函數(shù)允許將任何Python可調(diào)用對(duì)象注冊(cè)為Agent可調(diào)用的工具；MCP服務(wù)器可以連接任何Model Context Protocol服務(wù)器（支持stdio、SSE或Streamable HTTP模式），將其工具暴露給Agent；Agent技能包則允許通過(guò)配置中的skills_paths提供包含指令、工具和上下文的可復(fù)用技能包路徑。一次定義的策略或鉤子會(huì)統(tǒng)管所有工具——無(wú)論其來(lái)源是什么。

安全策略是SDK的另一核心特性。LocalAgentConfig默認(rèn)啟用所有內(nèi)置工具，但默認(rèn)應(yīng)用confirm_run_command()策略——大多數(shù)工具可以無(wú)摩擦使用，但Shell訪問(wèn)默認(rèn)被拒絕。如果需要完全自主執(zhí)行，傳入policies=[policy.allow_all()]即可。開(kāi)發(fā)者還可以用聲明式方式精細(xì)控制：deny策略默認(rèn)阻止所有操作，然后通過(guò)allow顯式放行特定工具（如view_file），對(duì)于Shell執(zhí)行則用ask_user策略將決定權(quán)交給人類(lèi)。

超越策略之外，鉤子系統(tǒng)提供了生命周期級(jí)別的控制能力。鉤子分為三類(lèi)：Inspect是只讀非阻塞的，用于觀察事件以實(shí)現(xiàn)日志記錄、指標(biāo)收集或?qū)徲?jì)追蹤；Decide同樣是只讀阻塞的，用于批準(zhǔn)或拒絕操作（策略即構(gòu)建于此）；Transform則是可修改的阻塞鉤子，用于在數(shù)據(jù)傳輸過(guò)程中進(jìn)行清理或錯(cuò)誤恢復(fù)。SDK提供了九個(gè)具體的鉤子注入點(diǎn)——從會(huì)話啟動(dòng)/結(jié)束，到輪次前后，再到工具調(diào)用前后、工具錯(cuò)誤恢復(fù)、用戶(hù)交互處理和上下文壓縮，每個(gè)鉤子都有裝飾器形式的快捷方式來(lái)快速接入。

在I/O能力方面，Agent支持流式輸出，開(kāi)發(fā)者可以通過(guò)async for chunk in response獲取實(shí)時(shí)內(nèi)容；多模態(tài)輸入允許將圖片、PDF、音頻和視頻與文本提示一起傳遞；子Agent功能可以生成具有獨(dú)立工具、指令和上下文的子Agent實(shí)例，這是構(gòu)建Agent團(tuán)隊(duì)的基本構(gòu)建塊；推理深度控制則通過(guò)GenerationConfig為每個(gè)請(qǐng)求設(shè)置MINIMAL、LOW、MEDIUM或HIGH四個(gè)級(jí)別；觸發(fā)器功能可以運(yùn)行響應(yīng)外部事件的后臺(tái)任務(wù)并將消息推入Agent。

在狀態(tài)管理方面，對(duì)話可以通過(guò)conversation_id在保存的會(huì)話ID之間恢復(fù)；結(jié)構(gòu)化輸出允許開(kāi)發(fā)者定義響應(yīng)模式（JSON schema、dict或Pydantic模型），Agent通過(guò)response.structured_output()返回經(jīng)過(guò)驗(yàn)證的類(lèi)型化數(shù)據(jù)；人機(jī)交互功能讓Agent可以在任務(wù)中途暫停，向用戶(hù)提出帶有預(yù)定義選項(xiàng)的結(jié)構(gòu)化問(wèn)題并根據(jù)回答分支執(zhí)行。

可觀測(cè)性方面，SDK提供每個(gè)輪次和累計(jì)的令牌使用量統(tǒng)計(jì)——包括提示令牌、候選令牌、緩存令牌和思維令牌，可通過(guò)usage_metadata獲取；推理追蹤功能允許在輸出的同時(shí)訪問(wèn)模型的實(shí)時(shí)推理過(guò)程。SDK默認(rèn)使用Gemini 3.5 Flash作為模型，該模型也是支撐整個(gè)平臺(tái)性能的核心。

當(dāng)前SDK處于研究預(yù)覽階段，Google正在根據(jù)開(kāi)發(fā)者、研究人員和平臺(tái)工程師的反饋塑造其未來(lái)發(fā)展路線圖。即將推出的功能包括：

• 遠(yuǎn)程Harness部署，允許將SDK Agent部署到Google Cloud，實(shí)現(xiàn)持久化、可擴(kuò)展并通過(guò)交互API訪問(wèn)的開(kāi)發(fā)體驗(yàn)；

• TypeScript和Go語(yǔ)言支持，讓更多開(kāi)發(fā)者能夠使用同一運(yùn)行時(shí)構(gòu)建應(yīng)用；

• Gemma集成，將完整Agent運(yùn)行時(shí)帶到可自行運(yùn)行和微調(diào)的開(kāi)源模型上；

• 插件系統(tǒng)，允許開(kāi)發(fā)者構(gòu)建可復(fù)用工具包，通過(guò)編程方式組合到Agent中或從社區(qū)加載；

• 更深入的可觀測(cè)性支持，包括后臺(tái)步驟追蹤、觸發(fā)器執(zhí)行日志和更豐富的遙測(cè)數(shù)據(jù)，用于大規(guī)模調(diào)試和優(yōu)化Agent行為。

SDK采用Apache 2.0許可證開(kāi)源，提供兩個(gè)層次的示例代碼：getting_started/目錄包含單功能演練，deep_dives/目錄則展示更復(fù)雜的模式。完整的API文檔已上線，開(kāi)發(fā)者可以通過(guò)pip install google-antigravity直接安裝體驗(yàn)。

對(duì)于希望在自有項(xiàng)目中深度定制AI Agent行為的開(kāi)發(fā)者而言，Antigravity SDK提供了一個(gè)介于完全托管API和完全自建之間的中間地帶——既有Google基礎(chǔ)設(shè)施的支撐，又保留了本地執(zhí)行的靈活性和完整的定制空間。

參考來(lái)源：

• Google Antigravity SDK官方博客：https://antigravity.google/blog/introducing-google-antigravity-sdk

• GitHub倉(cāng)庫(kù)：https://github.com/google-antigravity/antigravity-sdk-python

• Gemini 3.5 Flash介紹：https://antigravity.google/blog/gemini-3-5-flash-in-google-antigravity