google-antigravity/antigravity-sdk-python

解決的問題

透過提供一個安全、可擴展且具備狀態管理能力的基礎設施層，簡化 AI 代理的建立。它抽象了複雜的「代理循環」（推理與行動的循環），讓開發者能專注於代理的具體功能，而非底層執行時機制。

工作原理

此 SDK 使用三層架構來管理由 Gemini 驅動的代理：

1. 簡化層：Agent 類別提供一個高階入口，便於快速設定。
2. 會話層：Conversation 類別管理有狀態會話，追蹤步驟歷史與對話回合。
3. 適配器層：透過 Connection 與 ConnectionStrategy 處理傳輸與後端抽象。

它與 Gemini 及 Gemini 企業代理平台（Vertex AI）整合，支援多模態輸入（影像、影片、音訊、文件），並可即時串流傳輸最終回應與內部模型推理過程（「思考」）。

適用對象

希望在不從零建構代理循環的前提下，結構化管理狀態、工具執行與安全策略的 Python 開發者。

主要亮點

• 工具整合：支援將自訂 Python 函數註冊為工具，並透過 Model Context Protocol (MCP) 連接外部伺服器。
• 策略系統：宣告式系統，可允許、拒絕或要求使用者對特定工具呼叫進行審核。
• 多模態支援：能處理包含文字與多種檔案類型（PDF、影像等）的混合提示。
• 觸發器：支援背景任務，可根據外部事件或定時器向代理推送訊息。
• 串流傳輸：原生非同步串流傳輸文字標記、內部推理過程與工具呼叫事件。