Konteks URL

Aware API memungkinkan Anda memberikan konteks tambahan ke model dalam bentuk URL. Model dapat mengakses konten dari URL tersebut untuk menginformasikan dan meningkatkan kualitas responsnya.

Konteks URL memiliki manfaat berikut:

  • Mengekstrak data: Memberikan informasi spesifik seperti harga, nama, atau temuan utama dari artikel atau beberapa URL.

  • Membandingkan informasi: Analisis beberapa laporan, artikel, atau PDF untuk mengidentifikasi perbedaan dan melacak tren.

  • Menyintesis dan membuat konten: Menggabungkan informasi dari beberapa URL sumber untuk membuat ringkasan, postingan blog, laporan, atau pertanyaan tes yang akurat.

  • Analisis kode dan konten teknis: Berikan URL ke repositori GitHub atau dokumentasi teknis untuk menjelaskan kode, membuat petunjuk penyiapan, atau menjawab pertanyaan.

Pastikan Anda meninjau praktik terbaik dan batasan saat menggunakan alat konteks URL.

Model yang didukung

  • gemini-3.1-pro-preview
  • gemini-3.7-flash (dan gemini-3.6-flash serta gemini-3.5-flash yang lebih lama)
  • gemini-3.5-flash-lite (dan gemini-3.1-flash-lite yang lebih lama)

Model Gemini 2.5 penggunaan umum mendukung kemampuan ini, tetapi semuanya sudah tidak digunakan lagi.

Bahasa yang didukung

Lihat bahasa yang didukung untuk model Gemini.

Menggunakan alat konteks URL

Anda dapat menggunakan alat konteks URL dengan dua cara utama:

Hanya alat konteks URL

Klik penyedia Gemini API untuk melihat konten dan kode khusus penyedia di halaman ini.

Saat membuat instance GenerativeModel, berikan UrlContext sebagai alat. Kemudian, langsung ke perintah Anda, berikan URL spesifik yang Anda inginkan untuk diakses dan dianalisis oleh model.

Contoh berikut menunjukkan cara membandingkan dua resep dari situs yang berbeda:

Swift 


import FirebaseAILogic

// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case.
let model = ai.generativeModel(
    modelName: "GEMINI_MODEL_NAME",
    // Enable the URL context tool.
    tools: [Tool.urlContext()]
)

// Specify one or more URLs for the tool to access.
let url1 = "FIRST_RECIPE_URL"
let url2 = "SECOND_RECIPE_URL"

// Provide the URLs in the prompt sent in the request.
let prompt = "Compare the ingredients and cooking times from the recipes at \(url1) and \(url2)"

// Get and handle the model's response.
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")

Kotlin 


// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
    modelName = "GEMINI_MODEL_NAME",
    // Enable the URL context tool.
    tools = listOf(Tool.urlContext())
)

// Specify one or more URLs for the tool to access.
val url1 = "FIRST_RECIPE_URL"
val url2 = "SECOND_RECIPE_URL"

// Provide the URLs in the prompt sent in the request.
val prompt = "Compare the ingredients and cooking times from the recipes at $url1 and $url2"

// Get and handle the model's response.
val response = model.generateContent(prompt)
print(response.text)

Java 


// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
                .generativeModel("GEMINI_MODEL_NAME",
                        null,
                        null,
                        // Enable the URL context tool.
                        List.of(Tool.urlContext(new UrlContext())));

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// Specify one or more URLs for the tool to access.
String url1 = "FIRST_RECIPE_URL";
String url2 = "SECOND_RECIPE_URL";

// Provide the URLs in the prompt sent in the request.
String prompt = "Compare the ingredients and cooking times from the recipes at " + url1 + " and " + url2 + "";

ListenableFuture response = model.generateContent(prompt);
  Futures.addCallback(response, new