Gemini API

‫Gemini Interactions API הוא API ניסיוני שמאפשר למפתחים לבנות אפליקציות מבוססות-AI גנרטיבי באמצעות מודלים של Gemini. ‫Gemini הוא המודל הכי מתקדם שלנו, והוא נבנה מאפס כדי להיות מולטימודאלי. הוא יכול להכליל ולהבין בצורה חלקה סוגים שונים של מידע, כולל שפה, תמונות, אודיו, וידאו וקוד, לפעול על פיהם ולשלב ביניהם. אפשר להשתמש ב-Gemini API לתרחישי שימוש כמו חשיבה רציונלית על פני טקסט ותמונות, יצירת תוכן, סוכני דיאלוג, מערכות סיכום וסיווג ועוד.

פתיחת הדף כ-Markdown פתיחת מפרט OpenAPI

יצירת אינטראקציה

post https://generativelanguage.googleapis.com/v1beta/interactions

יצירת אינטראקציה חדשה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

model ModelOption  (אופציונלי)

השם של ה-`Model` שמשמש ליצירת האינטראקציה.
חובה אם לא צוין agent

ערכים אפשריים:

  • gemini-2.5-computer-use-preview-10-2025

    מודל יכולות מבוסס-סוכן שנועד לאינטראקציה ישירה עם ממשק, ומאפשר ל-Gemini לתפוס את הסביבות הדיגיטליות ולנווט בהן.

  • gemini-2.5-flash

    מודל חשיבה רציונלית היברידי הראשון שלנו, שתומך בחלון ההקשר של מיליון טוקנים וכולל תקציבי חשיבה.

  • gemini-2.5-flash-image

    מודל מקורי ליצירת תמונות, שעבר אופטימיזציה למהירות, לגמישות ולהבנה הקשרית. התמחור של קלט ופלט של טקסט זהה לזה של 2.5 Flash.

  • gemini-2.5-flash-lite

    המודל הכי קטן ומשתלם שלנו, שנועד לשימוש בהיקף גדול.

  • gemini-2.5-flash-lite-preview-09-2025

    המודל העדכני ביותר שמבוסס על Gemini 2.5 Flash lite ועבר אופטימיזציה ליעילות בעלויות, לתפוקה גבוהה ולאיכות גבוהה.

  • gemini-2.5-flash-native-audio-preview-12-2025

    מודלים מקוריים של אודיו שעברו אופטימיזציה כדי לספק פלט אודיו באיכות גבוהה יותר, עם קצב טוב יותר, קול טבעי יותר, דרגת מלל גבוהה יותר ואווירה טובה יותר.

  • gemini-2.5-flash-preview-09-2025

    המודל הכי חדש שמבוסס על מודל ‎2.5 Flash. ‫2.5 Flash Preview הוא המודל הכי טוב לעיבוד בקנה מידה גדול, למשימות עם נפח גבוה שדורשות העמקה ולתרחישי שימוש אג'נטיים.

  • gemini-2.5-flash-preview-tts

    מודל ה-TTS שלנו, ‎2.5 Flash, מותאם ליצירת דיבור חזק עם זמן אחזור נמוך שאפשר לשלוט בו.

  • gemini-2.5-pro

    המודל המתקדם שלנו לשימוש רב-תכליתי, שמצטיין בכתיבת קוד ובמשימות מורכבות של חשיבה רציונלית.

  • gemini-2.5-pro-preview-tts

    מודל האודיו שלנו להמרת טקסט לדיבור, ‎2.5 Pro, עבר אופטימיזציה ליצירת דיבור עוצמתי עם זמן אחזור נמוך, כדי שהתוצאות יהיו טבעיות יותר ויהיה קל יותר לכוון את ההנחיות.

  • gemini-3-flash-preview

    המודל הכי חכם שלנו, שפועל במהירות, משלב בין יכולות מתקדמות לבין חיפוש והצמדה מעולים.

  • gemini-3-pro-image-preview

    מודל חדשני ומתקדם ליצירה ועריכה של תמונות.

  • gemini-3-pro-preview

    המודל הכי חכם שלנו עם יכולות הסקת מסקנות והבנה מולטי-מודאלית ברמה הכי גבוהה, ויכולות עוצמתיות של סוכנים ושל תכנות בשיטת Vibe coding.

  • gemini-3.1-pro-preview

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

  • gemini-3.1-flash-image-preview

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

  • gemini-3.1-flash-lite-preview

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

  • gemini-3.1-flash-tts-preview

    ‫Gemini 3.1 Flash TTS: יצירת דיבור חזקה עם זמן אחזור נמוך. תוכלו ליהנות מתוצאות טבעיות, מהנחיות שניתנות להכוונה ומתגי אודיו חדשים שמאפשרים שליטה מדויקת בקריינות.

  • lyria-3-clip-preview

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

  • lyria-3-pro-preview

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

