ย้ายข้อมูลจาก Google AI Client SDK ไปยัง Firebase AI Logic SDK

Swift

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase

Firebase AI Logic ไลบรารีช่วยให้เข้าถึง API เพื่อโต้ตอบกับโมเดล Gemini และ Imagen ได้ ไลบรารีนี้รวมอยู่ ใน Firebase SDK สำหรับแพลตฟอร์ม Apple (firebase-ios-sdk)

หากใช้ Firebase อยู่แล้ว ให้ตรวจสอบว่าแพ็กเกจ Firebase เป็นเวอร์ชัน 12.5.0 ขึ้นไป

1. เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ File > Add Package Dependencies

2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ Firebase Apple Platforms SDK ดังนี้

   https://github.com/firebase/firebase-ios-sdk
   

3. เลือก SDK เวอร์ชันล่าสุด

4. เลือกคลังFirebaseAILogic

เมื่อเสร็จแล้ว Xcode จะเริ่มจับคู่ข้อมูลและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ

Kotlin

Firebase AI Logic SDK สำหรับ Android (firebase-ai) ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini และ Imagen

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (เช่น <project>/<app-module>/build.gradle.kts) ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Firebase AI Logic สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการกำหนดเวอร์ชันของไลบรารี

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.6.0"))

  // Add the dependency for the Firebase AI Logic library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
}

การใช้ Firebase Android BoM จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

dependencies {
  // Add the dependency for the Firebase AI Logic library
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:17.6.0")
}

Java

Firebase AI Logic SDK สำหรับ Android (firebase-ai) ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini และ Imagen

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (เช่น <project>/<app-module>/build.gradle.kts) ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Firebase AI Logic สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการกำหนดเวอร์ชันของไลบรารี

สำหรับ Java คุณต้องเพิ่มไลบรารีอีก 2 รายการ

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.6.0"))

  // Add the dependency for the Firebase AI Logic library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

การใช้ Firebase Android BoM จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

dependencies {
  // Add the dependency for the Firebase AI Logic library
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:17.6.0")
}

Web

Firebase AI Logic ไลบรารีช่วยให้เข้าถึง API เพื่อโต้ตอบกับโมเดล Gemini และ Imagen ได้ ไลบรารีนี้รวมอยู่ ใน Firebase JavaScript SDK สำหรับเว็บ

1. ติดตั้ง Firebase JS SDK สำหรับเว็บโดยใช้ npm ดังนี้

   npm install firebase
   

2. เริ่มต้น Firebase ในแอป

   import { initializeApp } from "firebase/app";
   
   // TODO(developer) Replace the following with your app's Firebase configuration
   // See: https://firebase.google.com/docs/web/learn-more#config-object
   const firebaseConfig = {
     // ...
   };
   
   // Initialize FirebaseApp
   const firebaseApp = initializeApp(firebaseConfig);
   

Dart

Firebase AI Logic ปลั๊กอินสำหรับ Flutter (firebase_ai) ช่วยให้เข้าถึง API เพื่อโต้ตอบกับโมเดล Gemini และ Imagen ได้

1. จากไดเรกทอรีโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อ ติดตั้งปลั๊กอินหลักและปลั๊กอิน Firebase AI Logic

   flutter pub add firebase_core firebase_ai
   

2. ในไฟล์ lib/main.dart ให้นำเข้าปลั๊กอินหลักของ Firebase, ปลั๊กอิน Firebase AI Logic และไฟล์กำหนดค่าที่คุณสร้างไว้ ก่อนหน้านี้

   import 'package:firebase_core/firebase_core.dart';
   import 'package:firebase_ai/firebase_ai.dart';
   import 'firebase_options.dart';
   

3. นอกจากนี้ ในไฟล์ lib/main.dart ให้เริ่มต้น Firebase โดยใช้ออบเจ็กต์ DefaultFirebaseOptions ที่ส่งออกจากไฟล์การกำหนดค่า

   await Firebase.initializeApp(
     options: DefaultFirebaseOptions.currentPlatform,
   );
   

