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


ไปที่วิธีการย้ายข้อมูลโดยตรง

เหตุใดจึงควรย้ายข้อมูลไปใช้ SDK ของ Firebase AI Logic

คุณอาจเคยลองใช้ SDK ไคลเอ็นต์บนอุปกรณ์เคลื่อนที่หรือเว็บชุดอื่นที่ให้สิทธิ์เข้าถึง Gemini Developer API

SDK ของไคลเอ็นต์เหล่านั้นไม่ได้ผสานรวมเข้ากับระบบนิเวศ Firebase ที่มีประสิทธิภาพซึ่งให้บริการที่สำคัญสำหรับแอปบนอุปกรณ์เคลื่อนที่และเว็บแอป ตอนนี้เราเลิกใช้งาน API ดังกล่าวแล้วและเปลี่ยนไปใช้ SDK ของไคลเอ็นต์ Firebase AI Logic ซึ่งช่วยให้คุณเข้าถึง Gemini Developer API ได้

ฟีเจอร์ความปลอดภัยสำหรับแอปบนอุปกรณ์เคลื่อนที่และเว็บแอป

สำหรับแอปบนอุปกรณ์เคลื่อนที่และเว็บแอป ความปลอดภัยเป็นสิ่งสำคัญและต้องพิจารณาเป็นพิเศษเนื่องจากโค้ดของคุณ ซึ่งรวมถึงการเรียกใช้ Gemini API ทำงานในสภาพแวดล้อมที่ไม่มีการป้องกัน คุณสามารถใช้ Firebase App Check เพื่อปกป้อง API จากการละเมิดโดยไคลเอ็นต์ที่ไม่ได้รับอนุญาต

เมื่อคุณใช้ Firebase App Check กับ Firebase AI Logic คุณจะไม่เพิ่มคีย์ API ของ Gemini สำหรับ Gemini Developer API ลงในฐานของโค้ดของแอปบนอุปกรณ์เคลื่อนที่หรือเว็บแอปโดยตรง แต่คีย์ API ของ Gemini จะยังคงอยู่ในเซิร์ฟเวอร์ โดยไม่เปิดเผยต่อผู้ไม่ประสงค์ดี

ระบบนิเวศที่สร้างขึ้นสำหรับแอปบนอุปกรณ์เคลื่อนที่และเว็บแอป

Firebase เป็นแพลตฟอร์มของ Google สำหรับการพัฒนาแอปบนอุปกรณ์เคลื่อนที่และเว็บแอป การใช้ Firebase AI Logic หมายความว่าแอปของคุณอยู่ในระบบนิเวศที่มุ่งเน้นความต้องการของแอปและนักพัฒนาแอปแบบฟูลสแต็ก เช่น

  • ตั้งค่าการกำหนดค่ารันไทม์แบบไดนามิกหรือสลับค่าในแอป (เช่น ชื่อและเวอร์ชันของโมเดล) โดยไม่ต้องเปิดตัวแอปเวอร์ชันใหม่โดยใช้ Firebase Remote Config

  • ใช้ Cloud Storage for Firebase เพื่อรวมไฟล์ขนาดใหญ่ไว้ในคำขอแบบหลายโมดัล (หากคุณใช้ Agent Platform Gemini API (formerly Vertex AI)) SDK ของไคลเอ็นต์ Cloud Storage จะช่วยคุณจัดการการอัปโหลดและดาวน์โหลดไฟล์ (แม้ในสภาพเครือข่ายที่ไม่ดี) และเพิ่มความปลอดภัยให้กับข้อมูลของผู้ใช้ปลายทาง ดูข้อมูลเพิ่มเติมในคู่มือโซลูชันเกี่ยวกับการใช้ Cloud Storage for Firebase

  • จัดการข้อมูลที่มีโครงสร้างโดยใช้ SDK ฐานข้อมูลที่สร้างขึ้นสำหรับแอปบนอุปกรณ์เคลื่อนที่และเว็บแอป (เช่น Cloud Firestore)

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

