| ตัวอย่างในหน้านี้ถือว่าคุณได้ทำตาม เริ่มต้นใช้งาน: เข้าถึง Gemini API ผ่านเฟรมเวิร์ก Foundation Models ของ Apple แล้ว |
ในแต่ละคำขอที่ส่งไปยังโมเดล คุณสามารถส่งการตั้งค่าการกำหนดค่าบางอย่างเพื่อ ควบคุมวิธีที่โมเดลสร้างคำตอบได้ Geminiแต่ละรุ่นมี ตัวเลือกการกำหนดค่าที่แตกต่างกัน
การกำหนดค่าจะยังคงอยู่ตลอดอายุการใช้งานของgeminiLanguageModelหรือLanguageModelSession ทั้งนี้ขึ้นอยู่กับการตั้งค่า หากต้องการใช้การกำหนดค่าอื่น ให้สร้างโมเดลหรือเซสชันใหม่ด้วยการกำหนดค่านั้น
หน้านี้อธิบายตัวเลือกการกำหนดค่าต่อไปนี้
- คำสั่งของระบบ
- การคิด (หรือที่เรียกว่า "การให้เหตุผล")
- เอาต์พุตของรูปภาพที่สร้างขึ้น
- การกำหนดค่าทั่วไป
ระบุคำสั่งของระบบ
คำสั่งของระบบเปรียบเสมือน "คำนำ" ที่คุณเพิ่มก่อนที่โมเดลจะได้รับ คำสั่งเพิ่มเติมจากผู้ใช้ปลายทาง ซึ่งช่วยให้คุณกำหนด ลักษณะการทำงานของโมเดลตามความต้องการและ Use Case ที่เฉพาะเจาะจงได้
ระบุคำสั่งของระบบใน LanguageModelSession ดังนี้
// ...
// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")
// Specify the system instructions as part of creating the session
let session = LanguageModelSession(
model: model,
instructions: "You are a cat. Your name is Neko."
)
// ...
กำหนดค่าการคิด (หรือที่เรียกว่า "การให้เหตุผล")
คุณสามารถกำหนดค่าปริมาณการคิด (หรือที่เรียกว่าการให้เหตุผล) ที่โมเดล Gemini สามารถทำได้เพื่อสร้างคำตอบ ดูรายละเอียด แนวทางปฏิบัติแนะนำ และกรณีการใช้งานสำหรับการคิดได้ในคำแนะนำทั่วไปเกี่ยวกับการคิด
Apple ใช้ระดับการให้เหตุผลแทนระดับการคิด คุณตั้งค่า
reasoningLevel ใน ContextOptions ในคำขอแต่ละรายการผ่าน
LanguageModelSession ดังนี้
// ...
// Make sure you initialize your chosen Gemini API backend service
let model = FirebaseAI.firebaseAI().geminiLanguageModel(name: "GEMINI_MODEL_NAME")
let session = LanguageModelSession(model: model)
// Specify the reasoning level when generating a response
// Possible reasoningLevels: .light, .moderate, .deep, .custom("minimal")
let response = try await session.respond(
to: "Write a story about a magic backpack.",
contextOptions: ContextOptions(reasoningLevel: .REASONING_LEVEL)
)
// ...
ค่าระดับการคิดที่รองรับ
โปรดทราบดังต่อไปนี้
- โมเดล Gemini 3.x จะใช้การคิดเสมอ คุณปิดหรือ ปิดการคิดสำหรับโมเดลเหล่านี้ไม่ได้
- โมเดล Gemini 3.x จะใช้การคิดแบบไดนามิกเสมอ ซึ่งหมายความว่าโมเดลจะตัดสินใจ ว่าเมื่อใดและจะคิดมากน้อยเพียงใดตามจำนวนที่กำหนดค่าไว้
ตารางต่อไปนี้แสดงระดับการคิด (reasoningLevel) ที่คุณตั้งค่าได้สำหรับโมเดล Gemini แต่ละรายการ โปรดทราบว่าหากคุณใช้ค่า Gemini
(MINIMAL, LOW, MEDIUM, HIGH) ระบบจะแมปค่าดังกล่าวกับ
เวอร์ชัน Apple ของค่านั้นโดยอัตโนมัติ
Apple: .custom("minimal")Gemini: MINIMAL
|
Apple: .lightGemini: LOW
|
Apple: .moderateGemini: MEDIUM
|
Apple: .deepGemini: HIGH
|
|
|---|---|---|---|---|
|
โมเดลใช้โทเค็นให้น้อยที่สุดเท่าที่จะทำได้ แทบไม่ต้องคิด งานที่มีความซับซ้อนต่ำ |
โมเดลใช้โทเค็นน้อยลง ลดเวลาในการตอบสนองและค่าใช้จ่าย งานที่เรียบง่ายและงานที่มีปริมาณงานสูง |
โมเดลใช้แนวทางที่สมดุล งานที่มีความซับซ้อนปานกลาง |
โมเดลใช้โทเค็นจนถึงระดับสูงสุด พรอมต์ที่ซับซ้อนซึ่งต้องใช้การให้เหตุผลอย่างลึกซึ้ง |
|
gemini-3.1-pro-preview |
(ค่าเริ่มต้น) | |||
gemini-3.5-flash |
(ค่าเริ่มต้น) | |||
gemini-3.1-flash-lite |
(ค่าเริ่มต้น) | |||
gemini-3-pro-image-preview ("Nano Banana Pro") |
(ค่าเริ่มต้น) | |||
gemini-3.1-flash-image-preview ("Nano Banana 2") |
(ค่าเริ่มต้น) |
กำหนดค่าเอาต์พุตรูปภาพ
การกำหนดค่าทั่วไป
แสดงความคิดเห็น เกี่ยวกับการเข้าถึง Gemini API ผ่านเฟรมเวิร์กโมเดลพื้นฐานของ Apple