יומנים ומערכי נתונים

במדריך הזה נסביר איך לצפות ביומנים של השימוש ב-Gemini API בלוח הבקרה של Google AI Studio, כדי להבין טוב יותר את התנהגות המודל ואת האינטראקציות של המשתמשים עם האפליקציות שלכם. אפשר להשתמש ברישום ביומן כדי לצפות, לנפות באגים ולשתף משוב על השימוש עם Google כדי לעזור לשפר את Gemini בתרחישי שימוש שונים של מפתחים.^*

כל הקריאות ל-API‏ GenerateContent,‏ BatchGenerateContent ו-StreamGenerateContent, וקריאות ל-API של Interactions, נתמכות, למעט קריאות ל-API של סוכנים מנוהלים. הן כוללות שיחות שמתבצעות דרך נקודות קצה של תאימות ל-OpenAI.

*הערה: אחסון של יומני Gemini API זמין רק בפרויקטים בתוכנית בתשלום של Gemini API.

הגדרת רישום ביומן של פרויקט

כברירת מחדל, ה-API שומר את כל אובייקטי האינטראקציה (store=true) כדי לפשט את השימוש בתכונות של ניהול מצב בצד השרת. לעומת זאת, ב-Generate Content API, הבקשות לא נשמרות כברירת מחדל, וצריך להפעיל את השמירה לכל בקשה או ברמת הפרויקט מ-AI Studio.

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

רישום ביומן ברמת הבקשה

ההתנהגות של האחסון והרישום ביומן שונה בהתאם ל-API:

• ‫Interactions API: מאחסן בקשות כברירת מחדל (store=true) כדי לפשט את ניהול המצב בצד השרת.
• יצירת Content API ‏ (generateContent): לא שומר בקשות כברירת מחדל (store=false).

כך מגדירים את המאפיין store:

‫generateContent API

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model='gemini-3.5-flash',
    contents='Explain quantum entanglement in simple terms.',
    config={'store': False} # Set to True to enable logging of this request
)

print(response.text)

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

const client = new GoogleGenAI({});

const response = await client.models.generateContent({
    model: 'gemini-3.5-flash',
    contents: 'Explain quantum entanglement in simple terms.',
    config: {
        store: false // Set to true to enable logging of this request
    }
});

console.log(response.text);

Interactions API

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.5-flash",
    input="Explain quantum entanglement in simple terms.",
    store=True # Set to False to disable logging of this request
)

print(interaction.outputs[-1].text)

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: 'gemini-3.5-flash',
    input: 'Explain quantum entanglement in simple terms.',
    store: true // Set to false to disable logging of this request
});

console.log(interaction.outputs[interaction.outputs.length - 1].text);

צפייה ביומני הפרויקט ב-AI Studio

1. עוברים לדף 'יומנים' ב-AI Studio.
2. בוחרים פרויקט מהתפריט הנפתח.
3. אם יש יומנים של Interactions API, הם יופיעו בטבלה בסדר כרונולוגי הפוך.
4. כדי לראות את יומני הפרויקט של Generate Content API, צריך קודם להפעיל את האפשרות הזו בחלונית ההגדרות.

כדי לראות תצוגה מקדימה של המטען הייעודי (payload), לוחצים על רשומה. אתם יכולים לבדוק את ההנחיה המלאה ואת התשובה מ-Gemini, ואת ההקשר מהתורות הקודמות. בבקשות של Interactions API, היומנים כוללים גם קישור ישיר אל previous_interaction_id.

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

היומנים יאבדו תוקף ויסומנו למחיקה אחרי תקופת שמירה שמוגדרת כברירת מחדל של 55 ימים (אלא אם נשמרו במערך נתונים, שאז הם לא יאבדו תוקף). אפשר להגדיר את חלון השמירה של יומני פרויקט ל-7, 14, 28 או 55 ימים לכל היותר.

יצירה ושיתוף של מערכי נתונים

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

• בדף Logs, מאתרים את סרגל הסינון בחלק העליון ובוחרים מאפיין לסינון.
• בתצוגה המסוננת, מסמנים את התיבות כדי לבחור את כל היומנים או יומנים ספציפיים.
• לוחצים על הלחצן Create dataset (יצירת מערך נתונים) שמופיע בראש הרשימה.
• נותנים שם למערך הנתונים החדש, ואפשר גם להוסיף תיאור.
• מערך הנתונים שיצרתם יופיע עם קבוצת היומנים שנאספו.
• אפשר לייצא את מערך הנתונים לניתוח נוסף כקובצי CSV או JSONL, או ל-Google Sheets.

מערכי נתונים יכולים לעזור לכם במגוון תרחישי שימוש שונים.

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

אתם יכולים לתרום למחקר ולפיתוח של Gemini על ידי שיתוף מערכי הנתונים שלכם עם Google כדוגמאות להדגמה.

מגבלות

כרגע אין תמיכה ברישום ביומן עבור הפעולות הבאות:

• מודלים של Imagen ו-Veo
• מודלים של Gemini להטמעה
• מודל Gemini Robotics
• קלט שמכיל סרטונים, קובצי GIF או קובצי PDF
• סוכנים בתוכנית Public Preview ב-Gemini API

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

• יצירת אב טיפוס עם היסטוריית סשנים: אפשר להשתמש ב-AI Studio Build כדי ליצור אפליקציות בשיטת Vibe code ולהוסיף את מפתח ה-API כדי להפעיל היסטוריה של יומני Gemini API לתכונות מבוססות-AI.
• הרצת יומנים מחדש באמצעות Gemini Batch API: אפשר להשתמש במערכי נתונים לדגימת תגובות ולהערכה של מודלים או של לוגיקת אפליקציה על ידי הרצת יומנים מחדש באמצעות Gemini Batch API.