ภาพรวมของขั้นตอนการย้ายข้อมูลไปยัง SDK ของ Firebase AI Logic มีดังนี้

  • ขั้นตอนที่ 1: ตั้งค่าโปรเจ็กต์ Firebase ใหม่หรือที่มีอยู่ แล้วเชื่อมต่อแอปกับ Firebase

  • ขั้นตอนที่ 2: เพิ่ม SDK ของ Firebase AI Logic ลงในแอป

  • ขั้นตอนที่ 3: อัปเดตการนําเข้าและการเริ่มต้นในแอป

  • ขั้นตอนที่ 4: อัปเดตโค้ดตามฟีเจอร์ที่คุณใช้

ขั้นตอนที่ 1: ตั้งค่าโปรเจ็กต์ Firebase และเชื่อมต่อแอป

  1. ลงชื่อเข้าใช้คอนโซล Firebase แล้วเลือกโปรเจ็กต์ Firebase

  2. ในคอนโซล Firebase ให้ไปที่บริการ AI > AI Logic

  3. คลิกเริ่มต้นใช้งานเพื่อเปิดเวิร์กโฟลว์ที่มีคำแนะนำซึ่งจะช่วยคุณตั้งค่า API ที่จำเป็นและทรัพยากรสำหรับโปรเจ็กต์

  4. เลือก Gemini Developer API คุณตั้งค่าและใช้ผู้ให้บริการ API รายอื่นในภายหลังได้ทุกเมื่อหากต้องการ

    คอนโซลจะเปิดใช้ API ที่จำเป็นและสร้างคีย์ API Gemini ใหม่โดยเฉพาะในโปรเจ็กต์ของคุณ
    อย่าเพิ่มคีย์ API Gemini ใหม่นี้ลงในฐานของโค้ดของแอป ดูข้อมูลเพิ่มเติม

  5. หากได้รับข้อความแจ้งในเวิร์กโฟลว์ของคอนโซล ให้ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนแอปและเชื่อมต่อกับ Firebase

  6. อ่านคำแนะนำในการย้ายข้อมูลนี้ต่อเพื่ออัปเดตไลบรารีและการเริ่มต้นในแอป

ขั้นตอนที่ 2: เพิ่ม SDK ของ Firebase AI Logic ลงในแอป

เมื่อตั้งค่าโปรเจ็กต์ Firebase และเชื่อมต่อแอปกับ Firebase แล้ว (ดูขั้นตอนก่อนหน้า) คุณจะเพิ่ม SDK ของ Firebase AI Logic ลงในแอปได้

Swift

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase ดูข้อมูลเกี่ยวกับตัวเลือกการติดตั้งอื่นๆ หากจำเป็น

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

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

  1. ใน Xcode ขณะที่โปรเจ็กต์แอปเปิดอยู่ ให้ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ

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

    https://github.com/firebase/firebase-ios-sdk
    
  3. เลือก SDK เวอร์ชันล่าสุด

  4. เลือกไลบรารี FirebaseAILogic และไลบรารี FirebaseAppCheck

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

Kotlin

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

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