4. สร้างแอปพลิเคชัน Flutter อีกครั้ง

   flutter run
   

Unity

SDK ของไคลเอ็นต์ Google AI ไม่รองรับ Unity

ดูวิธี เริ่มต้นใช้งาน Firebase AI Logic SDK สำหรับ Unity

Swift

นำคลังเก่าออก

1. เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่แผงการอ้างอิงแพ็กเกจ

2. เลือกแพ็กเกจ generative-ai-swift จากรายการแพ็กเกจ การอ้างอิง

3. คลิกปุ่ม - จากด้านล่างของรายการ แล้วคลิกนำออก เพื่อยืนยัน

Kotlin

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Java

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Web

// BEFORE
import { initializeApp } from "firebase/app";
import { GoogleGenerativeAI } from "@google/generative-ai";

Dart

ลบแพ็กเกจเก่า
flutter pub remove google_generative_ai

Unity

SDK ของไคลเอ็นต์ Google AI ไม่รองรับ Unity

ดูวิธี เริ่มต้นใช้งาน Firebase AI Logic SDK สำหรับ Unity

Swift

// BEFORE
import GoogleGenerativeAI

let model = GenerativeModel(name: "MODEL_NAME", apiKey: APIKey.default)

// AFTER
import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.5-flash")

Kotlin

// BEFORE
import com.google.ai.client.generativeai.Chat
import com.google.ai.client.generativeai.type.Content
import com.google.ai.client.generativeai.java.GenerativeModuleFutures

...

val generativeModel = GenerativeModel(modelName = "MODEL_NAME",
  // Access your API key as a Build Configuration variable
  apiKey = BuildConfig.apiKey
)

// AFTER
import com.google.firebase.Firebase
import com.google.firebase.ai.ai
import com.google.firebase.ai.type.GenerativeBackend

...

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-2.5-flash")

Java

// BEFORE
import com.google.ai.client.generativeai.Chat;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.java.GenerativeModuleFutures;

...

GenerativeModel gm = new GenerativeModel("MODEL_NAME",
  // Access your API key as a Build Configuration variable
  BuildConfig.apiKey
);

GenerativeModelFutures model = GenerativeModelFutures.from(gm);

// AFTER
import com.google.firebase.ai.FirebaseAI;
import com.google.firebase.ai.GenerativeModel;
import com.google.firebase.ai.java.GenerativeModelFutures;
import com.google.firebase.ai.type.GenerativeBackend;

...

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-2.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web

// BEFORE
import { GoogleGenerativeAI } from "@google/generative-ai";

// Fetch your API_KEY and access your API
const API_KEY = "...";
const genAI = new GoogleGenerativeAI(API_KEY);

...

const model = genAI.getGenerativeModel({ model: "MODEL_NAME"});

// AFTER
import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.5-flash" });

Dart

// BEFORE
import 'package:google_generative_ai/google_generative_ai.dart';

final apiKey = Platform.environment['API_KEY'];
if (apiKey == null) {
print('No \$API_KEY environment variable');
exit(1);
}

final model = GenerativeModel(model: 'MODEL_NAME', apiKey: apiKey);

// AFTER
import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-2.5-flash');

Unity

SDK ของไคลเอ็นต์ Google AI ไม่รองรับ Unity

ดูวิธี เริ่มต้นใช้งาน Firebase AI Logic SDK สำหรับ Unity

Swift

