คู่มือนี้จะแสดงวิธีเริ่มต้นโทรไปยัง Vertex AI Gemini API โดยตรงจากแอปของคุณโดยใช้ Vertex AI สำหรับ Firebase SDK
ข้อกำหนดเบื้องต้น
คู่มือนี้จะถือว่าคุณคุ้นเคยกับการใช้ Xcode เพื่อพัฒนาแอปสำหรับ แพลตฟอร์มของ Apple (เช่น iOS)
ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และแอปแพลตฟอร์ม Apple เป็นไปตาม ข้อกำหนดต่อไปนี้
- Xcode 15.0 ขึ้นไป
- แอปของคุณต้องกําหนดเป้าหมายเป็น iOS 15 ขึ้นไป หรือ macOS 12 ขึ้นไป
(ไม่บังคับ) ดูแอปตัวอย่าง
คุณสามารถลองใช้ SDK ได้อย่างรวดเร็ว ดูการใช้งานหลากหลาย หรือใช้แอปตัวอย่างในกรณีที่ไม่มีแอปแพลตฟอร์ม Apple เป็นของตัวเอง หากต้องการใช้แอปตัวอย่าง คุณจะต้อง เชื่อมต่อกับโปรเจ็กต์ Firebase
ขั้นตอนที่ 1: สร้างโปรเจ็กต์ Firebase และเชื่อมต่อแอปกับ Firebase
หากคุณมีโปรเจ็กต์ Firebase และแอปที่เชื่อมต่อกับ Firebase อยู่แล้ว
ในคอนโซล Firebase ให้ไปที่ส่วน หน้า Build with Gemini แล้วคลิกการ์ดที่ 2 เพื่อเปิดเวิร์กโฟลว์ที่ช่วยให้คุณดำเนินการ งานต่อไปนี้ หากคุณเห็นแท็บในคอนโซลสำหรับ Vertex AI ให้ทำดังนี้ ขั้นตอนเหล่านี้เสร็จสมบูรณ์แล้ว
อัปเกรดโปรเจ็กต์เพื่อใช้ แพ็กเกจราคาแบบจ่ายเมื่อใช้ของ Blaze
เปิดใช้ API 2 รายการต่อไปนี้สำหรับโปรเจ็กต์ของคุณ
aiplatform.googleapis.com
และfirebaseml.googleapis.com
ทำขั้นตอนถัดไปในคู่มือนี้เพื่อเพิ่ม SDK ลงในแอป
หากคุณยังไม่มีโปรเจ็กต์ Firebase และแอปที่เชื่อมต่อกับ Firebase
ขั้นตอนที่ 2: เพิ่ม SDK
เมื่อตั้งค่าโปรเจ็กต์ Firebase และแอปเชื่อมต่อกับ Firebase (ดูขั้นตอนก่อนหน้า) ตอนนี้คุณเพิ่ม Vertex AI สำหรับ Firebase SDK ลงในแอปได้แล้ว
ไลบรารี Vertex AI สำหรับ Firebase ให้สิทธิ์เข้าถึง
Vertex AI Gemini API และรวมอยู่ใน Firebase SDK สำหรับ
แพลตฟอร์ม Apple (firebase-ios-sdk
) สำหรับไลบรารี Vertex AI สำหรับ Firebase
คุณต้องใช้ Swift Package Manager เพื่อติดตั้งและจัดการ Firebase
ทรัพยากร Dependency ผู้จัดการแพ็กเกจอื่นๆ เช่น CocoaPods ยังไม่ได้ใช้งานในขณะนี้
ที่รองรับ
เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ไฟล์ > เพิ่มแพ็กเกจ
เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK สำหรับแพลตฟอร์ม Firebase ของ Apple ดังนี้
https://github.com/firebase/firebase-ios-sdk
เลือก SDK เวอร์ชันล่าสุด
เลือกไลบรารี
FirebaseVertexAI-Preview
เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ปัญหาและดาวน์โหลด ทรัพยากร Dependency ในเบื้องหลัง
ขั้นตอนที่ 3: เริ่มต้นบริการ Vertex AI และโมเดล Generative
ก่อนเรียก API คุณต้องเริ่มต้น Vertex AI และโมเดล Generative
นำเข้าโมดูล
FirebaseVertexAI
:import FirebaseVertexAI
เริ่มต้นบริการ Vertex AI และโมเดล Generative โดยทำดังนี้
import FirebaseVertexAI // Initialize the Vertex AI service let vertex = VertexAI.vertexAI() // Initialize the generative model with a model that supports your use case // Gemini 1.5 models are versatile and can be used with all API capabilities let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
เมื่อคุณอ่านคู่มือเริ่มต้นใช้งานเสร็จแล้ว ให้เรียนรู้วิธีเลือก โมเดล Gemini และ (ไม่บังคับ) ตำแหน่งที่เหมาะกับกรณีการใช้งานและแอปของคุณ
ขั้นตอนที่ 4: เรียกใช้ Vertex AI Gemini API
ตอนนี้คุณได้เชื่อมต่อแอปกับ Firebase เพิ่ม SDK และเริ่มต้นแล้ว บริการ Vertex AI และโมเดล Generative คุณก็พร้อมที่จะเรียกใช้ Vertex AI Gemini API แล้ว
คุณสามารถใช้ generateContent()
เพื่อสร้างข้อความจากพรอมต์แบบข้อความเท่านั้น
คำขอ:
import FirebaseVertexAI
// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()
// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
print(text)
}
คุณทำอะไรได้อีกบ้าง
ดูข้อมูลเพิ่มเติมเกี่ยวกับโมเดล Gemini
ดูข้อมูลเกี่ยวกับ รุ่นที่เหมาะกับกรณีการใช้งานที่หลากหลาย และ โควต้าและการกำหนดราคา
ลองใช้ความสามารถอื่นๆ ของ Gemini API
- ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างข้อความจาก พรอมต์แบบข้อความเท่านั้น รวมถึงวิธี สตรีมคำตอบ
- สร้างข้อความจาก พรอมต์แบบสื่อหลากรูปแบบ (รวมถึงข้อความ, รูปภาพ, PDF, วิดีโอ และเสียง)
- สร้างการสนทนาแบบผลัดกันเล่น (แชท)
- ใช้การเรียกใช้ฟังก์ชันเพื่อเชื่อมต่อ โมเดล Generative กับระบบและข้อมูลภายนอก
เรียนรู้วิธีควบคุมการสร้างเนื้อหา
- ทำความเข้าใจการออกแบบพรอมต์ รวมถึง แนวทางปฏิบัติที่ดีที่สุด กลยุทธ์ และตัวอย่างพรอมต์
- กำหนดค่าพารามิเตอร์โมเดล เช่น อุณหภูมิและโทเค็นเอาต์พุตสูงสุด
- ใช้การตั้งค่าความปลอดภัยเพื่อปรับ แนวโน้มที่จะได้รับคำตอบที่อาจถือว่าเป็นอันตราย
แสดงความคิดเห็น เกี่ยวกับประสบการณ์การใช้งาน Vertex AI สำหรับ Firebase