סקירה כללית על Interactions API

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

למה כדאי להשתמש ב-Interactions API?

ל-Interactions API יש כמה יתרונות מרכזיים בפיתוח אפליקציות מבוססות-AI גנרטיבי ותהליכי עבודה מבוססי-סוכנים:

  • ממשק API יחיד למודלים ולסוכנים: נקודת קצה ודפוס מאוחדים לקריאה ישירה למודלים רגילים של Gemini ולסוכנים מיוחדים (כמו Gemini Deep Research Agent וסוכנים מנוהלים בהתאמה אישית).
  • יכולות חדשות שזמינות לשימוש מיידי: תכונות כמו מצב שיחה אופציונלי בצד השרת באמצעות previous_interaction_id, שלבי ביצוע שניתנים לצפייה לצורך ניפוי באגים ועיבוד ממשק משתמש, וביצוע ברקע של משימות ארוכות טווח באמצעות background=true.
  • איפה יושקו תכונות חדשות: מעכשיו, כל המודלים החדשים, היכולות המולטי-מודאליות, הכלים והתכונות מבוססות-הסוכן ייתמכו ב-Interactions API.

איך Interactions API פועל

ה-API של Interactions מתמקד במשאב Interaction. ‫Interaction מייצג תור שלם בשיחה או במשימה ומשמש כרשומה של סשן שמכילה רצף כרונולוגי של ביצוע steps:

  • ‫user_input: ההודעות שהוזנו, קבצים מולטימודאליים או תוצאות של כלים שסופקו לתור. אינטראקציות שנשמרו ואוחזרו באמצעות interactions.get כוללות user_input שלבים להקשר מלא, בעוד שתשובות של interactions.create כוללות רק את השלבים שנוצרו במהלך התור הזה.
  • ‫thought: סיכומים של חשיבה רציונלית ביניים שנוצרו על ידי המודל או הסוכן בזמן תכנון התשובה.
  • שלבים של הפעלת כלי ותוצאה: הפעלות של כלי בצד הלקוח או בצד השרת ותפוקות (כמו function_call ו-function_result).
  • ‫model_output: הטקסט הסופי, ה-JSON המובנה או התוכן המולטימודאלי שנוצרו על ידי המודל או הסוכן.

כשמבצעים קריאה ל-interactions.create, Agent Platform מעבדת את הקלט, מפעילה כלים או לולאות סוכנים שהוגדרו בצד השרת ומחזירה את משאב Interaction שנוצר.

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

מודלי Gemini הבאים תומכים ב-Interactions API:

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

בנוסף למודלים שמפורטים למעלה, Interactions API תומך במודלים המיוחדים הבאים ליצירת אודיו וליצירת תוכן מולטימודאלי:

  • ‫gemini-omni-flash-preview: מודל רב-אופני עם ביצועים גבוהים ליצירה, לעריכה ולשליטה קולנועית של סרטונים בשיחה.
  • ‫lyria-3-clip-preview ו-lyria-3-pro-preview: מודלים של מוזיקה גנרטיבית לקטעי אודיו ברמת דיוק גבוהה וליצירת יצירות מוזיקליות מלאות (נתמכים רק באינטראקציות בלי שמירת מצב עם store=false).

סוכנים נתמכים

אפשר להפעיל את הסוכנים הבאים באמצעות Interactions API על ידי ציון הפרמטר agent במקום model:

  • ‫antigravity-preview-05-2026: סוכן אוטונומי לשימוש כללי שנועד לביצוע חשיבה רב-שלבית, כתיבת קוד, פעולות בקבצים ושימוש בכלים.
  • ‫deep-research-preview-04-2026: Gemini Deep Research Agent נועד לבצע מחקר אינטרנטי מורכב בכמה שלבים באופן אוטונומי.
  • סוכנים מנוהלים בהתאמה אישית שנפרסו ב-Agent Platform.

תכונות ומפרטים

בקטעים הבאים מתוארות היכולות העיקריות, המפרטים הטכניים והשיקולים התפעוליים של Interactions API.

ניהול מצב

כברירת מחדל, ה-Interactions API שומר בקשות כדי שתוכלו להשתמש בתכונות של ניהול מצב בצד השרת באמצעות previous_interaction_id. כדי להפעיל התנהגות בלי שמירת מצב, צריך להגדיר את store=false.

