עיגון בנתונים באמצעות חיפוש האינטרנט של Exa

‫Exa מספקת ממשק API לחיפוש שנותן גישה לנתונים שזמינים לכולם באינטרנט, שעברו אופטימיזציה כדי לבסס את התשובות של מודלי שפה גדולים (LLM). בדף הזה מוסבר איך לבסס את התשובות של Gemini באמצעות Exa.

ביסוס בעזרת חיפוש באינטרנט של Exa ב-Gemini Enterprise Agent Platform הוא מוצר נפרד (כפי שמוגדר בהסכם Google Cloud שלך) שמקשר בין מודלים של Gemini לבין נתונים שזמינים לכולם באינטרנט ומסופקים על ידי Exa Search API.

תרחישים לדוגמה

העיגון באמצעות Exa משפר את הדיוק ומפחית הזיות, כי הוא נותן למודלים גישה לנתונים עדכניים ורלוונטיים מהאינטרנט. תרחישים נפוצים לדוגמה:

  • סוכנים וצ'אט-בוטים כלליים: אחזור מידע עדכני כדי ליצור תשובות מהימנות יותר.
  • סוכני מחקר: עורכים מחקר מעמיק ב<a href="https://support.google.com/googlesearch/answer/10028416?hl=iw">רשת העמוקה (deep web)</a> במגוון מקורות.
  • סוכני תכנות: שליפת קטעי הקוד, המסמכים וההפניות הטכניות העדכניים ביותר.
  • סוכנים קוליים: אחזור מהאינטרנט כדי לתמוך באינטראקציות קוליות בזמן אמת ובזמן אחזור קצר.
  • סוכנים ספציפיים לתחום: מאחזרים מידע עדכני וספציפי לדומיין שמותאם לתחום ידע או לתעשייה מסוימים.
  • העשרת נתונים: הוספת הקשר ומטא-נתונים עדכניים מהאינטרנט לקבוצות נתונים פנימיות.
  • תהליכי עבודה אוטומטיים: איסוף תקופתי של נתונים לגבי חדשות, אנשים, חברות או נתונים אחרים שמתעדכנים לעיתים קרובות, לצורך תהליכי עבודה פנימיים או תהליכי ייצור.

דוגמה

מי ניצח בסופרבול 2026?

בלי עיגון עם עיגון
אני לא יכול להגיד לך מי ניצח בסופרבול 2026 כי האירוע הזה עדיין לא התרחש. קבוצת סיאטל סיהוקס ניצחה בסופרבול ה-60 ב-8 בפברואר 2026, והביסה את ניו אינגלנד פטריוטס בתוצאה הסופית 29-13. מקורות: domain1.com, domain2.com, ...

מודלים נתמכים

בקטע הזה מפורטים המודלים שתומכים ב-Grounding באמצעות חיפוש באינטרנט של Exa.

לחצו כדי להרחיב את רשימת המודלים הנתמכים

לפני שמתחילים

כדי להשתמש ב-Grounding with Exa, אתם צריכים לקבל מפתח API מהאתר של Exa. מפתח ה-API הזה משמש בבקשה שלכם ל-Gemini.

ביסוס התשובות של Gemini באמצעות Exa

כדי לבקש תשובות מבוססות-קרקע מ-Gemini, משתמשים ב-Google Gen AI SDK או ב-API בארכיטקטורת REST. כדי לקבל את הביצועים הטובים ביותר, מומלץ להשתמש בהגדרות ברירת המחדל לפרמטרים אופציונליים, אלא אם אתם צריכים ערכים שאינם ברירת מחדל.

לפני שמריצים את הדוגמאות, צריך להשלים את הדרישות המוקדמות, כולל קבלת מפתח Exa API.

Python

התקנה

pip install --upgrade google-genai

מידע נוסף זמין במאמרי העזרה של ה-SDK.

מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

