Vertex AI in Firebase เปิดตัวเวอร์ชันสำหรับผู้ใช้ทั่วไป (GA) ในวันที่ 21 ตุลาคม 2024
หากคุณใช้ไลบรารี Vertex AI in Firebase เวอร์ชันเบต้า (firebase-vertexai:16.0.0-betaXX
) คุณต้องทําการเปลี่ยนแปลงต่อไปนี้เพื่ออัปเกรดไปใช้ไลบรารีเวอร์ชัน GA (firebase-vertexai:16.0.0
ขึ้นไป)
รายการการเปลี่ยนแปลงระดับสูงที่จําเป็นสําหรับการย้ายข้อมูลมีดังนี้
- เปิดใช้ API ใหม่ที่จําเป็นในโปรเจ็กต์ Firebase (จําเป็นสําหรับทุกคน)
- อัปเดตเป็นไลบรารีเวอร์ชัน GA (จำเป็นสำหรับทุกคน)
- การเปลี่ยนแปลงเพิ่มเติม (ต้องระบุโดยขึ้นอยู่กับฟีเจอร์ที่คุณใช้)
เปิดใช้ API ที่จำเป็นใหม่ในโปรเจ็กต์ Firebase (จำเป็นสำหรับทุกคน)
คุณต้องเปิดใช้ Vertex AI in Firebase API ในโปรเจ็กต์ Firebase และเพิ่มลงในรายการที่อนุญาตของคีย์ Firebase API ซึ่งเป็น API ใหม่ที่จําเป็นต่อการใช้ Vertex AI in Firebase เวอร์ชัน GA
ในคอนโซล Firebase ให้ไปที่หน้าสร้างด้วย Gemini
ในการ์ด Vertex AI in Firebase ให้คลิกเริ่มต้นใช้งานเพื่อเปิดใช้งานเวิร์กโฟลว์ที่ช่วยให้คุณเปิดใช้ API นี้และเพิ่มลงในรายการที่อนุญาตของคีย์ Firebase API
คุณข้ามเวิร์กโฟลว์ที่เหลือได้ในคอนโซล
อัปเดตเป็นไลบรารีเวอร์ชัน GA (ต้องดำเนินการสำหรับทุกคน)
ทําตามวิธีการเหล่านี้เพื่ออัปเดตทรัพยากร Firebase Android BoM เป็นเวอร์ชันล่าสุด คุณไม่จำเป็นต้องใช้ BoM แต่เราขอแนะนำอย่างยิ่งให้ใช้ เนื่องจากจะช่วยให้มั่นใจได้ว่าแอปของคุณใช้ไลบรารี Firebase แต่ละรายการในเวอร์ชันที่เข้ากันได้
ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติจะเป็นไฟล์
<project>/<app-module>/build.gradle.kts
หรือ<project>/<app-module>/build.gradle)
ให้แทนที่ Dependency สำหรับ Vertex AI in Firebase ด้วยข้อมูลต่อไปนี้// BEFORE dependencies {
implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")} // AFTER dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.10.0")) // Add the dependency for the Vertex AI in Firebase library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-vertexai") }ซิงค์โปรเจ็กต์ Android กับไฟล์ Gradle
โปรดทราบว่าหากเลือกไม่ใช้ Firebase BoM ให้ยอมรับ firebase-vertexai
เวอร์ชันล่าสุดที่ Android Studio แนะนำ
การเปลี่ยนแปลงเพิ่มเติม (ต้องระบุโดยขึ้นอยู่กับฟีเจอร์ที่คุณใช้)
มีการใช้การเปลี่ยนแปลงหลายอย่างกับ SDK เวอร์ชัน GA ตรวจสอบรายการต่อไปนี้เพื่อดูการเปลี่ยนแปลงที่คุณอาจต้องทำในโค้ดเพื่อรองรับการใช้ SDK เวอร์ชัน GA ในแอป
การเรียกใช้ฟังก์ชัน
หากใช้ฟีเจอร์นี้ก่อน GA คุณจะต้องอัปเดตวิธีกำหนดสคีมา เราขอแนะนําให้อ่านคู่มือการเรียกใช้ฟังก์ชันที่อัปเดตแล้วเพื่อดูวิธีเขียนประกาศฟังก์ชันการสร้างเอาต์พุตที่มีโครงสร้าง (เช่น JSON) โดยใช้
responseSchema
หากใช้ฟีเจอร์นี้ก่อน GA คุณจะต้องอัปเดตวิธีกำหนดสคีมา เราขอแนะนําให้อ่านคําแนะนําเกี่ยวกับเอาต์พุตที่มีโครงสร้างฉบับใหม่เพื่อดูวิธีเขียนสคีมา JSONระยะหมดเวลา
- เปลี่ยนระยะหมดเวลาเริ่มต้นของคําขอเป็น 180 วินาที
การแจกแจง
แทนที่ชั้นเรียน
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
ไปไว้ที่ท้ายรายการพารามิเตอร์เพื่อให้สอดคล้องกับแพลตฟอร์มอื่นๆ
- ย้ายพารามิเตอร์
ข้อผิดพลาดที่อาจเกิดขึ้นเกี่ยวกับการย้ายข้อมูล
ขณะย้ายข้อมูลเพื่อใช้ Vertex AI in Firebase เวอร์ชัน GA คุณอาจพบข้อผิดพลาดหากยังไม่ได้ทําการเปลี่ยนแปลงที่จําเป็นทั้งหมดตามที่อธิบายไว้ในคู่มือการย้ายข้อมูลนี้
ข้อผิดพลาด 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.
หากได้รับข้อผิดพลาด 403 ที่ระบุว่า Requests to this API firebasevertexai.googleapis.com ... are blocked.
โดยทั่วไปหมายความว่าคีย์ API ในไฟล์/ออบเจ็กต์การกําหนดค่า Firebase ไม่มี API ที่จําเป็นในรายการที่อนุญาตสําหรับผลิตภัณฑ์ที่คุณพยายามใช้
ตรวจสอบว่าคีย์ API ที่แอปของคุณใช้มีAPI ที่จำเป็นทั้งหมดรวมอยู่ในรายการที่อนุญาต "ข้อจำกัด API" ของคีย์ สำหรับ Vertex AI in Firebase คีย์ API ของคุณต้องมี Vertex AI in Firebase API อย่างน้อย 1 รายการในรายการที่อนุญาต API นี้ควรเพิ่มลงในรายการที่อนุญาตของคีย์ API โดยอัตโนมัติเมื่อคุณเปิดใช้ API ใหม่ผ่านคอนโซล Firebase
คุณดูคีย์ API ทั้งหมดได้ในแผงAPI และบริการ > ข้อมูลเข้าสู่ระบบ ในคอนโซล Google Cloud