כלים נתמכים והארקה

הכלים המובנים, ספקי ה-grounding והיכולות הבאות של חיפוש נתמכים במודלים של Gemini 3 ב-Interactions API:

  • ‫עיגון באמצעות חיפוש Google ו-Web Grounding for Enterprise: מעגן את התשובות של המודל למידע בזמן אמת מהאינטרנט מחיפוש Google או מ-Web Grounding for Enterprise.
  • חיפוש מבוסס סוכנים ו-RAG Engine ב-Gemini Enterprise Agent Platform: עיגון של תשובות המודל למאגרי נתונים פרטיים של הארגון ולמאגרי מסמכים באמצעות חיפוש מבוסס סוכנים ו-RAG Engine.
  • ‫xAI Search: מחבר מודלים לחיפוש בזמן אמת ברשתות חברתיות ול-grounding של ידע.
  • ‫Parallel Search: הפרמטר הזה מעגן את התשובות של המודל לנתונים ציבוריים בזמן אמת מהאינטרנט, שמתקבלים מ-Parallel Web Systems' search API.
  • הרצת קוד: מאפשרת למודל ליצור ולהריץ קוד Python בסביבה מאובטחת שפועלת בארגז חול.
  • הפעלת פונקציות: מאפשרת למודלים להתחבר לכלים חיצוניים, לממשקי API ולמסדי נתונים על ידי החזרת ארגומנטים מובנים של פונקציות.

‫Interactions API תומך ב-Web Grounding ל-Enterprise וב-עיגון באמצעות חיפוש Google. השימוש שלכם בתכונות האלה כפוף גם לתנאים הספציפיים לשירות.

חיוב

השימוש ב-Interactions API מחויב על סמך צריכת הטוקנים.

החיוב על בקשות שהופסקו או שלא מולאו מתבצע באופן הבא:

  • ביטולים ידניים: אם אינטראקציה מבוטלת לפני שהיא מסתיימת (לדוגמה, על ידי שליחת בקשת ביטול), תשלמו על הטוקנים שנצרכו עד לנקודת הביטול.
  • בקשות שנכשלו: אם בקשה לאינטראקציה נכשלת בגלל שגיאת מערכת פנימית או כשל בקצה העורפי, לא תחויבו על הבקשה שנכשלה.

אבטחה ותאימות

במהלך תקופת התצוגה המקדימה, יש לקחת בחשבון את השיקולים הבאים לגבי אבטחה, תאימות ומיקום אחסון הנתונים של Interactions API:

  • אישורים בנושא אבטחה ותאימות: גרסת הטרום-השקה של Interactions API לא תומכת ב-FedRAMP או במפתחות הצפנה בניהול הלקוח (CMEK), והיא לא עומדת בדרישות של רמת ההשפעה 5 (IL5) של משרד ההגנה (DoD) או בדרישות של International Traffic in Arms Regulations (ITAR).
  • ‫VPC Service Controls: גרסת הטרום-השקה של Interactions API תומכת ב-VPC Service Controls (VPC-SC) כדי לאבטח את גבולות הגזרה של ה-API.
  • מיקום אחסון הנתונים: גרסת הטרום-השקה של Interactions API לא תומכת במיקום אחסון הנתונים ולא מתחייבת לשום דבר לגבי אחסון סשנים.
  • נקודות קצה: גרסת הטרום-השקה של Interactions API תומכת רק בנקודות קצה גלובליות (locations/global).

ערכות SDK נתמכות

אפשר לגשת ל-Interactions API באמצעות ה-SDK המאוחד של Google Gen AI או באמצעות קריאות ישירות ל-REST:

  • ‫Python: גרסה google-genai2.3.0 ואילך
  • ‫TypeScript / JavaScript: גרסה @google/genai או גרסה מתקדמת יותר של 2.3.0
  • Go: google.golang.org/genai
  • ‫Java: com.google.genai:google-genai

‫SDKs מדור קודם (google-cloud-aiplatform,‏ @google-cloud/vertexai ו-google-generativeai) לא תומכים ב-Interactions API.

המאמרים הבאים