תבנית, תחביר ודוגמאות

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .agentPlatform()).templateGenerativeModel()

let customerName = "Jane"

do {
    let response = try await model.generateContent(
        // Specify your template ID
        templateID: "my-first-template-v1-0-0",
        // Provide the values for any input variables required by your template.
        inputs: [
            "customerName": customerName
        ]
    )
    if let text = response.text {
        print("Response Text: \(text)")
    }
} catch {
    print("An error occurred: \(error)")
}
print("\n")

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.agentPlatform()).templateGenerativeModel()

val customerName = "Jane"

val response = model.generateContent(
    // Specify your template ID.
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf(
        "customerName" to customerName
    )
)

val text = response.text
println(text)

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
TemplateGenerativeModel generativeModel = FirebaseAI.getInstance(GenerativeBackend.agentPlatform()).templateGenerativeModel();

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(generativeModel);

String customerName = "Jane";

Future response = model.generateContent(
    // Specify your template ID
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf("customerName", customerName)
);
addCallback(response,
       new FutureCallback() {
           public void onSuccess(GenerateContentResponse result) {
             System.out.println(result.getText());
           }
           public void onFailure(Throwable t) {
             reportError(t);
           }
    }
executor);

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
const ai = getAI(app, { backend: new AgentPlatformBackend() });

// Create a `TemplateGenerativeModel` instance.
const model = getTemplateGenerativeModel(ai);

const customerName = 'Jane';

const result = await model.generateContent(
  // Specify your template ID.
  'my-first-template-v1-0-0',
  // Provide the values for any input variables required by your template.
  {
    customerName: customerName,
  }
);

const response = result.response;
const text = response.text();

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
var _model = FirebaseAI.agentPlatform().templateGenerativeModel()

var customerName = 'Jane';

var response = await _model.generateContent(
        // Specify your template ID
        'my-first-template-v1-0-0',
        // Provide the values for any input variables required by your template.
        inputs: {
           'customerName': customerName,
        },
      );

var text = response?.text;
print(text);

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
var firebaseAI = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform());

// Create a `TemplateGenerativeModel` instance
var model = firebaseAI.GetTemplateGenerativeModel();

var customerName = "Jane";

try
{
   var response = await model.GenerateContentAsync(
      // Specify your template ID.
      "my-first-template-v1-0-0",
      // Provide the values for any input variables required by your template.
      new Dictionary<string, object> {
         { "customerName", customerName },
      }
   );
   Debug.Log($"Response Text: {response.Text}");
}
catch (Exception e) {
  Debug.LogError($"An error occurred: {e.Message}");
}

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform())

// Create a `TemplateGenerativeModel` instance.
let model = ai.templateGenerativeModel()

// Example: Coordinates for New York City
let latAndLong = CLLocationCoordinate2D(latitude: 40.7128, longitude: -74.0060)

// (Optional) Define a RetrievalConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
let retrievalConfig = RetrievalConfig(
    location: latAndLong,
    // Example: Language code for English (US)
    languageCode: "en-US"
)

// Wrap the RetrievalConfig inside a TemplateToolConfig.
let templateToolConfig = TemplateToolConfig(retrievalConfig: retrievalConfig)

do {
    // Generate content using your server template ID, inputs, and grounding configuration.
    let response = try await model.generateContent(
        // Specify a template ID that uses the Google Maps tool.
        templateID: "TEMPLATE_ID",
        // Provide the values for any input variables required by your template.
        inputs: [
            "question": "restaurants near me?"
        ],
        // Pass the template-compatible tool configuration.
        toolConfig: templateToolConfig
    )
    
    print(response.text ?? "No text in response.")
} catch {
    print("An error occurred: \(error)")
}

// Make sure to comply with the "Grounding with Google Maps" usage requirements

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.agentPlatform()).templateGenerativeModel()

// (Optional) Define a RetrievalConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
val retrievalConfig = RetrievalConfig(
    // Example: Coordinates for New York City
    latLng = LatLng(latitude = 40.7128, longitude = -74.0060),
    // Example: Language code for English (US)
    languageCode = "en-US"
)

// Wrap the RetrievalConfig inside a TemplateToolConfig.
val templateToolConfig = TemplateToolConfig(
    retrievalConfig = retrievalConfig
)

