Gemini API

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

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

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

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

גוף הבקשה

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

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

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

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

  • gemini-2.5-pro

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

  • gemini-2.5-flash

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

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

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

  • gemini-2.5-flash-lite

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

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

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

  • gemini-2.5-flash-preview-native-audio-dialog

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

  • gemini-2.5-flash-image-preview

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

  • gemini-2.5-pro-preview-tts

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

  • gemini-3-pro-preview

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

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

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

השם של ה-`Agent` ששימש ליצירת האינטראקציה.
חובה אם לא צוין הערך `model`.

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

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

    Gemini Deep Research Agent

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

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)

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

tool_choice ToolChoice  (אופציונלי)

הכלי שנבחר לאינטראקציה.

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

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

ToolChoiceType

בסוג הזה אין שדות ספציפיים.

ToolChoiceConfig

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

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

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

שדות

mode ToolChoiceType  (optional)

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

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

  • auto
  • any
  • none
  • validated

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

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

thinking_level ThinkingLevel  (optional)

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

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

  • low
  • high

thinking_summaries ThinkingSummaries  (optional)

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

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

  • auto
  • none

max_output_tokens integer  (optional)

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

speech_config SpeechConfig  (optional)

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

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

שדות

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

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

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

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

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

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

agent_config object  (optional)

הגדרת הסוכן
הגדרות הסוכן.
חלופה ל-`generation_config`. רלוונטי רק אם הוגדר `agent`.

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

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

DynamicAgentConfig

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

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

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

DeepResearchAgentConfig

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

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

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

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

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

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

  • auto
  • none

previous_interaction_id string  (optional)

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

response_modalities ResponseModality  (optional)

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

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

  • text
  • image
  • audio

תשובה

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

בקשה פשוטה

דוגמה לתשובה

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "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_reasoning_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

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

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "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_reasoning_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

קלט תמונה

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "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_reasoning_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

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

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "function_call": {
        "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_reasoning_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": "model",
  "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_reasoning_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.

api_version string  (optional)

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

תשובה

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

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

דוגמה לתשובה

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-2.5-flash",
  "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": "model"
}

משאבים

אינטראקציה

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

שדות

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

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

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

  • gemini-2.5-pro

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

  • gemini-2.5-flash

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

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

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

  • gemini-2.5-flash-lite

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

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

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

  • gemini-2.5-flash-preview-native-audio-dialog

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

  • gemini-2.5-flash-image-preview

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

  • gemini-2.5-pro-preview-tts

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

  • gemini-3-pro-preview

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

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

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

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

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

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

    Gemini Deep Research Agent

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

id string  (optional)

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

status enum (string)  (optional)

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

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

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

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

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

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

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

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

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

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

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

פלט בלבד. סוג האובייקט של האינטראקציה. הערך שמוגדר תמיד הוא interaction.

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

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

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

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

שדות

total_input_tokens integer  (optional)

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

input_tokens_by_modality ModalityTokens  (optional)

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

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

שדות

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

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

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

  • text
  • image
  • audio

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

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

total_cached_tokens integer  (optional)

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

cached_tokens_by_modality ModalityTokens  (optional)

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

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

שדות

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

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

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

  • text
  • image
  • audio

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

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

total_output_tokens integer  (optional)

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

output_tokens_by_modality ModalityTokens  (optional)

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

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

שדות

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

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

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

  • text
  • image
  • audio

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

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

total_tool_use_tokens integer  (optional)

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

tool_use_tokens_by_modality ModalityTokens  (optional)

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

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

שדות

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

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

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

  • text
  • image
  • audio

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

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

total_reasoning_tokens integer  (optional)

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

total_tokens integer  (optional)

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

previous_interaction_id string  (optional)

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

דוגמאות

דוגמה

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-2.5-flash",
  "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_reasoning_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

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

תוכן

תוכן התשובה.

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

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

TextContent

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

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

תוכן הטקסט.

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

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

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

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

שדות

start_index integer  (optional)

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

end_index integer  (optional)

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

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

המקור שמיוחס לחלק מהטקסט. יכול להיות כתובת URL, שם או מזהה אחר.

ImageContent

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

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

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

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

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

mime_type ImageMimeTypeOption  (optional)

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

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

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

resolution MediaResolution  (אופציונלי)

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

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

  • low
  • medium
  • high

AudioContent

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

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

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

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

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

mime_type AudioMimeTypeOption  (optional)

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

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

DocumentContent

אבן בניין של תוכן במסמך.

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

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

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

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

mime_type string  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

VideoContent

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

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

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

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

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

