ตัวเลือกการกำหนดค่าเมื่อเข้าถึง Gemini API ผ่านเฟรมเวิร์กโมเดลพื้นฐานของ 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 ของค่านั้นโดยอัตโนมัติ

^{1 gemini-3.8-flash และ gemini-3.7-flash ไม่รองรับระดับการคิด MINIMAL หากคุณ ตั้งระดับความคิดเป็น MINIMAL คำขอจะล้มเหลวพร้อมข้อผิดพลาด 400}

กำหนดค่าเอาต์พุตรูปภาพ

การกำหนดค่าทั่วไป

แสดงความคิดเห็น เกี่ยวกับการเข้าถึง Gemini API ผ่านเฟรมเวิร์กโมเดลพื้นฐานของ Apple