Apple의 Foundation Models 프레임워크를 통해 Gemini API에 액세스할 때의 구성 옵션

모델에 대한 각 요청에서 모델의 대답 생성 방식을 제어하는 몇 가지 구성 설정을 함께 보낼 수 있습니다. 각 Gemini 모델은 다양한 구성 옵션을 제공합니다.

설정에 따라 구성은 geminiLanguageModel 또는 LanguageModelSession의 수명 동안 유지됩니다. 다른 구성을 사용하려면 해당 구성으로 새 모델이나 세션을 만드세요.

이 페이지에서는 다음 구성 옵션을 설명합니다.

• 시스템 안내
• 생각하기('추론'이라고도 함)
• 생성된 이미지 출력
• 일반 구성

시스템 요청 사항 지정

시스템 안내는 모델이 최종 사용자의 추가 안내에 노출되기 전에 추가하는 '프리앰블'과 같습니다. 이를 통해 사용자는 특정 요구사항 및 사용 사례에 따라 모델의 동작을 조정할 수 있습니다.

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은 사고 수준 대신 추론 수준을 사용합니다. LanguageModelSession를 통해 각 요청에서 ContextOptions의 reasoningLevel를 설정합니다.

// ...

// 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 모델은 항상 동적 사고를 사용합니다. 모델은 구성된 양까지 언제 얼마나 사고할지 결정합니다.

다음 표에는 각 Gemini 모델에 설정할 수 있는 사고 수준 (reasoningLevel)이 나와 있습니다. Gemini 값(MINIMAL, LOW, MEDIUM, HIGH)을 사용하면 해당 값의 Apple 버전으로 자동 매핑됩니다.

이미지 출력 구성

일반 구성

Apple의 파운데이션 모델 프레임워크를 통해 Gemini API에 액세스하는 방법에 관한 의견 보내기