ย้ายข้อมูลเพื่อใช้ Vertex AI เวอร์ชัน GA ใน Firebase


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 (จำเป็นสำหรับทุกคน)

คุณต้องเปิดใช้ Vertex AI in Firebase API ในโปรเจ็กต์ Firebase และเพิ่มลงในรายการที่อนุญาตของคีย์ Firebase API ซึ่งเป็น API ใหม่ที่จําเป็นต่อการใช้ Vertex AI in Firebase เวอร์ชัน GA

  1. ในคอนโซล Firebase ให้ไปที่หน้าสร้างด้วย Gemini

  2. ในการ์ด Vertex AI in Firebase ให้คลิกเริ่มต้นใช้งานเพื่อเปิดใช้งานเวิร์กโฟลว์ที่ช่วยให้คุณเปิดใช้ API นี้และเพิ่มลงในรายการที่อนุญาตของคีย์ Firebase API

  3. คุณข้ามเวิร์กโฟลว์ที่เหลือได้ในคอนโซล

อัปเดตเป็นไลบรารีเวอร์ชัน GA (ต้องดำเนินการสำหรับทุกคน)

ทําตามวิธีการเหล่านี้เพื่ออัปเดตทรัพยากร Firebase Android BoM เป็นเวอร์ชันล่าสุด คุณไม่จำเป็นต้องใช้ BoM แต่เราขอแนะนำอย่างยิ่งให้ใช้ เนื่องจากจะช่วยให้มั่นใจได้ว่าแอปของคุณใช้ไลบรารี Firebase แต่ละรายการในเวอร์ชันที่เข้ากันได้

  1. ในไฟล์ 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")
    }
  2. ซิงค์โปรเจ็กต์ 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