Các lựa chọn cấu hình khi truy cập vào Gemini API thông qua khung Foundation Models của Apple

Trong mỗi yêu cầu gửi đến một mô hình, bạn có thể gửi kèm một số chế độ cài đặt cấu hình để kiểm soát cách mô hình tạo ra phản hồi. Mỗi mô hình Gemini đều có các lựa chọn cấu hình khác nhau.

Tuỳ thuộc vào chế độ cài đặt, cấu hình sẽ được duy trì trong suốt thời gian tồn tại của geminiLanguageModel hoặc LanguageModelSession. Nếu bạn muốn sử dụng một cấu hình khác, hãy tạo một mô hình hoặc phiên mới bằng cấu hình đó.

Trang này mô tả các lựa chọn cấu hình sau:

• Hướng dẫn về hệ thống
• Tư duy (còn gọi là "suy luận")
• Đầu ra là hình ảnh được tạo
• Cấu hình chung

Chỉ định chỉ dẫn hệ thống

Hướng dẫn hệ thống giống như một "lời nói đầu" mà bạn thêm vào trước khi mô hình tiếp xúc với bất kỳ hướng dẫn nào khác của người dùng cuối. Lời nói đầu này cho phép bạn điều chỉnh hành vi của mô hình dựa trên nhu cầu và trường hợp sử dụng cụ thể của mình.

Chỉ định hướng dẫn hệ thống trên 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."
)

// ...

Thiết lập tư duy (còn gọi là "lý luận")

Bạn có thể định cấu hình mức độ tư duy (còn gọi là suy luận) mà mô hình Gemini có thể thực hiện để tạo câu trả lời. Để biết thông tin chi tiết, các phương pháp hay nhất và trường hợp sử dụng cho tư duy, hãy xem hướng dẫn chung về Tư duy.

Thay vì thinking level (mức độ tư duy), Apple sử dụng reasoning level (mức độ suy luận). Bạn đặt reasoningLevel trong ContextOptions trên mỗi yêu cầu thông qua 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)
)

// ...

Các giá trị được hỗ trợ cho cấp độ tư duy

Lưu ý những điều sau:

• Các mô hình Gemini 3.x luôn sử dụng tính năng suy nghĩ; bạn không thể tắt tính năng suy nghĩ cho các mô hình này.
• Các mô hình Gemini 3.x luôn sử dụng tư duy linh hoạt – mô hình sẽ quyết định thời điểm và mức độ suy nghĩ (tối đa là số lượng đã định cấu hình).

Bảng sau đây liệt kê các cấp độ tư duy (reasoningLevel) mà bạn có thể đặt cho từng mô hình Gemini. Xin lưu ý rằng nếu bạn sử dụng giá trị Gemini (MINIMAL, LOW, MEDIUM, HIGH), giá trị đó sẽ tự động được liên kết với phiên bản Apple của giá trị đó.

Định cấu hình đầu ra hình ảnh

Cấu hình chung

Gửi ý kiến phản hồi về việc truy cập vào Gemini API thông qua khung Mô hình nền tảng của Apple