לפני שמריצים את הקוד לדוגמה, מחליפים את הערכים הבאים:

  • ‫MODEL_ID: המזהה של מודל נתמך שבו רוצים להשתמש, למשל gemini-2.5-flash.
  • ‫TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש באינטרנט באמצעות Exa.
  • ‫SEARCH_TYPE: אופציונלי: סוג החיפוש ב-Exa שרוצים להריץ. הערכים הנתמכים הם fast ו-instant. ערך ברירת המחדל הוא fast, שמספק תוצאות מקיפות עם זמן אחזור קצר יותר ומתאים לתהליכי עבודה אינטראקטיביים ולחיפושים שגלויים למשתמשים. השתמשו ב-instant לחוויות שדורשות את זמן האחזור הנמוך ביותר, כמו צ'אט, סוכני קול והשלמה אוטומטית. המודל הזה ממזער את זמן התגובה על ידי מתן עדיפות למהירות על פני עומק החיפוש.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימת דומיינים שיוחרגו מתוצאות החיפוש. אם מציינים דומיינים, לא יוחזרו תוצאות מהדומיינים האלה. כדי להחריג יותר מדומיין אחד, צריך להוסיף כל דומיין כמחרוזת נפרדת במירכאות ברשימה (לדוגמה, ["example.com", "example.net"]). אפשר לציין עד 1,200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימת הדומיינים שרוצים לכלול בחיפוש. אם מציינים דומיינים, התוצאות מגיעות רק מהם. כדי לכלול יותר מדומיין אחד, צריך להוסיף כל דומיין כמחרוזת נפרדת במירכאות ברשימה (לדוגמה, ["example.com", "example.net"]). אפשר לציין עד 1,200 דומיינים.
  • ‫MAX_CHARACTERS: אופציונלי: מספר התווים המקסימלי שיוחזר בתקצירים. ההגדרה הזו קובעת את האורך הכולל של הטקסט המודגש שמוחזר לכל כתובת URL.
  • ‫NUM_RESULTS: אופציונלי: המספר המקסימלי של תוצאות חיפוש שישמשו לביסוס. אם לא מציינים ערך, ברירת המחדל היא 5.

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="TEXT",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                exa_ai_search=types.ToolExaAiSearch(
                    # Required. Your API key for Exa web search.
                    api_key="API_KEY",
                    # Optional. Customize the search. Click a placeholder to
                    # enter a value, or remove the line to accept the default.
                    custom_configs={
                        "type": "SEARCH_TYPE",
                        "excludeDomains": ["EXCLUDE_DOMAINS"],
                        "includeDomains": ["INCLUDE_DOMAINS"],
                        "contents": {
                            "highlights": {
                                "maxCharacters": MAX_CHARACTERS,
                            },
                        },
                        "numResults": NUM_RESULTS,
                    },
                )
            )
        ],
    ),
)

print(response.text)

# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)

Java

איך מתקינים או מעדכנים את Java

מידע נוסף זמין במאמרי העזרה של ה-SDK.

מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

לפני שמריצים את הקוד לדוגמה, מחליפים את הערכים הבאים:

  • ‫MODEL_ID: המזהה של מודל נתמך שבו רוצים להשתמש, למשל gemini-2.5-flash.
  • ‫TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש באינטרנט באמצעות Exa.
  • ‫SEARCH_TYPE: אופציונלי: סוג החיפוש ב-Exa שרוצים להריץ. הערכים הנתמכים הם fast ו-instant. ערך ברירת המחדל הוא fast, שמספק תוצאות מקיפות עם זמן אחזור קצר יותר ומתאים לתהליכי עבודה אינטראקטיביים ולחיפושים שגלויים למשתמשים. השתמשו ב-instant לחוויות שדורשות את זמן האחזור הנמוך ביותר, כמו צ'אט, סוכני קול והשלמה אוטומטית. המודל הזה ממזער את זמן התגובה על ידי מתן עדיפות למהירות על פני עומק החיפוש.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימת דומיינים שיוחרגו מתוצאות החיפוש. אם מציינים דומיינים, לא יוחזרו תוצאות מהדומיינים האלה. כדי להחריג יותר מדומיין אחד, צריך להוסיף כל דומיין כמחרוזת נפרדת במירכאות ברשימה (לדוגמה, ["example.com", "example.net"]). אפשר לציין עד 1,200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימת הדומיינים שרוצים לכלול בחיפוש. אם מציינים דומיינים, התוצאות מגיעות רק מהם. כדי לכלול יותר מדומיין אחד, צריך להוסיף כל דומיין כמחרוזת נפרדת במירכאות ברשימה (לדוגמה, ["example.com", "example.net"]). אפשר לציין עד 1,200 דומיינים.
  • ‫MAX_CHARACTERS: אופציונלי: מספר התווים המקסימלי שיוחזר בתקצירים. ההגדרה הזו קובעת את האורך הכולל של הטקסט המודגש שמוחזר לכל כתובת URL.
  • ‫NUM_RESULTS: אופציונלי: המספר המקסימלי של תוצאות חיפוש שישמשו לביסוס. אם לא מציינים ערך, ברירת המחדל היא 5.

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolExaAiSearch;
import java.util.List;
import java.util.Map;