mime_type VideoMimeTypeOption  (optional)

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

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

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

resolution MediaResolution  (אופציונלי)

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

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

  • low
  • medium
  • high

ThoughtContent

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

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

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

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

FunctionCallContent

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

name string  (required)

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (חובה)

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

FunctionResultContent

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

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

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

is_error boolean  (optional)

האם קריאת הכלי הסתיימה בשגיאה.

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

result object or string  (required)

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

call_id string  (required)

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

CodeExecutionCallContent

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

arguments CodeExecutionCallArguments  (optional)

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

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

שדות

language enum (string)  (optional)

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

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

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

הקוד שיופעל.

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

CodeExecutionResultContent

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

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

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

is_error boolean  (optional)

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

call_id string  (optional)

מזהה שצריך להיות זהה למזהה מבלוק הקוד של הקריאה להרצת הקוד.

UrlContextCallContent

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

arguments UrlContextCallArguments  (optional)

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

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

שדות

urls array (string)  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

UrlContextResultContent

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

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

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

result UrlContextResult  (אופציונלי)

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

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

שדות

url string  (optional)

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

status enum (string)  (optional)

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

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

call_id string  (optional)

מזהה שצריך להיות זהה למזהה מבלוק השיחות של הקשר של כתובת ה-URL.

GoogleSearchCallContent

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

arguments GoogleSearchCallArguments  (optional)

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

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

שדות

queries array (string)  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

GoogleSearchResultContent

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

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

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

result GoogleSearchResult  (אופציונלי)

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

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

שדות

url string  (optional)

הפניה ל-URI של תוצאת החיפוש.

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

הכותרת של תוצאת החיפוש.

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

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

is_error boolean  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

call_id string  (optional)

מזהה שתואם למזהה מחסימת שיחות בחיפוש Google.

McpServerToolCallContent

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

name string  (required)

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

server_name string  (required)

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (חובה)

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

McpServerToolResultContent

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

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

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

server_name string  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

result object or string  (required)

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

call_id string  (required)

המזהה צריך להיות זהה למזהה מבלוק הקריאה לכלי של שרת ה-MCP.

FileSearchResultContent

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

result FileSearchResult  (אופציונלי)

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

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

שדות

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

הכותרת של תוצאת החיפוש.

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

הטקסט של תוצאת החיפוש.

file_search_store string  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

דוגמאות

טקסט

{
  "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": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": {
    "weather": "sunny"
  }
}

קריאה להרצת קוד

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

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

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

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

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

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

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

שיחה בחיפוש Google

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

תוצאת חיפוש ב-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 Server Tool Call

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

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

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

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

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

כלי

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

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

תפקיד

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

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

שם הפונקציה.

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

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

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

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

type string  (חובה)

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

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

GoogleSearch

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

type string  (חובה)

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

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

CodeExecution

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

type string  (חובה)

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

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

UrlContext

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

type string  (חובה)

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

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

ComputerUse

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

type string  (חובה)

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

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

environment enum (string)  (optional)

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

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

  • browser
excludedPredefinedFunctions array (string)  (optional)

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

McpServer

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

type string  (חובה)

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

הערך תמיד יהיה "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 מערך (מחרוזת)  (אופציונלי)

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

FileSearch

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

file_search_store_names array (string)  (optional)

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

top_k integer  (optional)

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

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

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

type string  (חובה)

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

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

דוגמאות

פונקציה

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

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

InteractionEvent

event_type enum (string)  (optional)

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

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

  • interaction.start
  • interaction.complete
interaction Interaction  (אופציונלי)

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

event_id string  (optional)

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

InteractionStatusUpdate

interaction_id string  (optional)

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

status enum (string)  (optional)

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

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

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
event_type string  (optional)

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

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

event_id string  (optional)

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

ContentStart

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

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

content Content  (optional)

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

event_type string  (optional)

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

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

event_id string  (optional)

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

ContentDelta

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

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

event_type string  (optional)

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

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

event_id string  (optional)

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

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

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

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

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

TextDelta

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

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

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

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

שדות

start_index integer  (optional)

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

end_index integer  (optional)

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

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

המקור שמיוחס לחלק מהטקסט. יכול להיות כתובת URL, שם או מזהה אחר.

ImageDelta

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

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

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

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

mime_type ImageMimeTypeOption  (אופציונלי)

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

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

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

resolution MediaResolution  (אופציונלי)

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

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

  • low
  • medium
  • high

AudioDelta

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

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

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

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

mime_type AudioMimeTypeOption  (optional)

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

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

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