המודל שישלים את ההנחיה.\n\nפרטים נוספים זמינים במאמר בנושא [מודלים](https://ai.google.dev/gemini-api/docs/models).

agent AgentOption  (אופציונלי)

השם של ה-Agent ששימש ליצירת האינטראקציה.
חובה אם לא צוין דגם.

ערכים אפשריים:

  • deep-research-pro-preview-12-2025

    סוכן Deep Research ב-Gemini

  • deep-research-preview-04-2026

    סוכן Deep Research ב-Gemini

  • deep-research-max-preview-04-2026

    סוכן Gemini Deep Research Max

הסוכן שאיתו רוצים ליצור אינטראקציה.

‫input Content or array (Content) or array (Turn) or string  (required)

הקלט לאינטראקציה (משותף למודל ולנציג).

system_instruction string  (optional)

הוראה למערכת לגבי האינטראקציה.

tools מערך (Tool)  (אופציונלי)

רשימה של הצהרות על כלים שהמודל עשוי להשתמש בהם במהלך האינטראקציה.

response_format object  (optional)

ההגדרה הזו מחייבת שהתגובה שנוצרה תהיה אובייקט JSON שתואם לסכימת ה-JSON שצוינה בשדה הזה.

response_mime_type string  (optional)

סוג ה-MIME של התשובה. השדה הזה נדרש אם מוגדר response_format.

stream boolean  (אופציונלי)

קלט בלבד. אם האינטראקציה תועבר בסטרימינג.

store boolean  (אופציונלי)

קלט בלבד. האם לאחסן את התגובה והבקשה לאחזור מאוחר יותר.

‫background boolean  (אופציונלי)

קלט בלבד. האם להריץ את האינטראקציה עם המודל ברקע.

generation_config GenerationConfig  (optional)

הגדרת המודל
פרמטרים להגדרת האינטראקציה עם המודל.
חלופה ל-`agent_config`. רלוונטי רק אם מוגדר `model`.

פרמטרים של הגדרות אישיות לאינטראקציות עם המודל.

שדות

temperature number  (optional)

המדיניות קובעת את מידת הרנדומיזציה של הפלט.

top_p number  (optional)

ההסתברות המצטברת המקסימלית של אסימונים שצריך לקחת בחשבון כשמבצעים דגימה.

seed integer  (אופציונלי)

ה-Seed שמשמש בפענוח לשחזור.

stop_sequences array (string)  (optional)

רשימה של רצפי תווים שיפסיקו את האינטראקציה עם הפלט.

thinking_level ThinkingLevel  (optional)

רמת טוקני המחשבה שהמודל צריך ליצור.

ערכים אפשריים:

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (optional)

האם לכלול בתשובה סיכום של תהליך החשיבה.

ערכים אפשריים:

  • auto
  • none

‫max_output_tokens integer  (optional)

מספר האסימונים המקסימלי שייכללו בתשובה.

speech_config SpeechConfig  (optional)

הגדרות לאינטראקציה קולית.

ההגדרה של אינטראקציה קולית.

שדות

voice string  (אופציונלי)

הקול של הדובר.

language string  (אופציונלי)

השפה של הדיבור.

speaker string  (אופציונלי)

שם הדובר, שצריך להיות זהה לשם הדובר שצוין בהנחיה.

image_config ImageConfig  (optional)

הגדרות האינטראקציה עם תמונות.

ההגדרה של האינטראקציה עם התמונה.

שדות

aspect_ratio enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig או ToolChoiceType  (אופציונלי)

הגדרת בחירת הכלי.

agent_config object  (optional)

הגדרת הסוכן
הגדרות הסוכן. ‫
Alternative to `generation_config`. Only applicable when `agent` is set.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

DynamicAgentConfig

הגדרות של סוכנים דינמיים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "dynamic".

DeepResearchAgentConfig

ההגדרה של סוכן Deep Research.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "deep-research".

thinking_summaries ThinkingSummaries  (אופציונלי)

האם לכלול בתשובה סיכום של תהליך החשיבה.

ערכים אפשריים:

  • auto
  • none

visualization enum (string)  (optional)

האם לכלול בתשובה פריטי ויזואליזציה.

ערכים אפשריים:

  • off
  • auto
collaborative_planning boolean  (optional)

מאפשר תכנון עם מעורבות האדם שבתהליך לסוכן Deep Research. אם הערך הוא true, סוכן Deep Research יספק תוכנית מחקר בתשובה שלו. הנציג ימשיך רק אם המשתמש יאשר את התוכנית בתור הבא.

previous_interaction_id string  (optional)

המזהה של האינטראקציה הקודמת, אם יש כזו.

response_modalities ResponseModality  (optional)

האופנים המבוקשים של התגובה (TEXT, IMAGE, AUDIO).

ערכים אפשריים:

  • text
  • image
  • audio
  • video
  • document

service_tier enum (string)  (optional)

רמת השירות של האינטראקציה.

ערכים אפשריים:

  • flex
  • standard
  • priority

תשובה

מחזירה משאב Interaction.

בקשה פשוטה

דוגמה לתשובה

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

שיחה עם זיכרון

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

קלט תמונה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

בקשה להפעלת פונקציה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "id": "gth23981",
      "name": "get_weather",
      "arguments": {
        "location": "Boston, MA"
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_thought_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "agent",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_thought_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

אחזור אינטראקציה

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

אחזור הפרטים המלאים של אינטראקציה יחידה על סמך `Interaction.id`.

פרמטרים של נתיב או שאילתה

id string  (חובה)

המזהה הייחודי של האינטראקציה לאחזור.

stream boolean  (אופציונלי)

אם המדיניות מוגדרת כ-True, התוכן שנוצר יועבר בהדרגה.

ברירת המחדל: False

last_event_id string  (optional)

אופציונלי. אם הפרמטר מוגדר, הוא מפעיל מחדש את זרם האינטראקציות מהחלק הבא אחרי האירוע שמסומן על ידי מזהה האירוע. אפשר להשתמש בו רק אם הערך של stream הוא true.

include_input boolean  (optional)

אם הערך הוא true, הקלט נכלל בתשובה.

ברירת המחדל: False

api_version string  (optional)

באיזו גרסה של ה-API להשתמש.

תשובה

מחזירה משאב Interaction.

קבלת אינטראקציה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

מחיקת אינטראקציה

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

מחיקת האינטראקציה לפי מזהה.

פרמטרים של נתיב או שאילתה

id string  (חובה)

המזהה הייחודי של האינטראקציה שרוצים למחוק.

api_version string  (optional)

באיזו גרסה של ה-API להשתמש.

תשובה

אם הפעולה בוצעה ללא שגיאות, התגובה תהיה ריקה.

מחיקת אינטראקציה

ביטול אינטראקציה

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

מבטל אינטראקציה לפי מזהה. ההגדרה הזו רלוונטית רק לאינטראקציות ברקע שעדיין פועלות.

פרמטרים של נתיב או שאילתה

id string  (חובה)

המזהה הייחודי של האינטראקציה לביטול.

api_version string  (optional)

באיזו גרסה של ה-API להשתמש.

תשובה

מחזירה משאב Interaction.

ביטול האינטראקציה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "agent"
}

משאבים

אינטראקציה

משאב האינטראקציה.

שדות

model ModelOption  (אופציונלי)

השם של ה-`Model` שמשמש ליצירת האינטראקציה.

ערכים אפשריים:

  • gemini-2.5-computer-use-preview-10-2025

    מודל יכולות מבוסס-סוכן שנועד לאינטראקציה ישירה עם ממשק, ומאפשר ל-Gemini לתפוס את הסביבות הדיגיטליות ולנווט בהן.

  • gemini-2.5-flash

    מודל חשיבה רציונלית היברידי הראשון שלנו, שתומך בחלון ההקשר של מיליון טוקנים וכולל תקציבי חשיבה.

  • gemini-2.5-flash-image

    מודל מקורי ליצירת תמונות, שעבר אופטימיזציה למהירות, לגמישות ולהבנה הקשרית. התמחור של קלט ופלט של טקסט זהה לזה של 2.5 Flash.

  • gemini-2.5-flash-lite

    המודל הכי קטן ומשתלם שלנו, שנועד לשימוש בהיקף גדול.

  • gemini-2.5-flash-lite-preview-09-2025

    המודל העדכני ביותר שמבוסס על Gemini 2.5 Flash lite ועבר אופטימיזציה ליעילות בעלויות, לתפוקה גבוהה ולאיכות גבוהה.

  • gemini-2.5-flash-native-audio-preview-12-2025

    מודלים מקוריים של אודיו שעברו אופטימיזציה כדי לספק פלט אודיו באיכות גבוהה יותר, עם קצב טוב יותר, קול טבעי יותר, דרגת מלל גבוהה יותר ואווירה טובה יותר.

  • gemini-2.5-flash-preview-09-2025

    המודל הכי חדש שמבוסס על מודל ‎2.5 Flash. ‫2.5 Flash Preview הוא המודל הכי טוב לעיבוד בקנה מידה גדול, למשימות עם נפח גבוה שדורשות העמקה ולתרחישי שימוש אג'נטיים.

  • gemini-2.5-flash-preview-tts

    מודל ה-TTS שלנו, ‎2.5 Flash, מותאם ליצירת דיבור חזק עם זמן אחזור נמוך שאפשר לשלוט בו.

  • gemini-2.5-pro

    המודל המתקדם שלנו לשימוש רב-תכליתי, שמצטיין בכתיבת קוד ובמשימות מורכבות של חשיבה רציונלית.

  • gemini-2.5-pro-preview-tts

    מודל האודיו שלנו להמרת טקסט לדיבור, ‎2.5 Pro, עבר אופטימיזציה ליצירת דיבור עוצמתי עם זמן אחזור נמוך, כדי שהתוצאות יהיו טבעיות יותר ויהיה קל יותר לכוון את ההנחיות.

  • gemini-3-flash-preview

    המודל הכי חכם שלנו, שפועל במהירות, משלב בין יכולות מתקדמות לבין חיפוש והצמדה מעולים.

  • gemini-3-pro-image-preview

    מודל חדשני ומתקדם ליצירה ועריכה של תמונות.

  • gemini-3-pro-preview

    המודל הכי חכם שלנו עם יכולות הסקת מסקנות והבנה מולטי-מודאלית ברמה הכי גבוהה, ויכולות עוצמתיות של סוכנים ושל תכנות בשיטת Vibe coding.

  • gemini-3.1-pro-preview

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

  • gemini-3.1-flash-image-preview

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

  • gemini-3.1-flash-lite-preview

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

  • gemini-3.1-flash-tts-preview

    ‫Gemini 3.1 Flash TTS: יצירת דיבור חזקה עם זמן אחזור נמוך. תוכלו ליהנות מתוצאות טבעיות, מהנחיות שניתנות להכוונה ומתגי אודיו חדשים שמאפשרים שליטה מדויקת בקריינות.

  • lyria-3-clip-preview

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

  • lyria-3-pro-preview

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

המודל שישלים את ההנחיה.\n\nפרטים נוספים זמינים במאמר בנושא [מודלים](https://ai.google.dev/gemini-api/docs/models).

agent AgentOption  (אופציונלי)

השם של ה-Agent ששימש ליצירת האינטראקציה.

ערכים אפשריים:

  • deep-research-pro-preview-12-2025

    סוכן Deep Research ב-Gemini

  • deep-research-preview-04-2026

    סוכן Deep Research ב-Gemini

  • deep-research-max-preview-04-2026

    סוכן Gemini Deep Research Max

הסוכן שאיתו רוצים ליצור אינטראקציה.

id string  (optional)

חובה. פלט בלבד. מזהה ייחודי של השלמת האינטראקציה.

status enum (string)  (optional)

חובה. פלט בלבד. הסטטוס של האינטראקציה.

ערכים אפשריים:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (אופציונלי)

חובה. פלט בלבד. השעה שבה התשובה נוצרה בפורמט ISO 8601‏ (YYYY-MM-DDThh:mm:ssZ).

updated string  (אופציונלי)

חובה. פלט בלבד. השעה שבה התשובה עודכנה לאחרונה בפורמט ISO 8601‏ (YYYY-MM-DDThh:mm:ssZ).

‫role string  (אופציונלי)

פלט בלבד. התפקיד של האינטראקציה.

outputs array (Content)  (אופציונלי)

פלט בלבד. תשובות מהמודל.

system_instruction string  (optional)

הוראה למערכת לגבי האינטראקציה.

tools מערך (Tool)  (אופציונלי)

רשימה של הצהרות על כלים שהמודל עשוי להשתמש בהם במהלך האינטראקציה.

usage Usage  (אופציונלי)

פלט בלבד. נתונים סטטיסטיים על השימוש בטוקן של בקשת האינטראקציה.

נתונים סטטיסטיים על השימוש בטוקן של בקשת האינטראקציה.

שדות

total_input_tokens integer  (optional)

מספר הטוקנים בהנחיה (בהקשר).

input_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש בטוקנים של קלט לפי אופן השימוש.

מספר הטוקנים של אופן תגובה יחיד.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio
  • video
  • document

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_cached_tokens integer  (optional)

מספר הטוקנים בחלק המאוחסן במטמון של ההנחיה (התוכן המאוחסן במטמון).

cached_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש בטוקנים במטמון לפי אופן השימוש.

מספר הטוקנים עבור מודאליות תגובה יחידה.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio
  • video
  • document

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_output_tokens integer  (optional)

המספר הכולל של טוקנים בכל התגובות שנוצרו.

output_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש באסימוני פלט לפי אופן השימוש.

מספר הטוקנים עבור מודאליות תגובה יחידה.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio
  • video
  • document

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_tool_use_tokens integer  (optional)

מספר הטוקנים שמופיעים בהנחיות לשימוש בכלים.

tool_use_tokens_by_modality ModalityTokens  (optional)

פירוט של השימוש בטוקנים של כלי לפי אופן השימוש.

מספר הטוקנים עבור מודאליות תגובה יחידה.

שדות

modality ResponseModality  (אופציונלי)

האופן שבו האסימונים נספרים.

ערכים אפשריים:

  • text
  • image
  • audio
  • video
  • document

‫tokens integer  (אופציונלי)

מספר הטוקנים של האופן.

total_thought_tokens integer  (optional)

מספר הטוקנים של המחשבות עבור מודלים של חשיבה.

total_tokens integer  (optional)

המספר הכולל של הטוקנים בבקשת האינטראקציה (הנחיה + תגובות + טוקנים פנימיים אחרים).

response_modalities ResponseModality  (optional)

האופנים המבוקשים של התגובה (TEXT, IMAGE, AUDIO).

ערכים אפשריים:

  • text
  • image
  • audio
  • video
  • document

response_format object  (optional)

ההגדרה הזו מחייבת שהתגובה שנוצרה תהיה אובייקט JSON שתואם לסכימת ה-JSON שצוינה בשדה הזה.

response_mime_type string  (optional)

סוג ה-MIME של התשובה. השדה הזה נדרש אם מוגדר response_format.

previous_interaction_id string  (optional)

המזהה של האינטראקציה הקודמת, אם יש כזו.

service_tier enum (string)  (optional)

רמת השירות של האינטראקציה.

ערכים אפשריים:

  • flex
  • standard
  • priority
‫input Content or array (Content) or array (Turn) or string  (optional)

הקלט לאינטראקציה.

agent_config object  (optional)

פרמטרים להגדרה של האינטראקציה עם הנציג.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

DynamicAgentConfig

הגדרות של סוכנים דינמיים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "dynamic".

DeepResearchAgentConfig

ההגדרה של סוכן Deep Research.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "deep-research".

thinking_summaries ThinkingSummaries  (אופציונלי)

האם לכלול בתשובה סיכום של תהליך החשיבה.

ערכים אפשריים:

  • auto
  • none

visualization enum (string)  (optional)

האם לכלול בתשובה פריטי ויזואליזציה.

ערכים אפשריים:

  • off
  • auto
collaborative_planning boolean  (optional)

ההגדרה הזו מאפשרת תכנון עם האדם שבתהליך לסוכן Deep Research. אם הערך הוא true, סוכן Deep Research יספק תוכנית מחקר בתשובה שלו. הנציג ימשיך רק אם המשתמש יאשר את התוכנית בתור הבא.

דוגמאות

דוגמה

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

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

תוכן

תוכן התשובה.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextContent

בלוק של תוכן טקסט.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

text string  (חובה)

חובה. תוכן הטקסט.

annotations Annotation  (אופציונלי)

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

השם של כתובת ה-URL.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

place_id string  (optional)

המזהה של המקום בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

תקציר של קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

ImageContent

בלוק תוכן של תמונה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

data string  (אופציונלי)

תוכן התמונה.

uri מחרוזת  (אופציונלי)

כתובת ה-URI של התמונה.

mime_type enum (string)  (optional)

סוג ה-MIME של התמונה.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

AudioContent

בלוק של תוכן אודיו.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "audio".

data string  (אופציונלי)

תוכן האודיו.

uri מחרוזת  (אופציונלי)

ה-URI של האודיו.

mime_type enum (string)  (optional)

סוג ה-MIME של האודיו.

ערכים אפשריים:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate integer  (אופציונלי)

קצב הדגימה של האודיו.

channels integer  (אופציונלי)

מספר ערוצי האודיו.

DocumentContent

בלוק תוכן במסמך.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "document".

data string  (אופציונלי)

תוכן המסמך.

uri מחרוזת  (אופציונלי)

ה-URI של המסמך.

mime_type enum (string)  (optional)

סוג ה-MIME של המסמך.

ערכים אפשריים:

  • application/pdf
VideoContent

בלוק של תוכן וידאו.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "video".

data string  (אופציונלי)

תוכן הסרטון.

uri מחרוזת  (אופציונלי)

ה-URI של הסרטון.

mime_type enum (string)  (optional)

סוג ה-MIME של הסרטון.

ערכים אפשריים:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

ThoughtContent

בלוק של מחשבה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "thought".

signature string  (אופציונלי)

חתימה שתתאים למקור ה-Backend שיהיה חלק מהיצירה.

summary ThoughtSummaryContent  (אופציונלי)

סיכום של המחשבה.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextContent

בלוק של תוכן טקסט.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

text string  (חובה)

חובה. תוכן הטקסט.

annotations Annotation  (אופציונלי)

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

השם של כתובת ה-URL.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

place_id string  (optional)

המזהה של המקום בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

תקציר של קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

ImageContent

בלוק תוכן של תמונה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

data string  (אופציונלי)

תוכן התמונה.

uri מחרוזת  (אופציונלי)

כתובת ה-URI של התמונה.

mime_type enum (string)  (optional)

סוג ה-MIME של התמונה.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

FunctionCallContent

בלוק תוכן של קריאה לכלי פונקציה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_call".

name string  (required)

חובה. השם של הכלי שאליו מתקשרים.

ארגומנטים object  (חובה)

חובה. הארגומנטים להעברה לפונקציה.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

CodeExecutionCallContent

תוכן שכולל ביצוע קוד.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_call".

arguments CodeExecutionCallArguments  (חובה)

חובה. הארגומנטים שיועברו להרצת הקוד.

הארגומנטים שיועברו להרצת הקוד.

שדות

language enum (string)  (optional)

שפת התכנות של ה-`code`.

ערכים אפשריים:

  • python
code string  (אופציונלי)

הקוד שיופעל.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextCallContent

תוכן ההקשר של כתובת ה-URL.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_call".

arguments UrlContextCallArguments  (required)

חובה. הארגומנטים להעברה להקשר של כתובת ה-URL.

הארגומנטים להעברה להקשר של כתובת ה-URL.

שדות

‫urls array (string)  (optional)

כתובות ה-URL לאחזור.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolCallContent

תוכן הקריאה לכלי MCPServer.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_call".

name string  (required)

חובה. השם של הכלי שהופעל.

server_name string  (required)

חובה. השם של שרת ה-MCP שנעשה בו שימוש.

ארגומנטים object  (חובה)

חובה. אובייקט JSON של הארגומנטים של הפונקציה.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchCallContent

תוכן בחיפוש Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_call".

arguments GoogleSearchCallArguments  (required)

חובה. הארגומנטים להעברה לחיפוש Google.

הארגומנטים להעברה לחיפוש Google.

שדות

‫queries array (string)  (optional)

שאילתות לחיפוש באינטרנט לחיפוש המשך באינטרנט.

search_type enum (string)  (optional)

סוג ההארקה של החיפוש שמופעל.

ערכים אפשריים:

  • web_search
  • image_search
  • enterprise_web_search
id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FileSearchCallContent

תוכן חיפוש הקבצים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_call".

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsCallContent

התוכן במפות Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_call".

arguments GoogleMapsCallArguments  (optional)

הארגומנטים להעברה לכלי של מפות Google.

הארגומנטים להעברה לכלי של מפות Google.

שדות

‫queries array (string)  (optional)

השאילתות שיופעלו.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FunctionResultContent

בלוק תוכן של תוצאה של כלי פונקציה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_result".

name string  (אופציונלי)

שם הכלי שהופעל.

is_error boolean  (optional)

האם קריאת הפונקציה הסתיימה בשגיאה.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

result array (FunctionResultSubcontent) or string  (required)

התוצאה של קריאת הכלי.

CodeExecutionResultContent

תוכן של תוצאת הרצת הקוד.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_result".

result string  (required)

חובה. הפלט של הרצת הקוד.

is_error boolean  (optional)

האם הרצת הקוד הסתיימה בשגיאה.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextResultContent

תוכן התוצאה של ההקשר של כתובת ה-URL.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_result".

result UrlContextResult  (required)

חובה. התוצאות של ההקשר של כתובת ה-URL.

התוצאה של ההקשר של כתובת ה-URL.

שדות

‫url string  (optional)

כתובת ה-URL שאוחזרה.

status enum (string)  (optional)

הסטטוס של אחזור כתובת ה-URL.

ערכים אפשריים:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

האם ההקשר של כתובת ה-URL הוביל לשגיאה.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchResultContent

תוכן של תוצאות חיפוש ב-Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_result".

result GoogleSearchResult  (required)

חובה. תוצאות מחיפוש Google.

התוצאה של חיפוש Google.

שדות

search_suggestions string  (optional)

קטע קוד של תוכן אינטרנט שאפשר להטמיע בדף אינטרנט או בתצוגת אינטרנט של אפליקציה.

is_error boolean  (optional)

האם החיפוש ב-Google הסתיים בשגיאה.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolResultContent

תוכן התוצאה של כלי MCPServer.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_result".

name string  (אופציונלי)

השם של הכלי שמופעל עבור קריאה ספציפית לכלי.

server_name string  (optional)

השם של שרת ה-MCP שנעשה בו שימוש.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

result array (FunctionResultSubcontent) or string  (required)

הפלט מהקריאה לשרת ה-MCP. יכול להיות טקסט פשוט או תוכן עשיר.

FileSearchResultContent

תוכן של תוצאת חיפוש קבצים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_result".

result FileSearchResult  (חובה)

חובה. התוצאות של חיפוש הקבצים.

התוצאה של חיפוש הקובץ.

שדות

custom_metadata array (object)  (optional)

מטא-נתונים שהמשתמש סיפק לגבי FileSearchResult.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsResultContent

תוכן של תוצאות במפות Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_result".

result GoogleMapsResult  (חובה)

חובה. התוצאות של מפות Google.

התוצאה של מפות Google.

שדות

מקומות מקומות  (אופציונלי)

המקומות שנמצאו.

שדות

place_id string  (optional)

המזהה של המקום בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

תקציר של קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

widget_context_token string  (optional)

שם המשאב של אסימון ההקשר של הווידג'ט של מפות Google.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

דוגמאות

טקסט

{
  "type": "text",
  "text": "Hello, how are you?"
}

תמונה

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

אודיו

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

מסמך

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

וידאו

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

חשיבה

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

בקשה להפעלת פונקציה

{
  "type": "function_call",
  "name": "get_weather",
  "id": "gth23981",
  "arguments": {
    "location": "Boston, MA"
  }
}

קריאה לביצוע קוד

{
  "type": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

קריאה להקשר של כתובת URL

{
  "type": "url_context_call",
  "id": "call_123456",
  "arguments": {
    "urls": [
      "https://www.example.com"
    ]
  }
}

קריאה לכלי שרת MCP

{
  "type": "mcp_server_tool_call",
  "id": "call_123456",
  "name": "get_forecast",
  "server_name": "weather_server",
  "arguments": {
    "city": "London"
  }
}

שיחה בחיפוש Google

{
  "type": "google_search_call",
  "id": "call_123456",
  "arguments": {
    "queries": [
      "weather in Boston"
    ]
  }
}

שיחה לחיפוש קבצים

{
  "type": "file_search_call",
  "id": "call_123456"
}

שיחות במפות Google

{
  "type": "google_maps_call",
  "id": "call_123456",
  "arguments": {
    "query": "best food near me"
  }
}

תוצאת הפונקציה

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": [
    {
      "type": "text",
      "text": "{\"weather\":\"sunny\"}"
    }
  ]
}

תוצאה של ביצוע קוד

{
  "type": "code_execution_result",
  "call_id": "call_123456",
  "result": "hello world"
}

תוצאה של הקשר כתובת ה-URL

{
  "type": "url_context_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.example.com",
      "status": "SUCCESS"
    }
  ]
}