// Generate content using your server template ID, inputs, and grounding configuration.
val response = model.generateContent(
    // Specify a template ID that uses the Google Maps tool.
    templateId = "TEMPLATE_ID",
    // Provide the values for any input variables required by your template.
    inputs = mapOf(
        "question" to "restaurants near me?"
    ),
    // Pass the template-compatible tool configuration.
    toolConfig = templateToolConfig
)

println(response.text)

// Make sure to comply with the "Grounding with Google Maps" usage requirements

// ...

// (Optional) Define a TemplateToolConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
TemplateToolConfig templateToolConfig = new TemplateToolConfig(
    new RetrievalConfig(
        // Example: Coordinates for New York City
        new LatLng(40.7128, -74.0060),
        // Example: Language code for English (US)
        "en-US"
    )
);

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
TemplateGenerativeModel generativeModel = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
        .templateGenerativeModel(
            new RequestOptions(),
            List.of(Tool.googleMaps()),
            // Pass the template-compatible tool configuration.
            templateToolConfig
        );

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(generativeModel);

// Generate content using your server template ID, inputs, and grounding configuration.
ListenableFuture response = model.generateContent(
        // Specify a template ID that uses the Google Maps tool.
        "TEMPLATE_ID",
        // Provide the values for any input variables required by your template.
        Map.of("question", "restaurants near me?")
);

Futures.addCallback(response, new FutureCallback() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

// Make sure to comply with the "Grounding with Google Maps" usage requirements

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
const ai = getAI(app, { backend: new AgentPlatformBackend() });

// Create a `TemplateGenerativeModel` instance.
const model = getTemplateGenerativeModel(ai);

// (Optional) Define a templateToolConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
const templateToolConfig = {
  retrievalConfig: {
    // Example: Coordinates for New York City
    latLng: {
      latitude: 40.7128,
      longitude: -74.0060
    },
    // Example: Language code for English (US)
    languageCode: 'en-US'
  }
};

// Generate content using your server template ID, inputs, and grounding configuration.
const result = await model.generateContent(
  // Specify a template ID that uses the Google Maps tool.
  'TEMPLATE_ID',
  // Provide the values for any input variables required by your template.
  {
    question: 'restaurants near me?',
  },
  // Pass the template-compatible tool configuration.
  templateToolConfig
);

const response = result.response;
const text = response.text();

// Make sure to comply with the "Grounding with Google Maps" usage requirements

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `TemplateGenerativeModel` instance.
final model = FirebaseAI.agentPlatform().templateGenerativeModel();

// (Optional) Define a TemplateToolConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
final templateToolConfig = TemplateToolConfig(
  retrievalConfig: RetrievalConfig(
    // Example: Coordinates for New York City
    latLng: LatLng(latitude: 40.712728, longitude: -74.006015),
    // Example: Language code for English (US)
    languageCode: 'en',
  ),
);

// Generate content using your server template ID, inputs, and grounding configuration.
final response = await model.generateContent(
  // Specify a template ID that uses the Google Maps tool.
  'TEMPLATE_ID',
  // Provide the values for any input variables required by your template
  inputs: {
    'question': 'restaurants near me?',
  },
  // Pass the template-compatible tool configuration
  toolConfig: templateToolConfig,
);

print(response?.text);

// Make sure to comply with the "Grounding with Google Maps" usage requirements

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform());

// Create a `TemplateGenerativeModel` instance.
var model = ai.GetTemplateGenerativeModel();

// Example: Coordinates for New York City
var latLng = new LatLng(40.7128, -74.0060);

// (Optional) Define a RetrievalConfig to configure the Grounding with Google Maps tool.
// You can optionally provide a location's coordinates and/or a language code
// for more relevant and personalized Google Maps results.
var retrievalConfig = new RetrievalConfig(latLng, languageCode: "en");

// Wrap the RetrievalConfig inside a TemplateToolConfig.
var templateToolConfig = new TemplateToolConfig(retrievalConfig: retrievalConfig);

try
{
  // Generate content using the server template ID, inputs, and grounding configuration.
  var response = await model.GenerateContentAsync(
      // Specify a template ID that uses the Google Maps tool.
      "TEMPLATE_ID",
      // Provide the values for any input variables required by your template.
      new Dictionary<string, object> {
        { "question", "restaurants near me?" }
      },
      // Pass the template-compatible tool configuration.
      toolConfig: templateToolConfig
  );

  Debug.Log($"Response Text: {response.Text}");
}
catch (Exception e)
{
  Debug.LogError($"An error occurred: {e.Message}");
}

// Make sure to comply with the "Grounding with Google Maps" usage requirements