public class ExaGroundingSample {
  public static void main(String[] args) {
    try (Client client = Client.builder().build()) {

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  Tool.builder()
                      .exaAiSearch(
                          ToolExaAiSearch.builder()
                              // Required. Your API key for Exa web search.
                              .apiKey("API_KEY")
                              // Optional. Customize the search. Click a
                              // placeholder to enter a value, or remove the
                              // entry to accept the default.
                              .customConfigs(
                                  Map.of(
                                      "type", "SEARCH_TYPE",
                                      "excludeDomains",
                                      List.of("EXCLUDE_DOMAINS"),
                                      "includeDomains",
                                      List.of("INCLUDE_DOMAINS"),
                                      "contents",
                                      Map.of(
                                          "highlights",
                                          Map.of(
                                              "maxCharacters",
                                              MAX_CHARACTERS)),
                                      "numResults", NUM_RESULTS))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "TEXT", config);

      System.out.println(response.text());

      // The grounding metadata contains the web sources used to ground the response.
      System.out.println(
          response.candidates().get().get(0).groundingMetadata().get().groundingChunks().get());
    }
  }
}

Node.js

התקנה

npm install @google/genai

מידע נוסף זמין במאמרי העזרה של ה-SDK.

מגדירים משתני סביבה כדי להשתמש ב-Google Gen AI SDK עם Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

לפני שמריצים את הקוד לדוגמה, מחליפים את הערכים הבאים:

  • ‫MODEL_ID: המזהה של מודל נתמך שבו רוצים להשתמש, למשל gemini-2.5-flash.
  • ‫TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש באינטרנט באמצעות Exa.
  • ‫SEARCH_TYPE: אופציונלי: סוג החיפוש ב-Exa שרוצים להריץ. הערכים הנתמכים הם fast ו-instant. ערך ברירת המחדל הוא fast, שמספק תוצאות מקיפות עם זמן אחזור קצר יותר ומתאים לתהליכי עבודה אינטראקטיביים ולחיפושים שגלויים למשתמשים. השתמשו ב-instant לחוויות שדורשות את זמן האחזור הנמוך ביותר, כמו צ'אט, סוכני קול והשלמה אוטומטית. המודל הזה ממזער את זמן התגובה על ידי מתן עדיפות למהירות על פני עומק החיפוש.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימת דומיינים שיוחרגו מתוצאות החיפוש. אם מציינים דומיינים, לא יוחזרו תוצאות מהדומיינים האלה. כדי להחריג יותר מדומיין אחד, צריך להוסיף כל דומיין כמחרוזת נפרדת במירכאות ברשימה (לדוגמה, ["example.com", "example.net"]). אפשר לציין עד 1,200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימת הדומיינים שרוצים לכלול בחיפוש. אם מציינים דומיינים, התוצאות מגיעות רק מהם. כדי לכלול יותר מדומיין אחד, צריך להוסיף כל דומיין כמחרוזת נפרדת במירכאות ברשימה (לדוגמה, ["example.com", "example.net"]). אפשר לציין עד 1,200 דומיינים.
  • ‫MAX_CHARACTERS: אופציונלי: מספר התווים המקסימלי שיוחזר בתקצירים. ההגדרה הזו קובעת את האורך הכולל של הטקסט המודגש שמוחזר לכל כתובת URL.
  • ‫NUM_RESULTS: אופציונלי: המספר המקסימלי של תוצאות חיפוש שישמשו לביסוס. אם לא מציינים ערך, ברירת המחדל היא 5.