תוצאת חיפוש ב-Google

{
  "type": "google_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.google.com/search?q=weather+in+Boston",
      "title": "Weather in Boston"
    }
  ]
}

תוצאה של כלי שרת MCP

{
  "type": "mcp_server_tool_result",
  "name": "get_forecast",
  "server_name": "weather_server",
  "call_id": "call_123456",
  "result": "sunny"
}

תוצאת חיפוש קבצים

{
  "type": "file_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

תוצאה במפות Google

{
  "type": "google_maps_result",
  "call_id": "call_123456",
  "result": [
    {
      "places": [
        {
          "url": "https://www.google.com/maps/search/best+food+near+me",
          "name": "Tasty Restaurant"
        }
      ]
    }
  ]
}

כלי

כלי שהמודל יכול להשתמש בו.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

תפקיד

כלי שהמודל יכול להשתמש בו.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function".

name string  (אופציונלי)

שם הפונקציה.

description string  (אופציונלי)

תיאור של הפונקציה.

parameters object  (אופציונלי)

סכימת ה-JSON של הפרמטרים של הפונקציה.

CodeExecution

כלי שהמודל יכול להשתמש בו כדי להריץ קוד.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution".

UrlContext

כלי שהמודל יכול להשתמש בו כדי לאחזר הקשר של כתובת URL.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context".

ComputerUse

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

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "computer_use".

environment enum (string)  (optional)

הסביבה שבה מתבצעת הפעולה.

ערכים אפשריים:

  • browser
‫excludedPredefinedFunctions array (string)  (optional)

רשימת הפונקציות המוגדרות מראש שמוחרגות מהקריאה למודל.

McpServer

שרת MCPServer הוא שרת שהמודל יכול להפעיל כדי לבצע פעולות.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server".

name string  (אופציונלי)

השם של MCPServer.

‫url string  (optional)

כתובת ה-URL המלאה של נקודת הקצה של שרת ה-MCP. דוגמה: "https://api.example.com/mcp"

headers object  (אופציונלי)

אופציונלי: שדות לכותרות אימות, פסק זמן וכו', אם צריך.

allowed_tools AllowedTools  (אופציונלי)

הכלים המותרים.

ההגדרה של הכלים המותרים.

שדות

mode ToolChoiceType  (optional)

המצב של בחירת הכלי.

ערכים אפשריים:

  • auto
  • any
  • none
  • validated

tools מערך (מחרוזת)  (אופציונלי)

השמות של הכלים המותרים.

GoogleSearch

כלי שהמודל יכול להשתמש בו כדי לחפש ב-Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search".

search_types array (enum (string))  (optional)

סוגי ההארקה של החיפוש שרוצים להפעיל.

ערכים אפשריים:

  • web_search
  • image_search
  • enterprise_web_search
FileSearch

כלי שהמודל יכול להשתמש בו כדי לחפש קבצים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search".

file_search_store_names array (string)  (optional)

הקובץ מכיל את שמות החנויות שרוצים לחפש.

top_k integer  (optional)

מספר החלקים של אחזור סמנטי שיש לאחזר.

‫metadata_filter string  (אופציונלי)

מסנן מטא-נתונים להחלה על המסמכים ועל חלקי הטקסט שחולצו באמצעות אחזור סמנטי.

GoogleMaps

כלי שהמודל יכול להשתמש בו כדי להתקשר למפות Google.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps".

enable_widget boolean  (optional)

האם להחזיר אסימון הקשר של הווידג'ט בתוצאה של קריאת הכלי בתגובה.

‫latitude number  (optional)

קו הרוחב של המיקום של המשתמש.

longitude number  (optional)

קו האורך של המיקום של המשתמש.

אחזור

כלי שהמודל יכול להשתמש בו כדי לאחזר קבצים.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "retrieval".

retrieval_types array (enum (string))  (optional)

סוגי אחזור הקבצים שרוצים להפעיל.

ערכים אפשריים:

  • vertex_ai_search
vertex_ai_search_config VertexAISearchConfig  (optional)

משמשת לציון הגדרות ל-VertexAISearch.

משמשת לציון הגדרות ל-VertexAISearch.

שדות

engine string  (אופציונלי)

אופציונלי. משמש לציון חיפוש מבוסס-Vertex AI.

datastores array (string)  (optional)

אופציונלי. משמש לציון מאגרי נתונים של חיפוש מבוסס-Vertex AI.

דוגמאות

פונקציה

CodeExecution

UrlContext

ComputerUse

McpServer

GoogleSearch

FileSearch

GoogleMaps

שליפה

אין דוגמאות זמינות מהסוג הזה.

Turn

שדות

‫role string  (אופציונלי)

הגורם שיזם את התור הזה. צריך להיות משתמש לקלט או מודל לפלט של המודל.

content array (Content) or string  (optional)

לא סופק תיאור.

דוגמאות

תור המשתמש

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

התור של המודל

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: event_type

InteractionStartEvent

event_type object  (required)

לא סופק תיאור.

הערך תמיד יהיה "interaction.start".

interaction Interaction  (חובה)

לא סופק תיאור.

event_id string  (optional)

טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

InteractionCompleteEvent

event_type object  (required)

לא סופק תיאור.

הערך תמיד יהיה "interaction.complete".

interaction Interaction  (חובה)

חובה. האינטראקציה הושלמה עם פלט ריק כדי להקטין את גודל המטען הייעודי (payload). כדי לקבל את הפלט בפועל, צריך להשתמש באירועי ContentDelta הקודמים.

event_id string  (optional)

טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

InteractionStatusUpdate

event_type object  (required)

לא סופק תיאור.

הערך תמיד יהיה "interaction.status_update".

interaction_id string  (required)

לא סופק תיאור.

status enum (string)  (required)

לא סופק תיאור.

ערכים אפשריים:

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_id string  (optional)

טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ContentStart

event_type object  (required)

לא סופק תיאור.

הערך תמיד יהיה "content.start".

index integer  (required)

לא סופק תיאור.

content Content  (חובה)

לא סופק תיאור.

event_id string  (optional)

טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ContentDelta

event_type object  (required)

לא סופק תיאור.

הערך תמיד יהיה "content.delta".

index integer  (required)

לא סופק תיאור.

delta ContentDeltaData  (חובה)

לא סופק תיאור.

נתוני התוכן של הדלתא של קטע תוכן.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

text string  (חובה)

לא סופק תיאור.

ImageDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

AudioDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "audio".

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
  • audio/mpeg
  • audio/m4a
  • audio/l16
  • audio/opus
  • audio/alaw
  • audio/mulaw
rate integer  (אופציונלי)

קצב הדגימה של האודיו.

channels integer  (אופציונלי)

מספר ערוצי האודיו.

DocumentDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "document".

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • application/pdf
VideoDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "video".

data string  (אופציונלי)

לא סופק תיאור.

uri מחרוזת  (אופציונלי)

לא סופק תיאור.

mime_type enum (string)  (optional)

לא סופק תיאור.

ערכים אפשריים:

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

ThoughtSummaryDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "thought_summary".

content ThoughtSummaryContent  (אופציונלי)

פריט סיכום חדש שיוסף למחשבה.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

TextContent

בלוק של תוכן טקסט.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text".

text string  (חובה)

חובה. תוכן הטקסט.

annotations Annotation  (אופציונלי)

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

השם של כתובת ה-URL.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

place_id string  (optional)

המזהה של המקום בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

תקציר של קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

ImageContent

בלוק תוכן של תמונה.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "image".

data string  (אופציונלי)

תוכן התמונה.

uri מחרוזת  (אופציונלי)

כתובת ה-URI של התמונה.

mime_type enum (string)  (optional)

סוג ה-MIME של התמונה.

ערכים אפשריים:

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
  • image/gif
  • image/bmp
  • image/tiff
resolution MediaResolution  (אופציונלי)

הרזולוציה של המדיה.

ערכים אפשריים:

  • low
  • medium
  • high
  • ultra_high

ThoughtSignatureDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "thought_signature".

signature string  (אופציונלי)

חתימה שתתאים למקור ה-Backend שיהיה חלק מהיצירה.

FunctionCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_call".

name string  (required)

לא סופק תיאור.

ארגומנטים object  (חובה)

לא סופק תיאור.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

CodeExecutionCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_call".

arguments CodeExecutionCallArguments  (חובה)

לא סופק תיאור.

הארגומנטים שיועברו להרצת הקוד.

שדות

language enum (string)  (optional)

שפת התכנות של ה-`code`.

ערכים אפשריים:

  • python
code string  (אופציונלי)

הקוד שיופעל.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_call".

arguments UrlContextCallArguments  (required)

לא סופק תיאור.

הארגומנטים להעברה להקשר של כתובת ה-URL.

שדות

‫urls array (string)  (optional)

כתובות ה-URL לאחזור.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_call".

arguments GoogleSearchCallArguments  (required)

לא סופק תיאור.

הארגומנטים להעברה לחיפוש Google.

שדות

‫queries array (string)  (optional)

שאילתות לחיפוש באינטרנט לחיפוש המשך באינטרנט.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_call".

name string  (required)

לא סופק תיאור.

server_name string  (required)

לא סופק תיאור.

ארגומנטים object  (חובה)

לא סופק תיאור.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FileSearchCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_call".

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsCallDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_call".

arguments GoogleMapsCallArguments  (optional)

הארגומנטים להעברה לכלי של מפות Google.

הארגומנטים להעברה לכלי של מפות Google.

שדות

‫queries array (string)  (optional)

השאילתות שיופעלו.

id string  (חובה)

חובה. מזהה ייחודי של קריאה ספציפית לכלי.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

FunctionResultDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "function_result".

name string  (אופציונלי)

לא סופק תיאור.

is_error boolean  (optional)

לא סופק תיאור.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

result array (FunctionResultSubcontent) or string  (required)

לא סופק תיאור.

CodeExecutionResultDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "code_execution_result".

result string  (required)

לא סופק תיאור.

is_error boolean  (optional)

לא סופק תיאור.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

UrlContextResultDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_context_result".

result UrlContextResult  (required)

לא סופק תיאור.

התוצאה של ההקשר של כתובת ה-URL.

שדות

‫url string  (optional)

כתובת ה-URL שאוחזרה.

status enum (string)  (optional)

הסטטוס של אחזור כתובת ה-URL.

ערכים אפשריים:

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (optional)

לא סופק תיאור.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleSearchResultDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_search_result".

result GoogleSearchResult  (required)

לא סופק תיאור.

התוצאה של חיפוש Google.

שדות

search_suggestions string  (optional)

קטע קוד של תוכן אינטרנט שאפשר להטמיע בדף אינטרנט או בתצוגת אינטרנט של אפליקציה.

is_error boolean  (optional)

לא סופק תיאור.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

McpServerToolResultDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "mcp_server_tool_result".

name string  (אופציונלי)

לא סופק תיאור.

server_name string  (optional)

לא סופק תיאור.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

result array (FunctionResultSubcontent) or string  (required)

לא סופק תיאור.

FileSearchResultDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_search_result".

result FileSearchResult  (חובה)

לא סופק תיאור.

התוצאה של חיפוש הקובץ.

שדות

custom_metadata array (object)  (optional)

מטא-נתונים שהמשתמש סיפק לגבי FileSearchResult.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

GoogleMapsResultDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "google_maps_result".

result GoogleMapsResult  (optional)

התוצאות של מפות Google.

התוצאה של מפות Google.

שדות

מקומות מקומות  (אופציונלי)

המקומות שנמצאו.

שדות

place_id string  (optional)

המזהה של המקום בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

תקציר של קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

widget_context_token string  (optional)

שם המשאב של אסימון ההקשר של הווידג'ט של מפות Google.

call_id string  (required)

חובה. מזהה שצריך להיות זהה למזהה מבלוק בקשה להפעלת פונקציה.

signature string  (אופציונלי)

גיבוב חתימה לאימות בקצה העורפי.

TextAnnotationDelta

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "text_annotation".

annotations Annotation  (אופציונלי)

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

מידע על ציטוטים של תוכן שנוצר על ידי מודל.

סוגים אפשריים

ערך הדיסקרימינטור הפולימורפי: type

UrlCitation

הערה של ציטוט כתובת URL.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "url_citation".

‫url string  (optional)

כתובת ה-URL.

title string  (אופציונלי)

השם של כתובת ה-URL.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

FileCitation

הערה לציטוט קובץ.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "file_citation".

document_uri string  (אופציונלי)

ה-URI של הקובץ.

file_name string  (optional)

שם הקובץ.

source string  (אופציונלי)

המקור שמשויך לחלק מהטקסט.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

PlaceCitation

הערה של ציטוט מקום.

type object  (חובה)

לא סופק תיאור.

הערך תמיד יהיה "place_citation".

place_id string  (optional)

המזהה של המקום בפורמט ‎ `places/{place_id}` ‎.

name string  (אופציונלי)

שם המקום.

‫url string  (optional)

הפניה ל-URI של המקום.

review_snippets ReviewSnippet  (אופציונלי)

קטעי ביקורות שמשמשים ליצירת תשובות לגבי התכונות של מקום מסוים במפות Google.

תקציר של קטע מביקורת של משתמש שעונה על שאלה לגבי התכונות של מקום ספציפי במפות Google.

שדות

title string  (אופציונלי)

כותרת הביקורת.

‫url string  (optional)

קישור שמתאים לביקורת של המשתמש במפות Google.

review_id string  (optional)

המזהה של קטע הביקורת.

start_index integer  (optional)

תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, ונמדד בבייטים.

end_index integer  (optional)

סוף הקטע המשויך, לא כולל.

event_id string  (optional)

טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ContentStop

event_type object  (required)

לא סופק תיאור.

הערך תמיד יהיה "content.stop".

index integer  (required)

לא סופק תיאור.

event_id string  (optional)

טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

ErrorEvent

event_type object  (required)

לא סופק תיאור.

הערך תמיד יהיה "error".

error Error  (אופציונלי)

לא סופק תיאור.

הודעת שגיאה מאינטראקציה.

שדות

code string  (אופציונלי)

‫URI שמזהה את סוג השגיאה.

‫message string  (אופציונלי)

הודעת שגיאה שאנשים יכולים לקרוא.

event_id string  (optional)

טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.

דוגמאות

התחלת האינטראקציה

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "status": "in_progress"
  }
}

האינטראקציה הסתיימה

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "role": "model",
    "status": "completed",
    "updated": "2025-12-09T18:45:40Z",
    "usage": {
      "input_tokens_by_modality": [
        {
          "modality": "text",
          "tokens": 11
        }
      ],
      "total_cached_tokens": 0,
      "total_input_tokens": 11,
      "total_output_tokens": 364,
      "total_thought_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

עדכון סטטוס האינטראקציה

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

תחילת התוכן

{
  "event_type": "content.start",
  "content": {
    "type": "text"
  },
  "index": 1
}

דלתא של תוכן

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

הפסקת התוכן

{
  "event_type": "content.stop",
  "index": 1
}

אירוע שגיאה

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}