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

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

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

*ملاحظة: لا تتوفّر مساحة تخزين لسجلات Gemini API إلا للمشاريع التي تستخدم درجة التسعير المدفوعة من Gemini API.

ضبط تسجيل بيانات المشروع

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

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

تسجيل البيانات على مستوى الطلب

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

• واجهة برمجة التطبيقات 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، عليك أولاً تفعيلها في لوحة الإعدادات.

انقر على إدخال لمعاينة الحمولة. يمكنك الاطّلاع على الطلب والردّ الكاملَين من Gemini، بالإضافة إلى سياق المحادثات السابقة. بالنسبة إلى طلبات واجهة برمجة التطبيقات للتفاعلات، تتضمّن السجلات أيضًا رابطًا مباشرًا إلى 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.