googleapis/java-genai

解決的問題

提供一個符合 Java 風格的軟體開發工具組（SDK），讓開發者能與 Google 的 Gemini Developer API 和 Gemini Enterprise Agent Platform API 進行互動，無需撰寫原始 HTTP 請求即可存取這些生成式 AI 模型。

工作原理

SDK 使用 Client 類來管理與 Gemini Developer 後端（透過 API 金鑰）或 Gemini Enterprise Agent Platform（透過專案/位置或 API 金鑰）的連線。它將 API 呼叫抽象為 Java 方法，讓開發者可以：

• 產生內容：使用單一、串流或非同步呼叫，產生文字或多模態回應（文字與影像）。
• 設定模型行為：透過 GenerateContentConfig 設定系統指示、安全設定與思考預算。
• 工具整合：透過傳遞 Java 方法作為工具，實作自動函式呼叫（AFC），SDK 可在客戶端執行這些方法。
• 網路自訂：使用 HttpOptions（逾時、重試、基礎網址）與 ClientOptions（連線池、代理或自訂 OkHttpClient 實例）微調 HTTP 行為。

適用對象

希望將 Gemini 的生成式 AI 功能整合至應用程式的 Java 開發者，無論是用於個人專案使用 Developer API，還是於 Google Cloud Platform 上建構企業級應用。

主要特色

• 雙後端支援：可於 Gemini Developer 與 Gemini Enterprise Agent Platform API 之間無縫切換。
• 自動函式呼叫：允許模型自動觸發本地 Java 方法，簡化工具使用。
• 彈性執行：支援標準、串流與非同步回應模式。
• 結構化輸出：支援 JSON 回應模式，確保模型以特定格式回傳資料。
• 穩健的網路功能：內建重試邏輯，並支援自訂代理與 HTTP 客戶端。