• การแจงนับ

  • แทนที่enumส่วนใหญ่ด้วยstructที่มีตัวแปรแบบคงที่ การเปลี่ยนแปลงนี้ช่วยให้มีความยืดหยุ่นมากขึ้นในการพัฒนา API ในลักษณะที่เข้ากันได้แบบย้อนหลัง เมื่อใช้คำสั่ง switch คุณต้อง รวมเคส default: เพื่อครอบคลุมค่าที่ไม่รู้จักหรือค่าที่ไม่ได้จัดการ รวมถึงค่าใหม่ที่จะเพิ่มลงใน SDK ในอนาคต

  • เปลี่ยนชื่อการแจงนับ BlockThreshold เป็น HarmBlockThreshold แล้ว ตอนนี้ประเภทนี้เป็น struct แล้ว

  • นำเคส unknown และ unspecified ออกจากการแจงนับต่อไปนี้ (ตอนนี้คือ struct): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason และ FinishReason

  • แทนที่การแจงนับ ModelContent.Part ด้วยโปรโตคอลชื่อ Part เพื่อให้เพิ่มประเภทใหม่ได้ในลักษณะที่เข้ากันได้แบบย้อนหลัง การเปลี่ยนแปลงนี้ อธิบายไว้อย่างละเอียดในส่วนชิ้นส่วนเนื้อหา

• ส่วนเนื้อหา

  • นำโปรโตคอล ThrowingPartsRepresentable ออก และลดความซับซ้อนของ ตัวเริ่มต้นสำหรับ ModelContent เพื่อหลีกเลี่ยงข้อผิดพลาดของคอมไพเลอร์ที่เกิดขึ้นเป็นครั้งคราว รูปภาพที่เข้ารหัสไม่ถูกต้องจะยังคงแสดงข้อผิดพลาดเมื่อนำไปใช้ใน generateContent

  • แทนที่เคส ModelContent.Part ด้วยเคสประเภท struct ต่อไปนี้ ซึ่งเป็นไปตามโปรโตคอล Part

    • .text ไปยัง TextPart
    • .data ไปยัง InlineDataPart
    • .fileData ไปยัง FileDataPart
    • .functionCall ไปยัง FunctionCallPart
    • .functionResponse ไปยัง FunctionResponsePart

• หมวดหมู่ความเสี่ยง

  • เปลี่ยน HarmCategory เพื่อไม่ให้ซ้อนอยู่ในประเภท SafetySetting อีกต่อไป หากคุณอ้างอิงถึง SafetySetting.HarmCategory คุณสามารถแทนที่ด้วย HarmCategory ได้

• ความคิดเห็นด้านความปลอดภัย

  • นำประเภท SafetyFeedback ออกเนื่องจากไม่ได้ใช้ในคำตอบใดๆ

• ข้อมูลเมตาของการอ้างอิง

  • เปลี่ยนชื่อพร็อพเพอร์ตี้ citationSources เป็น citations ใน CitationMetadata

• อักขระที่เรียกเก็บเงินได้ทั้งหมด

  • เปลี่ยนพร็อพเพอร์ตี้ totalBillableCharacters ใน CountTokensResponse ให้เป็นแบบไม่บังคับเพื่อแสดงถึงสถานการณ์ที่ไม่มีการส่งอักขระ

• การตอบกลับของผู้สมัคร

  • เปลี่ยนชื่อ CandidateResponse เป็น Candidate เพื่อให้ตรงกับแพลตฟอร์มอื่นๆ

• การกำหนดค่าการสร้าง

  • เปลี่ยนพร็อพเพอร์ตี้สาธารณะของ GenerationConfig เป็น internal โดยคุณยังคงกำหนดค่าได้ทั้งหมดในตัวเริ่มต้น

Kotlin

• การแจงนับ

  • แทนที่enumชั้นเรียนและsealedชั้นเรียนด้วยชั้นเรียนปกติ การเปลี่ยนแปลงนี้ช่วยให้มีความยืดหยุ่นมากขึ้นในการพัฒนา API ในลักษณะที่เข้ากันได้แบบย้อนหลัง

  • เปลี่ยนชื่อการแจงนับ BlockThreshold เป็น HarmBlockThreshold

  • นำค่าออกจากรายการต่อไปนี้ HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason และ FinishReason