DocumentDelta

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

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

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

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

mime_type string  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

VideoDelta

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

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

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

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

mime_type VideoMimeTypeOption  (optional)

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

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

  • video/mp4
  • video/mpeg
  • video/mov
  • video/avi
  • video/x-flv
  • video/mpg
  • video/webm
  • video/wmv
  • video/3gpp

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

resolution MediaResolution  (אופציונלי)

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

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

  • low
  • medium
  • high

ThoughtSummaryDelta

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

content ImageContent or TextContent  (optional)

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

ThoughtSignatureDelta

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

FunctionCallDelta

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

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

FunctionResultDelta

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

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

is_error boolean  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

result object or string  (optional)

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

call_id string  (optional)

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

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (optional)

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

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

שדות

language enum (string)  (optional)

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

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

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

הקוד שיופעל.

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

CodeExecutionResultDelta

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

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

is_error boolean  (optional)

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

call_id string  (optional)

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

UrlContextCallDelta

arguments UrlContextCallArguments  (optional)

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

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

שדות

urls array (string)  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

UrlContextResultDelta

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

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

result UrlContextResult  (אופציונלי)

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

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

שדות

url string  (optional)

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

status enum (string)  (optional)

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

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

call_id string  (optional)

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

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (optional)

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

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

שדות

queries array (string)  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

GoogleSearchResultDelta

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

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

result GoogleSearchResult  (אופציונלי)

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

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

שדות

url string  (optional)

הפניה ל-URI של תוצאת החיפוש.

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

הכותרת של תוצאת החיפוש.

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

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

is_error boolean  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

call_id string  (optional)

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

McpServerToolCallDelta

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

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

server_name string  (optional)

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

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

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

id string  (optional)

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

McpServerToolResultDelta

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

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

server_name string  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

result object or string  (optional)

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

call_id string  (optional)

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

FileSearchResultDelta

result FileSearchResult  (אופציונלי)

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

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

שדות

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

הכותרת של תוצאת החיפוש.

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

הטקסט של תוצאת החיפוש.

file_search_store string  (optional)

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

type string  (חובה)

משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.

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

ContentStop

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

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

event_type string  (optional)

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

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

event_id string  (optional)

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

ErrorEvent

event_type string  (optional)

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

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

error Error  (אופציונלי)

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

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

שדות

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

‫URI שמזהה את סוג השגיאה.

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

הודעת שגיאה שאנשים יכולים לקרוא.

event_id string  (optional)

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

דוגמאות

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

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-2.5-flash",
    "object": "interaction",
    "status": "in_progress"
  }
}

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

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-2.5-flash",
    "object": "interaction",
    "outputs": [
      {
        "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh",
        "type": "thought"
      },
      {
        "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",
        "type": "text"
      },
      {
        "text": " for one beloved anomaly: a chipped porcelain teacup, inherited from her grandmother, which held her morning Earl Grey.\n\nOne Tuesday, stirring her tea, Elara paused. At the bottom, nestled against the porcelain, was a star.",
        "type": "text"
      },
      {
        "text": " Not a star-shaped tea leaf, but a miniature, perfectly formed celestial body, radiating a faint, cool luminescence. Before she could gasp, it dissolved, leaving only the amber swirl of her brew. She dismissed it as a trick of",
        "type": "text"
      },
      {
        "text": " tired eyes.\n\nBut the next morning, a gossamer-thin feather, smaller than an eyelash and shimmering with iridescent hues, floated on the surface. It vanished the moment she tried to touch it. A week later, a single,",
        "type": "text"
      },
      {
        "text": " impossibly delicate bloom, like spun moonbeam, unfolded in her cup before fading into nothingness.\n\nThese weren't illusions. Each day, Elara\u2019s chipped teacup offered a fleeting, exquisite secret. A tiny, perfect",
        "type": "text"
      },
      {
        "text": " crystal, a miniature spiral nebula, a fragment of rainbow caught in liquid form. They never lingered, never accumulated, simply *were* and then *weren't*, leaving behind a residue of quiet wonder.\n\nElara never spoke",
        "type": "text"
      },
      {
        "text": " of it. It was her private wellspring, a daily reminder that magic could exist in the smallest, most overlooked corners of the world. Her routine remained unchanged, her external life a picture of calm, but inside, a secret garden blo",
        "type": "text"
      },
      {
        "text": "omed. Each dawn brought not just tea, but the silent promise of extraordinary beauty, waiting patiently in a chipped teacup.",
        "type": "text"
      }
    ],
    "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_reasoning_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"
  }
}