เหตุใดจึงควรย้ายข้อมูลไปใช้ 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 และเชื่อมต่อแอป
ลงชื่อเข้าใช้คอนโซล Firebase แล้วเลือกโปรเจ็กต์ Firebase
ในคอนโซล Firebase ให้ไปที่บริการ AI > AI Logic
คลิกเริ่มต้นใช้งานเพื่อเปิดเวิร์กโฟลว์ที่มีคำแนะนำซึ่งจะช่วยคุณตั้งค่า API ที่จำเป็นและทรัพยากรสำหรับโปรเจ็กต์
เลือก Gemini Developer API คุณตั้งค่าและใช้ผู้ให้บริการ API รายอื่นในภายหลังได้ทุกเมื่อหากต้องการ
คอนโซลจะเปิดใช้ API ที่จำเป็นและสร้างคีย์ API Gemini ใหม่โดยเฉพาะในโปรเจ็กต์ของคุณ
อย่าเพิ่มคีย์ API Gemini ใหม่นี้ลงในฐานของโค้ดของแอป ดูข้อมูลเพิ่มเติมหากได้รับข้อความแจ้งในเวิร์กโฟลว์ของคอนโซล ให้ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนแอปและเชื่อมต่อกับ Firebase
อ่านคำแนะนำในการย้ายข้อมูลนี้ต่อเพื่ออัปเดตไลบรารีและการเริ่มต้นในแอป
ขั้นตอนที่ 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 ขึ้นไป
ใน Xcode ขณะที่โปรเจ็กต์แอปเปิดอยู่ ให้ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ
เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK ของ Firebase สำหรับแพลตฟอร์ม Apple ดังนี้
https://github.com/firebase/firebase-ios-sdkเลือก SDK เวอร์ชันล่าสุด
เลือกไลบรารี
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 สำหรับเว็บ
ติดตั้ง Firebase JS SDK สำหรับเว็บโดยใช้ npm:
npm install firebaseเริ่มต้น 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
จากไดเรกทอรีโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งปลั๊กอิน Firebase AI Logic และ App Check
flutter pub add firebase_ai firebase_app_checkในไฟล์
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';นอกจากนี้ ในไฟล์
lib/main.dartให้ตรวจสอบว่าคุณได้เริ่มต้น Firebase โดยใช้ออบเจ็กต์DefaultFirebaseOptionsที่ส่งออกโดยไฟล์การกำหนดค่า ดังนี้await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );สร้างแอปพลิเคชัน Flutter อีกครั้งโดยทำดังนี้
flutter run
Unity
SDK ของไคลเอ็นต์ Google AI ไม่รองรับ Unity
นำ SDK เก่าออกจากแอป
หลังจากย้ายข้อมูลแอปเสร็จแล้ว (ดูส่วนที่เหลือในคู่มือนี้) อย่าลืมลบคลังเก่า
Swift
นำไลบรารีเก่าออกโดยทำดังนี้
ใน Xcode ขณะที่โปรเจ็กต์แอปเปิดอยู่ ให้ไปที่แผงทรัพยากร Dependency ของแพ็กเกจ
เลือกแพ็กเกจ
generative-ai-swiftจากรายการทรัพยากร Dependency ของแพ็กเกจคลิกปุ่ม
-จากด้านล่างของรายการ แล้วคลิกนำออกเพื่อยืนยัน
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
ขั้นตอนที่ 3: อัปเดตการนําเข้าและการเริ่มต้นในแอป
อัปเดตการนําเข้าและวิธีเริ่มต้นบริการแบ็กเอนด์ Gemini Developer API และสร้างอินสแตนซ์ GenerativeModel
Swift
// BEFOREimport 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
// BEFOREimport 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
// BEFOREimport 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
// BEFOREimport { 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
// BEFOREimport '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
โปรดทราบว่าคุณอาจไม่ได้สร้างอินสแตนซ์ GenerativeModel เสมอไป ทั้งนี้ขึ้นอยู่กับความสามารถที่คุณใช้ หากต้องการสตรีมอินพุตและเอาต์พุตโดยใช้ Gemini Live API ให้สร้างอินสแตนซ์ LiveModel
ขั้นตอนที่ 4: อัปเดตโค้ดตามฟีเจอร์ที่คุณใช้
ขั้นตอนนี้อธิบายการเปลี่ยนแปลงที่อาจจำเป็นต้องทำ ทั้งนี้ขึ้นอยู่กับฟีเจอร์ที่คุณใช้
SDK ของไคลเอ็นต์ Firebase AI Logic ไม่รองรับการเรียกใช้โค้ด หากใช้ฟีเจอร์นี้ โปรดตรวจสอบว่าได้รองรับฟีเจอร์นี้ในแอปของคุณแล้ว
ตรวจสอบรายการต่อไปนี้เพื่อดูการเปลี่ยนแปลงที่คุณอาจต้องทำในโค้ดเพื่อรองรับการย้ายข้อมูลไปยัง SDK ของไคลเอ็นต์ Firebase AI Logic
ต้องระบุสำหรับทุกภาษาและแพลตฟอร์ม
การเรียกใช้ฟังก์ชัน
หากใช้ฟีเจอร์นี้ คุณจะต้องอัปเดตวิธีกำหนดสคีมา เราขอแนะนำให้อ่านคู่มือการเรียกใช้ฟังก์ชันที่อัปเดตแล้วเพื่อดูวิธีเขียนการประกาศฟังก์ชันการสร้างเอาต์พุตที่มีโครงสร้าง (เช่น JSON) โดยใช้
responseSchema
หากใช้ฟีเจอร์นี้ คุณจะต้องอัปเดตวิธีกำหนดสคีมา เราขอแนะนำให้อ่านคู่มือเอาต์พุตที่มีโครงสร้างใหม่เพื่อดูวิธีเขียนสคีมา JSONTimeout
- เปลี่ยนระยะหมดเวลาเริ่มต้นสำหรับคำขอเป็น 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และเปลี่ยนชื่อฟังก์ชันstaticdataเป็น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