dependencies {
  // ... other androidx dependencies

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

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

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

Java

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

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

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

dependencies {
  // ... other androidx dependencies

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

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

  // 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 เวอร์ชันที่เข้ากันได้อยู่เสมอ

Web

ไลบรารี Firebase AI Logic ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini ไลบรารีนี้รวมอยู่ใน Firebase JavaScript SDK สำหรับเว็บ

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

    npm install firebase
    
  2. เริ่มต้น Firebase ในแอปโดยทำดังนี้

    import { initializeApp } from "firebase/app";
    import { initializeAppCheck, DebugProvider } from "firebase/app-check";
    
    // 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

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

    flutter pub add firebase_ai firebase_app_check
    
  2. ในไฟล์ lib/main.dart ให้นำเข้าปลั๊กอิน Firebase AI Logic และ App Check ดังนี้

    import 'package:firebase_core/firebase_core.dart';
    import 'package:firebase_ai/firebase_ai.dart';
    import 'package:firebase_app_check/firebase_app_check.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

นำ SDK เก่าออกจากแอป

หลังจากย้ายข้อมูลแอปเสร็จแล้ว (ดูส่วนที่เหลือในคู่มือนี้) อย่าลืมลบคลังเก่า

Swift

นำไลบรารีเก่าออกโดยทำดังนี้

  1. ใน Xcode ขณะที่โปรเจ็กต์แอปเปิดอยู่ ให้ไปที่แผงทรัพยากร Dependency ของแพ็กเกจ

  2. เลือกแพ็กเกจ generative-ai-swift จากรายการทรัพยากร Dependency ของแพ็กเกจ

  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

ขั้นตอนที่ 3: อัปเดตการนําเข้าและการเริ่มต้นในแอป

อัปเดตการนําเข้าและวิธีเริ่มต้นบริการแบ็กเอนด์ Gemini Developer API และสร้างอินสแตนซ์ GenerativeModel

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-4-hydrogen")

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-4-hydrogen")

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-4-hydrogen");

// 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-4-hydrogen" });

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-4-hydrogen');

Unity

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

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

โปรดทราบว่าคุณอาจไม่ได้สร้างอินสแตนซ์ GenerativeModel เสมอไป ทั้งนี้ขึ้นอยู่กับความสามารถที่คุณใช้ หากต้องการสตรีมอินพุตและเอาต์พุตโดยใช้ Gemini Live API ให้สร้างอินสแตนซ์ LiveModel

ขั้นตอนที่ 4: อัปเดตโค้ดตามฟีเจอร์ที่คุณใช้

ขั้นตอนนี้อธิบายการเปลี่ยนแปลงที่อาจจำเป็นต้องทำ ทั้งนี้ขึ้นอยู่กับฟีเจอร์ที่คุณใช้

  • SDK ของไคลเอ็นต์ Firebase AI Logic ไม่รองรับการเรียกใช้โค้ด หากใช้ฟีเจอร์นี้ โปรดตรวจสอบว่าได้รองรับฟีเจอร์นี้ในแอปของคุณแล้ว

  • ตรวจสอบรายการต่อไปนี้เพื่อดูการเปลี่ยนแปลงที่คุณอาจต้องทำในโค้ดเพื่อรองรับการย้ายข้อมูลไปยัง SDK ของไคลเอ็นต์ Firebase AI Logic

ต้องระบุสำหรับทุกภาษาและแพลตฟอร์ม

  • การเรียกใช้ฟังก์ชัน
    หากใช้ฟีเจอร์นี้ คุณจะต้องอัปเดตวิธีกำหนดสคีมา เราขอแนะนำให้อ่านคู่มือการเรียกใช้ฟังก์ชันที่อัปเดตแล้วเพื่อดูวิธีเขียนการประกาศฟังก์ชัน

  • การสร้างเอาต์พุตที่มีโครงสร้าง (เช่น JSON) โดยใช้ responseSchema
    หากใช้ฟีเจอร์นี้ คุณจะต้องอัปเดตวิธีกำหนดสคีมา เราขอแนะนำให้อ่านคู่มือเอาต์พุตที่มีโครงสร้างใหม่เพื่อดูวิธีเขียนสคีมา JSON

  • Timeout

    • เปลี่ยนระยะหมดเวลาเริ่มต้นสำหรับคำขอเป็น 180 วินาที

ต้องระบุตามแพลตฟอร์มหรือภาษา

Swift

  • การแจงนับ

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

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

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

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

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

    • นำโปรโตคอล ThrowingPartsRepresentable ออก และลดความซับซ้อนของ Initializer สำหรับ 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

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

  • การแจงนับ

    • นำค่าออกจากรายการต่อไปนี้: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason และ FinishReason
  • เหตุผลในการบล็อก

    • เปลี่ยน blockReason ใน PromptFeedback เป็นไม่บังคับแล้ว
  • การอ้างอิงข้อมูลใน Search

    • นำการใช้งานฟีเจอร์นี้ทั้งหมดออก เนื่องจาก 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


แสดงความคิดเห็นเกี่ยวกับประสบการณ์การใช้งาน Firebase AI Logic