Files
firebase-ios-sdk/FirebaseAI/Sources/Extensions/Public/FirebaseAI+GeminiLanguageModel.swift
Andrew Heard 97932016ef feat(ai): use VALIDATED function calling mode in GLM (#16649)
Default to VALIDATED function calling mode in GeminiLanguageModel and
switch guided generation to responseJsonSchema.
Previously, tool-calling requests mapped the default or allowed mode to
AUTO, which does not strictly enforce parameter schemas. Because Swift
decodes tool arguments strictly, schema malformation results in failed
turns. Additionally, guided generation used responseFormat, which the
Gemini backend ignores when VALIDATED mode is active during tool-calling
sessions, dropping response schemas and causing structured decoding
failures in respond(to:generating:).
* Default unset and explicit .allowed toolCallingMode to VALIDATED mode
  to strictly enforce schema adherence via constrained decoding.
* Throw LanguageModelError.unsupportedCapability on unrecognized future
  tool calling modes instead of silently falling back to allowed.
* Omit functionCallingConfig entirely when requests declare no functions
  to avoid contradictory constrained decoding states.
* Send responseJsonSchema with application/json MIME type for guided
  generation, which constrained decoding honors alongside VALIDATED.
* Remove unused _responseJsonSchema property from GenerationConfig.
* End SSE response streams and cancel tasks upon receiving terminal
  finish reasons or prompt feedback block reasons.
* Add integration test for combined tool calling and guided generation.
* Refresh cached App Check debug tokens proactively within TTL window.
2026-09-17 17:51:18 -04:00

40 lines
1.8 KiB
Swift

// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#if compiler(>=6.4) && canImport(FoundationModels) && canImport(GeminiLanguageModel)
import GeminiLanguageModel
public extension FirebaseAI {
/// **[Public Preview]** Creates a ``GeminiLanguageModel`` instance.
///
/// > Warning: This API is a public preview and may be subject to change.
///
/// The returned model conforms to Apple's
/// [`LanguageModel`](https://developer.apple.com/documentation/foundationmodels/languagemodel)
/// protocol and can be used with `LanguageModelSession` in Apple's Foundation Models
/// framework.
///
/// - Parameter name: The identifier of the Gemini model to use; see
/// [available model
/// names](https://firebase.google.com/docs/ai-logic/models#available-model-names)
/// for a list of supported model names.
/// - Returns: A ``GeminiLanguageModel`` configured for this `FirebaseAI` instance.
@available(iOS 27.0, macOS 27.0, watchOS 27.0, visionOS 27.0, *)
@available(tvOS, unavailable)
func geminiLanguageModel(name: String) -> GeminiLanguageModel {
GeminiLanguageModel(name: name, firebaseAI: self)
}
}
#endif // compiler(>=6.4) && canImport(FoundationModels) && canImport(GeminiLanguageModel)