• เมธอด Blob

  • เปลี่ยนชื่อเมธอดทั้งหมดที่มี Blob เป็นส่วนหนึ่งของชื่อให้ใช้ InlineData แทน

• การตั้งค่าความปลอดภัย

  • เปลี่ยนฟิลด์ method ให้เป็นค่า Null ได้

• คลาสระยะเวลา

  • นำการใช้งานคลาส Duration ของ Kotlin ทั้งหมดออกและแทนที่ด้วย long การเปลี่ยนแปลงนี้จะช่วยให้ทำงานร่วมกับ Java ได้ดียิ่งขึ้น

• ข้อมูลเมตาของการอ้างอิง

  • รวมฟิลด์ทั้งหมดที่ประกาศไว้ก่อนหน้านี้ใน CitationMetadata ไว้ใน คลาสใหม่ที่ชื่อ Citation คุณดูการอ้างอิงได้ในรายการที่ชื่อ citations ใน CitationMetadata การเปลี่ยนแปลงนี้ช่วยให้ประเภทต่างๆ สอดคล้องกันมากขึ้นในแพลตฟอร์มต่างๆ

• นับโทเค็น

  • เปลี่ยนฟิลด์ totalBillableCharacters ให้เป็นค่า Null ได้

• อักขระที่เรียกเก็บเงินได้ทั้งหมด

  • เปลี่ยนพร็อพเพอร์ตี้ totalBillableCharacters ใน CountTokensResponse ให้เป็นแบบไม่บังคับเพื่อแสดงถึงสถานการณ์ที่ไม่มีการส่งอักขระ

• การสร้างอินสแตนซ์ของโมเดล

  • ย้ายพารามิเตอร์ requestOptions ไปไว้ท้ายรายการพารามิเตอร์เพื่อ ให้สอดคล้องกับแพลตฟอร์มอื่นๆ

Java

• การแจงนับ

  • แทนที่enumชั้นเรียนและsealedชั้นเรียนด้วยชั้นเรียนปกติ การเปลี่ยนแปลงนี้ช่วยให้มีความยืดหยุ่นมากขึ้นในการพัฒนา API ในลักษณะที่เข้ากันได้แบบย้อนหลัง

  • เปลี่ยนชื่อการแจงนับ BlockThreshold เป็น HarmBlockThreshold

  • นำค่าออกจากรายการต่อไปนี้ HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason และ FinishReason

• เมธอด Blob

  • เปลี่ยนชื่อเมธอดทั้งหมดที่มี Blob เป็นส่วนหนึ่งของชื่อให้ใช้ InlineData แทน

• การตั้งค่าความปลอดภัย

  • เปลี่ยนฟิลด์ method ให้เป็นค่า Null ได้

• คลาสระยะเวลา

  • นำการใช้งานคลาส Duration ของ Kotlin ทั้งหมดออกและแทนที่ด้วย long การเปลี่ยนแปลงนี้จะช่วยให้ทำงานร่วมกับ Java ได้ดียิ่งขึ้น

• ข้อมูลเมตาของการอ้างอิง

  • รวมฟิลด์ทั้งหมดที่ประกาศไว้ก่อนหน้านี้ใน CitationMetadata ไว้ใน คลาสใหม่ที่ชื่อ Citation คุณดูการอ้างอิงได้ในรายการที่ชื่อ citations ใน CitationMetadata การเปลี่ยนแปลงนี้ช่วยให้ประเภทต่างๆ สอดคล้องกันมากขึ้นในแพลตฟอร์มต่างๆ

• นับโทเค็น

  • เปลี่ยนฟิลด์ totalBillableCharacters ให้เป็นค่า Null ได้

• อักขระที่เรียกเก็บเงินได้ทั้งหมด

  • เปลี่ยนพร็อพเพอร์ตี้ totalBillableCharacters ใน CountTokensResponse ให้เป็นแบบไม่บังคับเพื่อแสดงถึงสถานการณ์ที่ไม่มีการส่งอักขระ

