Gemini Interactions API הוא API ניסיוני שמאפשר למפתחים לבנות אפליקציות מבוססות-AI גנרטיבי באמצעות מודלים של Gemini. Gemini הוא המודל הכי מתקדם שלנו, והוא נבנה מההתחלה כמודל רב-אופנים. הוא יכול להכליל ולהבין בצורה חלקה סוגים שונים של מידע, כולל שפה, תמונות, אודיו, וידאו וקוד, לפעול על פיהם ולשלב ביניהם. אתם יכולים להשתמש ב-Gemini API לתרחישי שימוש כמו ניתוח טקסט ותמונות, יצירת תוכן, סוכני דיאלוג, מערכות סיכום וסיווג ועוד.
יצירת אינטראקציה
יצירת אינטראקציה חדשה.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
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המודל הכי חכם שלנו עם יכולות הסקת מסקנות והבנה מולטי-מודאלית ברמה הכי גבוהה, ויכולות עוצמתיות של סוכנים וקידוד.
agent AgentOption (אופציונלי)
השם של ה-`Agent` ששימש ליצירת האינטראקציה.
חובה אם לא צוין הערך `model`.
ערכים אפשריים:
-
deep-research-pro-preview-12-2025Gemini Deep Research Agent
הקלט לאינטראקציה (משותף למודל ולסוכן).
הוראה למערכת לגבי האינטראקציה.
רשימה של הצהרות על כלים שהמודל עשוי להשתמש בהם במהלך האינטראקציה.
ההגדרה הזו מחייבת שהתגובה שנוצרה תהיה אובייקט JSON שתואם לסכימת ה-JSON שצוינה בשדה הזה.
סוג ה-MIME של התגובה. השדה הזה נדרש אם מוגדר response_format.
קלט בלבד. אם האינטראקציה תועבר בסטרימינג.
קלט בלבד. האם לאחסן את התשובה והבקשה לאחזור מאוחר יותר.
האם להריץ את האינטראקציה עם המודל ברקע.
generation_config GenerationConfig (optional)
הגדרת המודל
פרמטרים להגדרת האינטראקציה עם המודל.
חלופה ל-`agent_config`. רלוונטי רק אם מוגדר `model`.
שדות
המדיניות קובעת את מידת הרנדומליות של הפלט.
ההסתברות המצטברת המקסימלית של אסימונים שצריך לקחת בחשבון כשמבצעים דגימה.
ה-Seed שמשמש בפענוח לשחזור.
רשימה של רצפי תווים שיפסיקו את אינטראקציית הפלט.
tool_choice ToolChoice (אופציונלי)
הכלי שנבחר לאינטראקציה.
סוגים אפשריים
ToolChoiceType
בסוג הזה אין שדות ספציפיים.
ToolChoiceConfig
allowed_tools AllowedTools (אופציונלי)
לא סופק תיאור.
שדות
mode ToolChoiceType (optional)
המצב של בחירת הכלי.
ערכים אפשריים:
-
auto -
any -
none -
validated
שמות הכלים המותרים.
thinking_level ThinkingLevel (optional)
רמת הטוקנים של המחשבות שהמודל צריך ליצור.
ערכים אפשריים:
-
low -
high
thinking_summaries ThinkingSummaries (optional)
האם לכלול סיכומי מחשבות בתשובה.
ערכים אפשריים:
-
auto -
none
מספר האסימונים המקסימלי שיופיע בתשובה.
speech_config SpeechConfig (optional)
הגדרות לאינטראקציה קולית.
שדות
הקול של הדובר.
השפה של הדיבור.
שם הדובר, שצריך להיות זהה לשם הדובר שצוין בהנחיה.
agent_config object (optional)
הגדרת הסוכן
הגדרות הסוכן.
חלופה ל-`generation_config`. רלוונטי רק אם הוגדר `agent`.
סוגים אפשריים
ערך הדיסקרימינטור הפולימורפי: type
DynamicAgentConfig
הגדרות של סוכנים דינמיים.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "dynamic".
DeepResearchAgentConfig
ההגדרה של סוכן Deep Research.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "deep-research".
thinking_summaries ThinkingSummaries (אופציונלי)
האם לכלול סיכומי מחשבות בתשובה.
ערכים אפשריים:
-
auto -
none
המזהה של האינטראקציה הקודמת, אם יש כזו.
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 } }
אחזור אינטראקציה
אחזור הפרטים המלאים של אינטראקציה יחידה על סמך הערך של `Interaction.id`.
פרמטרים של נתיב או שאילתה
המזהה הייחודי של האינטראקציה לאחזור.
אם המדיניות מוגדרת כ-True, התוכן שנוצר יועבר בהדרגה.
ברירת המחדל: False
אופציונלי. אם הפרמטר הזה מוגדר, זרם האינטראקציות ימשיך מהחלק הבא אחרי האירוע שמסומן על ידי מזהה האירוע. אפשר להשתמש בו רק אם הערך של stream הוא true.
באיזו גרסה של ה-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?" } ] }
מחיקת אינטראקציה
מחיקת האינטראקציה לפי מזהה.
פרמטרים של נתיב או שאילתה
המזהה הייחודי של האינטראקציה שרוצים למחוק.
באיזו גרסה של ה-API להשתמש.
תשובה
אם הפעולה בוצעה ללא שגיאות, התגובה תהיה ריקה.
מחיקת אינטראקציה
ביטול אינטראקציה
ביטול אינטראקציה לפי מזהה. ההגדרה הזו רלוונטית רק לאינטראקציות ברקע שעדיין פועלות.
פרמטרים של נתיב או שאילתה
המזהה הייחודי של האינטראקציה לאחזור.
באיזו גרסה של ה-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המודל הכי חכם שלנו עם יכולות הסקת מסקנות והבנה מולטי-מודאלית ברמה הכי גבוהה, ויכולות עוצמתיות של סוכנים וקידוד.
agent AgentOption (אופציונלי)
השם של ה-`Agent` ששימש ליצירת האינטראקציה.
ערכים אפשריים:
-
deep-research-pro-preview-12-2025Gemini Deep Research Agent
פלט בלבד. מזהה ייחודי של השלמת האינטראקציה.
פלט בלבד. הסטטוס של האינטראקציה.
ערכים אפשריים:
-
in_progress -
requires_action -
completed -
failed -
cancelled
פלט בלבד. השעה שבה התגובה נוצרה בפורמט ISO 8601 (YYYY-MM-DDThh:mm:ssZ).
פלט בלבד. השעה שבה התשובה עודכנה לאחרונה בפורמט ISO 8601 (YYYY-MM-DDThh:mm:ssZ).
פלט בלבד. התפקיד של האינטראקציה.
פלט בלבד. תשובות מהמודל.
פלט בלבד. סוג האובייקט של האינטראקציה. הערך שמוגדר תמיד הוא interaction.
הערך תמיד יהיה "interaction".
usage Usage (אופציונלי)
פלט בלבד. נתונים סטטיסטיים על השימוש בטוקן של בקשת האינטראקציה.
שדות
מספר הטוקנים בהנחיה (בהקשר).
input_tokens_by_modality ModalityTokens (optional)
פירוט של השימוש בטוקנים של קלט לפי אופן השימוש.
שדות
modality ResponseModality (אופציונלי)
האופן שבו האסימונים נספרים.
ערכים אפשריים:
-
text -
image -
audio
מספר הטוקנים של האופן.
מספר הטוקנים בחלק המאוחסן במטמון של ההנחיה (התוכן המאוחסן במטמון).
cached_tokens_by_modality ModalityTokens (optional)
פירוט של השימוש בטוקנים במטמון לפי אופן השימוש.
שדות
modality ResponseModality (אופציונלי)
האופן שבו האסימונים נספרים.
ערכים אפשריים:
-
text -
image -
audio
מספר הטוקנים של האופן.
המספר הכולל של טוקנים בכל התגובות שנוצרו.
output_tokens_by_modality ModalityTokens (optional)
פירוט של השימוש באסימוני פלט לפי אופן השימוש.
שדות
modality ResponseModality (אופציונלי)
האופן שבו האסימונים נספרים.
ערכים אפשריים:
-
text -
image -
audio
מספר הטוקנים של האופן.
מספר הטוקנים שמופיעים בהנחיות לשימוש בכלים.
tool_use_tokens_by_modality ModalityTokens (optional)
פירוט של השימוש בטוקנים של כלי לפי אופן השימוש.
שדות
modality ResponseModality (אופציונלי)
האופן שבו האסימונים נספרים.
ערכים אפשריים:
-
text -
image -
audio
מספר הטוקנים של האופן.
מספר הטוקנים של המחשבות עבור מודלים של חשיבה.
המספר הכולל של הטוקנים בבקשת האינטראקציה (הנחיה + תגובות + טוקנים פנימיים אחרים).
המזהה של האינטראקציה הקודמת, אם יש כזו.
דוגמאות
דוגמה
{ "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
בלוק של תוכן טקסט.
תוכן הטקסט.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "text".
annotations Annotation (אופציונלי)
מידע על ציטוט של תוכן שנוצר על ידי מודל.
שדות
תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, בבייטים.
סוף הקטע המשויך, לא כולל.
המקור שמיוחס לחלק מהטקסט. יכול להיות כתובת URL, שם או מזהה אחר.
ImageContent
בלוק תוכן של תמונה.
לא סופק תיאור.
לא סופק תיאור.
mime_type ImageMimeTypeOption (optional)
לא סופק תיאור.
ערכים אפשריים:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "image".
resolution MediaResolution (אופציונלי)
הרזולוציה של המדיה.
ערכים אפשריים:
-
low -
medium -
high
AudioContent
בלוק של תוכן אודיו.
לא סופק תיאור.
לא סופק תיאור.
mime_type AudioMimeTypeOption (optional)
לא סופק תיאור.
ערכים אפשריים:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "audio".
DocumentContent
אבן בניין של תוכן במסמך.
לא סופק תיאור.
לא סופק תיאור.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "document".
VideoContent
בלוק של תוכן וידאו.
לא סופק תיאור.
לא סופק תיאור.
mime_type VideoMimeTypeOption (optional)
לא סופק תיאור.
ערכים אפשריים:
-
video/mp4 -
video/mpeg -
video/mov -
video/avi -
video/x-flv -
video/mpg -
video/webm -
video/wmv -
video/3gpp
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "video".
resolution MediaResolution (אופציונלי)
הרזולוציה של המדיה.
ערכים אפשריים:
-
low -
medium -
high
ThoughtContent
בלוק של מחשבה.
חתימה שתתאים למקור הנתונים בעורף האתר, כדי שתהיה חלק מהיצירה.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "thought".
summary ThoughtSummary (אופציונלי)
סיכום של המחשבה.
FunctionCallContent
בלוק תוכן של קריאה לכלי פונקציה.
השם של הכלי שאליו מתקשרים.
הארגומנטים להעברה לפונקציה.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "function_call".
מזהה ייחודי של קריאה ספציפית לכלי.
FunctionResultContent
בלוק תוכן של תוצאה של כלי פונקציה.
השם של הכלי שהופעל.
האם קריאת הכלי הסתיימה בשגיאה.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "function_result".
התוצאה של קריאת הפונקציה.
מזהה שצריך להיות זהה למזהה מבלוק קריאת הפונקציה.
CodeExecutionCallContent
תוכן שכולל ביצוע קוד.
arguments CodeExecutionCallArguments (optional)
הארגומנטים להעברה לביצוע הקוד.
שדות
שפת התכנות של ה-`code`.
ערכים אפשריים:
-
python
הקוד שיופעל.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "code_execution_call".
מזהה ייחודי של קריאה ספציפית לכלי.
CodeExecutionResultContent
תוכן של תוצאת הרצת הקוד.
הפלט של הרצת הקוד.
האם הרצת הקוד הסתיימה בשגיאה.
גיבוב חתימה לאימות בקצה העורפי.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "code_execution_result".
מזהה שצריך להיות זהה למזהה מבלוק הקוד של הקריאה להרצת הקוד.
UrlContextCallContent
תוכן ההקשר של כתובת ה-URL.
arguments UrlContextCallArguments (optional)
הארגומנטים להעברה להקשר של כתובת ה-URL.
שדות
כתובות ה-URL לאחזור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "url_context_call".
מזהה ייחודי של קריאה ספציפית לכלי.
UrlContextResultContent
תוכן התוצאה של ההקשר של כתובת ה-URL.
החתימה של תוצאת ההקשר של כתובת ה-URL.
result UrlContextResult (אופציונלי)
התוצאות של ההקשר של כתובת ה-URL.
שדות
כתובת ה-URL שאוחזרה.
הסטטוס של אחזור כתובת ה-URL.
ערכים אפשריים:
-
success -
error -
paywall -
unsafe
האם ההקשר של כתובת ה-URL הוביל לשגיאה.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "url_context_result".
מזהה שצריך להיות זהה למזהה מבלוק השיחות של הקשר של כתובת ה-URL.
GoogleSearchCallContent
תוכן בחיפוש Google.
arguments GoogleSearchCallArguments (optional)
הארגומנטים להעברה לחיפוש Google.
שדות
שאילתות לחיפוש באינטרנט לצורך המשך החיפוש באינטרנט.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "google_search_call".
מזהה ייחודי של קריאה ספציפית לכלי.
GoogleSearchResultContent
תוכן של תוצאות חיפוש ב-Google.
החתימה של תוצאת החיפוש ב-Google.
result GoogleSearchResult (אופציונלי)
תוצאות מחיפוש Google.
שדות
הפניה ל-URI של תוצאת החיפוש.
הכותרת של תוצאת החיפוש.
קטע קוד של תוכן אינטרנט שאפשר להטמיע בדף אינטרנט או בתצוגת אינטרנט של אפליקציה.
האם חיפוש Google הסתיים בשגיאה.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "google_search_result".
מזהה שתואם למזהה מחסימת שיחות בחיפוש Google.
McpServerToolCallContent
תוכן הקריאה לכלי MCPServer.
השם של הכלי שהופעל.
השם של שרת ה-MCP שבו נעשה שימוש.
אובייקט ה-JSON של הארגומנטים של הפונקציה.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "mcp_server_tool_call".
מזהה ייחודי של קריאה ספציפית לכלי.
McpServerToolResultContent
תוכן התוצאה של הכלי MCPServer.
השם של הכלי שהופעל בקריאה הספציפית הזו לכלי.
השם של שרת ה-MCP שבו נעשה שימוש.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "mcp_server_tool_result".
התוצאה של קריאת הפונקציה.
המזהה צריך להיות זהה למזהה מבלוק הקריאה לכלי של שרת ה-MCP.
FileSearchResultContent
תוכן של תוצאת חיפוש קבצים.
result FileSearchResult (אופציונלי)
התוצאות של חיפוש הקבצים.
שדות
הכותרת של תוצאת החיפוש.
הטקסט של תוצאת החיפוש.
השם של מאגר החיפוש של הקבצים.
משמש כמפלה סוגים של 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
תפקיד
כלי שהמודל יכול להשתמש בו.
שם הפונקציה.
תיאור של הפונקציה.
סכימת ה-JSON של הפרמטרים של הפונקציה.
לא סופק תיאור.
הערך תמיד יהיה "function".
GoogleSearch
כלי שהמודל יכול להשתמש בו כדי לחפש ב-Google.
לא סופק תיאור.
הערך תמיד יהיה "google_search".
CodeExecution
כלי שהמודל יכול להשתמש בו כדי להריץ קוד.
לא סופק תיאור.
הערך תמיד יהיה "code_execution".
UrlContext
כלי שהמודל יכול להשתמש בו כדי לאחזר הקשר של כתובת URL.
לא סופק תיאור.
הערך תמיד יהיה "url_context".
ComputerUse
כלי שהמודל יכול להשתמש בו כדי לקיים אינטראקציה עם המחשב.
לא סופק תיאור.
הערך תמיד יהיה "computer_use".
הסביבה שבה מתבצעת הפעולה.
ערכים אפשריים:
-
browser
רשימת הפונקציות המוגדרות מראש שמוחרגות מהקריאה למודל.
McpServer
שרת MCPServer הוא שרת שהמודל יכול להפעיל כדי לבצע פעולות.
לא סופק תיאור.
הערך תמיד יהיה "mcp_server".
השם של MCPServer.
כתובת ה-URL המלאה של נקודת הקצה של שרת ה-MCP. דוגמה: "https://api.example.com/mcp"
אופציונלי: שדות לכותרות אימות, פסק זמן וכו', אם צריך.
allowed_tools AllowedTools (אופציונלי)
הכלים המותרים.
שדות
mode ToolChoiceType (optional)
המצב של בחירת הכלי.
ערכים אפשריים:
-
auto -
any -
none -
validated
שמות הכלים המותרים.
FileSearch
כלי שהמודל יכול להשתמש בו כדי לחפש קבצים.
הקובץ מכיל את שמות החנויות שרוצים לחפש.
מספר החלקים של אחזור סמנטי שיש לאחזר.
מסנן מטא-נתונים להחלה על המסמכים ועל חלקי הטקסט שחולצו באמצעות אחזור סמנטי.
לא סופק תיאור.
הערך תמיד יהיה "file_search".
דוגמאות
פונקציה
GoogleSearch
CodeExecution
UrlContext
ComputerUse
McpServer
FileSearch
Turn
שדות
הגורם שיזם את התור הזה. צריך להיות משתמש לקלט או מודל לפלט של המודל.
התוכן של התור.
דוגמאות
תור המשתמש
{ "role": "user", "content": [ { "type": "text", "text": "user turn" } ] }
התור של המודל
{ "role": "model", "content": [ { "type": "text", "text": "model turn" } ] }
InteractionSseEvent
סוגים אפשריים
ערך הדיסקרימינטור הפולימורפי: event_type
InteractionEvent
לא סופק תיאור.
ערכים אפשריים:
-
interaction.start -
interaction.complete
לא סופק תיאור.
טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.
InteractionStatusUpdate
לא סופק תיאור.
לא סופק תיאור.
ערכים אפשריים:
-
in_progress -
requires_action -
completed -
failed -
cancelled
לא סופק תיאור.
הערך תמיד יהיה "interaction.status_update".
טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.
ContentStart
לא סופק תיאור.
לא סופק תיאור.
לא סופק תיאור.
הערך תמיד יהיה "content.start".
טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.
ContentDelta
לא סופק תיאור.
לא סופק תיאור.
הערך תמיד יהיה "content.delta".
טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.
delta object (אופציונלי)
לא סופק תיאור.
סוגים אפשריים
ערך הדיסקרימינטור הפולימורפי: type
TextDelta
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "text".
annotations Annotation (אופציונלי)
מידע על ציטוט של תוכן שנוצר על ידי מודל.
שדות
תחילת הקטע בתשובה שמשויך למקור הזה. האינדקס מציין את תחילת הפלח, בבייטים.
סוף הקטע המשויך, לא כולל.
המקור שמיוחס לחלק מהטקסט. יכול להיות כתובת URL, שם או מזהה אחר.
ImageDelta
לא סופק תיאור.
לא סופק תיאור.
mime_type ImageMimeTypeOption (אופציונלי)
לא סופק תיאור.
ערכים אפשריים:
-
image/png -
image/jpeg -
image/webp -
image/heic -
image/heif
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "image".
resolution MediaResolution (אופציונלי)
הרזולוציה של המדיה.
ערכים אפשריים:
-
low -
medium -
high
AudioDelta
לא סופק תיאור.
לא סופק תיאור.
mime_type AudioMimeTypeOption (optional)
לא סופק תיאור.
ערכים אפשריים:
-
audio/wav -
audio/mp3 -
audio/aiff -
audio/aac -
audio/ogg -
audio/flac
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "audio".
DocumentDelta
לא סופק תיאור.
לא סופק תיאור.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "document".
VideoDelta
לא סופק תיאור.
לא סופק תיאור.
mime_type VideoMimeTypeOption (optional)
לא סופק תיאור.
ערכים אפשריים:
-
video/mp4 -
video/mpeg -
video/mov -
video/avi -
video/x-flv -
video/mpg -
video/webm -
video/wmv -
video/3gpp
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "video".
resolution MediaResolution (אופציונלי)
הרזולוציה של המדיה.
ערכים אפשריים:
-
low -
medium -
high
ThoughtSummaryDelta
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "thought_summary".
לא סופק תיאור.
ThoughtSignatureDelta
חתימה שתתאים למקור הנתונים בעורף האתר, כדי שתהיה חלק מהיצירה.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "thought_signature".
FunctionCallDelta
לא סופק תיאור.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "function_call".
מזהה ייחודי של קריאה ספציפית לכלי.
FunctionResultDelta
לא סופק תיאור.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "function_result".
דלתא של תוצאת קריאה לכלי.
מזהה שצריך להיות זהה למזהה מבלוק קריאת הפונקציה.
CodeExecutionCallDelta
arguments CodeExecutionCallArguments (optional)
לא סופק תיאור.
שדות
שפת התכנות של ה-`code`.
ערכים אפשריים:
-
python
הקוד שיופעל.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "code_execution_call".
מזהה ייחודי של קריאה ספציפית לכלי.
CodeExecutionResultDelta
לא סופק תיאור.
לא סופק תיאור.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "code_execution_result".
מזהה שצריך להיות זהה למזהה מבלוק קריאת הפונקציה.
UrlContextCallDelta
arguments UrlContextCallArguments (optional)
לא סופק תיאור.
שדות
כתובות ה-URL לאחזור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "url_context_call".
מזהה ייחודי של קריאה ספציפית לכלי.
UrlContextResultDelta
לא סופק תיאור.
result UrlContextResult (אופציונלי)
לא סופק תיאור.
שדות
כתובת ה-URL שאוחזרה.
הסטטוס של אחזור כתובת ה-URL.
ערכים אפשריים:
-
success -
error -
paywall -
unsafe
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "url_context_result".
מזהה שצריך להיות זהה למזהה מבלוק קריאת הפונקציה.
GoogleSearchCallDelta
arguments GoogleSearchCallArguments (optional)
לא סופק תיאור.
שדות
שאילתות לחיפוש באינטרנט לצורך המשך החיפוש באינטרנט.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "google_search_call".
מזהה ייחודי של קריאה ספציפית לכלי.
GoogleSearchResultDelta
לא סופק תיאור.
result GoogleSearchResult (אופציונלי)
לא סופק תיאור.
שדות
הפניה ל-URI של תוצאת החיפוש.
הכותרת של תוצאת החיפוש.
קטע קוד של תוכן אינטרנט שאפשר להטמיע בדף אינטרנט או בתצוגת אינטרנט של אפליקציה.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "google_search_result".
מזהה שצריך להיות זהה למזהה מבלוק קריאת הפונקציה.
McpServerToolCallDelta
לא סופק תיאור.
לא סופק תיאור.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "mcp_server_tool_call".
מזהה ייחודי של קריאה ספציפית לכלי.
McpServerToolResultDelta
לא סופק תיאור.
לא סופק תיאור.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "mcp_server_tool_result".
דלתא של תוצאת קריאה לכלי.
מזהה שצריך להיות זהה למזהה מבלוק קריאת הפונקציה.
FileSearchResultDelta
result FileSearchResult (אופציונלי)
לא סופק תיאור.
שדות
הכותרת של תוצאת החיפוש.
הטקסט של תוצאת החיפוש.
השם של מאגר החיפוש של הקבצים.
משמש כמפלה סוגים של OpenAPI עבור תוכן oneof.
הערך תמיד יהיה "file_search_result".
ContentStop
לא סופק תיאור.
לא סופק תיאור.
הערך תמיד יהיה "content.stop".
טוקן event_id שישמש להמשך זרם האינטראקציות, מהאירוע הזה.
ErrorEvent
לא סופק תיאור.
הערך תמיד יהיה "error".
error Error (אופציונלי)
לא סופק תיאור.
שדות
URI שמזהה את סוג השגיאה.
הודעת שגיאה שאנשים יכולים לקרוא.
טוקן 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" } }