السجلّات ومجموعات البيانات

في هذا الدليل، ستتعرّفون على كيفية عرض السجلات من استخدام Gemini API في لوحة بيانات Google AI Studio لفهم سلوك النموذج بشكل أفضل وكيفية تفاعل المستخدمين مع تطبيقاتكم. يمكنكم استخدام ميزة تسجيل الأحداث لمراقبة استخدام Gemini وتصحيح الأخطاء فيه، ويمكنكم اختياريًا مشاركة ملاحظاتكم مع Google للمساعدة في تحسين Gemini في حالات استخدام المطوّرين.^*

تتوفّر إمكانية تسجيل الأحداث لجميع طلبات البيانات من واجهة برمجة التطبيقات GenerateContent وBatchGenerateContent وStreamGenerateContent وInteractions API، باستثناء الوكلاء المُدارين. ويشمل ذلك الطلبات التي يتم إجراؤها من خلال نقاط نهاية التوافق مع OpenAI.

ضبط تسجيل الأحداث في المشروع

تخزّن واجهة برمجة التطبيقات تلقائيًا جميع عناصر التفاعل (store=true) لتسهيل استخدام ميزات إدارة حالة الخادم. في المقابل، لا تخزّن واجهة برمجة التطبيقات Generate Content API الطلبات تلقائيًا، وتتطلب تفعيل مساحة التخزين لكل طلب أو على مستوى المشروع من AI Studio.

في Google AI Studio، يمكنكم تفعيل ميزة تسجيل الأحداث أو إيقافها لجميع المشاريع أو لمشاريع معيّنة، وتغيير هذه الإعدادات المفضّلة في أي وقت من خلال لوحة الإعدادات في صفحة "السجلات ومجموعات البيانات". يمكن تفعيل ميزة تسجيل الأحداث أو إيقافها بشكل مستقل لواجهة برمجة التطبيقات generateContent وواجهة برمجة التطبيقات Interactions لتغيير سلوك التخزين التلقائي لمشروع معيّن.

تسجيل الأحداث على مستوى الطلب

يختلف سلوك التخزين وتسجيل الأحداث حسب واجهة برمجة التطبيقات:

• واجهة برمجة التطبيقات Interactions API: تخزّن الطلبات تلقائيًا (store=true) لتسهيل إدارة حالة الخادم.
• واجهة برمجة التطبيقات Generate Content API (generateContent): لا تخزّن الطلبات تلقائيًا (store=false).

إليكم كيفية ضبط السمة store:

واجهة برمجة التطبيقات generateContent

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model='gemini-3.6-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.6-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.6-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.6-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، فعِّلوا هذه الميزة أولاً في لوحة الإعدادات.

انقروا على إدخال لمعاينة الحمولة. يمكنكم الاطّلاع على الطلب والردّ الكاملَين من Gemini، والسياق من الردود السابقة. بالنسبة إلى طلبات واجهة برمجة التطبيقات Interactions API، تتضمّن السجلات أيضًا رابطًا مباشرًا إلى previous_interaction_id.

ضبط مدة الاحتفاظ بمساحة تخزين المشروع

ستنتهي صلاحية السجلات وسيتم وضع علامة عليها للحذف بعد فترة الاحتفاظ التلقائية البالغة 55 يومًا (ما لم يتم حفظها في مجموعة بيانات لا تنتهي صلاحيتها). يمكنكم ضبط فترة الاحتفاظ بسجلات المشروع على 7 أو 14 أو 28 أو 55 يومًا كحد أقصى.

إنشاء مجموعات البيانات ومشاركتها

يمكنكم حفظ السجلات في مجموعات البيانات لتنظيمها وتصديرها بشكل أكثر فعالية.

• من صفحة "السجلات"، ابحثوا عن شريط الفلترة في أعلى الصفحة لاختيار سمة للفلترة حسبها.
• من العرض الذي تم فلترته، استخدِموا مربّعات الاختيار لاختيار جميع السجلات أو سجلات فردية.
• انقروا على الزر إنشاء مجموعة بيانات الذي يظهر في أعلى القائمة.
• امنحوا مجموعة البيانات الجديدة اسمًا ووصفًا اختياريًا.
• ستظهر مجموعة البيانات التي أنشأتموها للتو مع مجموعة السجلات المنسّقة.
• يمكنكم تصدير مجموعة البيانات لإجراء تحليل إضافي بتنسيق ملفات CSV أو JSONL أو إلى "جداول بيانات Google".

يمكن أن تكون مجموعات البيانات مفيدة لعدد من حالات الاستخدام المختلفة.

• تنسيق مجموعات التحديات: يمكنكم إجراء تحسينات مستقبلية تستهدف المجالات التي تريدون تحسين الذكاء الاصطناعي فيها.
• تنسيق مجموعات النماذج: على سبيل المثال، يمكنكم استخدام نموذج من الاستخدام الفعلي لإنشاء ردود من نموذج آخر، أو مجموعة من الحالات القصوى لإجراء عمليات التحقّق الروتينية قبل النشر.
• مجموعات التقييم: هي مجموعات تمثّل الاستخدام الفعلي لإمكانات مهمة، وذلك للمقارنة بين النماذج الأخرى أو تكرارات تعليمات النظام.

يمكنكم المساهمة في أبحاث Gemini وتطويره من خلال اختيار مشاركة مجموعات البيانات مع Google كأمثلة توضيحية.

القيود

لا تتوفّر حاليًا ميزة تسجيل الأحداث لما يلي:

• نماذج Imagen وVeo
• نماذج تضمين Gemini
• نموذج Gemini Robotics
• الإدخالات التي تحتوي على فيديوهات أو ملفات GIF أو ملفات PDF
• الوكلاء في المعاينة العلنية في Gemini API

الخطوات التالية

• إنشاء نموذج أولي باستخدام سجلّ الجلسة: يمكنكم استخدام ميزة "إنشاء" في AI Studio لإنشاء تطبيقات مستنِدة إلى الرموز البرمجية وإضافة مفتاح واجهة برمجة التطبيقات لتفعيل سجلّ سجلات Gemini API لميزات الذكاء الاصطناعي.
• إعادة تشغيل السجلات باستخدام Gemini Batch API: يمكنكم استخدام مجموعات البيانات لأخذ عيّنات من الردود وتقييم النماذج أو منطق التطبيق من خلال إعادة تشغيل السجلات باستخدام Gemini Batch API.