• การสร้างอินสแตนซ์ของโมเดล

  • ย้ายพารามิเตอร์ requestOptions ไปไว้ท้ายรายการพารามิเตอร์เพื่อ ให้สอดคล้องกับแพลตฟอร์มอื่นๆ

Web

โปรดทราบว่า Google AIClient SDK สำหรับ JavaScript มีการเปลี่ยนแปลงหลายอย่าง นับตั้งแต่เวลาที่ Firebase AI LogicClient SDK แยกสาขาออกมา รายการต่อไปนี้คือการเปลี่ยนแปลงที่อาจเกิดขึ้นซึ่งคุณอาจต้องพิจารณาเมื่อ ย้ายข้อมูลไปยังFirebase AI Logic SDK ของไคลเอ็นต์

• การแจงนับ

  • นำค่าออกจากรายการต่อไปนี้ HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason และ FinishReason

• เหตุผลในการบล็อก

  • เปลี่ยน blockReason ใน PromptFeedback เป็นตัวเลือก

• การอ้างอิงการค้นหา

  • นำการใช้งานฟีเจอร์นี้ทั้งหมดออก เนื่องจาก SDK ของ Firebase AI Logic ยังไม่รองรับ

• ข้อผิดพลาด

  • นำการใช้งาน GoogleGenerativeAIError ทั้งหมดออก และย้ายไปใช้ AIError (ไม่บังคับ)

Dart

• การแจงนับ

  • นำค่าออกจากรายการต่อไปนี้ HarmCategory, HarmProbability, BlockReason และ FinishReason

• ส่วนข้อมูล

  • เปลี่ยนชื่อ DataPart เป็น InlineDataPart และฟังก์ชัน static data เป็น inlineData เพื่อให้สอดคล้องกับแพลตฟอร์มอื่นๆ

• ตัวเลือกคำขอ

  • นำ RequestOptions ออกเนื่องจาก timeout ใช้งานไม่ได้ เราจะเพิ่มฟีเจอร์นี้กลับมาในอนาคตอันใกล้ แต่จะย้ายไปอยู่ในประเภทGenerativeModelเพื่อให้ตรงกับแพลตฟอร์มอื่นๆ

• หยุดลำดับ

  • เปลี่ยนพารามิเตอร์ stopSequences ใน GenerationConfig ให้เป็น ไม่บังคับและตั้งค่าเริ่มต้นเป็น null แทนที่จะเป็นอาร์เรย์ว่าง

• การอ้างอิง

  • เปลี่ยนชื่อพร็อพเพอร์ตี้ citationSources เป็น citations ใน CitationMetadata เราได้เปลี่ยนชื่อประเภท CitationSource เป็น Citation เพื่อให้สอดคล้องกับแพลตฟอร์มอื่นๆ

• ประเภท เมธอด และพร็อพเพอร์ตี้สาธารณะที่ไม่จำเป็น

  • นำประเภท เมธอด และพร็อพเพอร์ตี้ต่อไปนี้ออกเนื่องจาก มีการเปิดเผยโดยไม่ตั้งใจ ได้แก่ defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest, และ EmbedContentResponse

• นับโทเค็น

  • นำฟิลด์พิเศษออกจากฟังก์ชัน countTokens ซึ่งไม่จำเป็นอีกต่อไป โดยมีเพียง contents เท่านั้นที่จำเป็น

• การสร้างอินสแตนซ์ของโมเดล

  • ย้ายพารามิเตอร์ systemInstruction ไปไว้ท้ายรายการพารามิเตอร์ เพื่อให้สอดคล้องกับแพลตฟอร์มอื่นๆ

• ฟังก์ชันการฝัง

  • นำฟังก์ชันการฝังที่ไม่รองรับ (embedContent และ batchEmbedContents) ออกจากโมเดล

Unity

SDK ของไคลเอ็นต์ Google AI ไม่รองรับ Unity

ดูวิธี เริ่มต้นใช้งาน Firebase AI Logic SDK สำหรับ Unity