import {GoogleGenAI} from '@google/genai';

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'TEXT',
  config: {
    tools: [
      {
        exaAiSearch: {
          // Required. Your API key for Exa web search.
          apiKey: 'API_KEY',
          // Optional. Customize the search. Click a placeholder to enter a
          // value, or remove the line to accept the default.
          customConfigs: {
            type: 'SEARCH_TYPE',
            excludeDomains: ['EXCLUDE_DOMAINS'],
            includeDomains: ['INCLUDE_DOMAINS'],
            contents: {
              highlights: {
                maxCharacters: MAX_CHARACTERS,
              },
            },
            numResults: NUM_RESULTS,
          },
        },
      },
    ],
  },
});

console.log(response.text);

// The grounding metadata contains the web sources used to ground the response.
console.log(response.candidates[0].groundingMetadata.groundingChunks);

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫LOCATION: האזור שבו הבקשה תעובד. כדי להשתמש בנקודת הקצה הגלובלית, צריך להחריג את המיקום משם נקודת הקצה ולהגדיר את מיקום המשאב כ-`global`.
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫MODEL_ID: המזהה של המודל שבו רוצים להשתמש.
  • ‫TEXT: פרומפט טקסטואלי לשליחה למודל.
  • ‫API_KEY: מפתח ה-API שלכם לחיפוש באינטרנט באמצעות Exa.
  • ‫SEARCH_TYPE: אופציונלי: סוג החיפוש ב-Exa שרוצים להריץ. הערכים הנתמכים הם fast ו-instant. ערך ברירת המחדל הוא fast, שמספק תוצאות מקיפות עם זמן אחזור קצר יותר ומתאים לתהליכי עבודה אינטראקטיביים ולחיפושים שגלויים למשתמשים. השתמשו ב-instant לחוויות שדורשות את זמן האחזור הנמוך ביותר, כמו צ'אט, סוכני קול והשלמה אוטומטית. הוא ממזער את זמן התגובה על ידי מתן עדיפות למהירות על פני עומק החיפוש.
  • ‫EXCLUDE_DOMAINS: אופציונלי: רשימת דומיינים שיוחרגו מתוצאות החיפוש. אם מציינים דומיינים, לא יוחזרו תוצאות מהדומיינים האלה. אפשר לציין עד 1,200 דומיינים.
  • ‫INCLUDE_DOMAINS: אופציונלי: רשימת הדומיינים שרוצים לכלול בחיפוש. אם מציינים דומיינים, התוצאות יגיעו רק מהם. אפשר לציין עד 1,200 דומיינים.
  • ‫MAX_CHARACTERS: אופציונלי: מספר התווים המקסימלי שיוחזר להדגשות. ההגדרה הזו קובעת את האורך הכולל של הטקסט המודגש שמוחזר לכל כתובת URL.
  • ‫NUM_RESULTS: אופציונלי. המספר המקסימלי של תוצאות חיפוש שישמשו לביסוס. אם לא מציינים ערך, ברירת המחדל היא 5.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

תוכן בקשת JSON:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "exaAiSearch": {
        "api_key": "API_KEY",
        "customConfigs": {
            "type": "SEARCH_TYPE",
            "excludeDomains": ["EXCLUDE_DOMAINS"],
            "includeDomains": ["INCLUDE_DOMAINS"],
            "contents": {
                "highlights": {
                    "maxCharacters": MAX_CHARACTERS
                }
            },
            "numResults": NUM_RESULTS
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

מכסה

מכסת ברירת המחדל היא 200 הנחיות לדקה. אם אתם צריכים להגדיל את מגבלות הקצב, פנו לכתובת support@exa.ai ולצוות של חשבון Google שלכם, וציינו את תרחיש השימוש והדרישות שלכם.

חיוב

השימוש ב-Grounding with Exa כרוך בחיובים הבאים:

  • צריכת טוקנים של Gemini: טוקנים של הנחיות, טוקנים של חשיבה, טוקנים של פלט. מידע נוסף זמין במאמר תמחור.
  • ביסוס של Gemini באמצעות הנתונים שלכם: מידע נוסף זמין בקטע תמחור.
  • תמחור השימוש ב-API של Exa לחיפוש: מידע נוסף זמין בדף התמחור של Exa.