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

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

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

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

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

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

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

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

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

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

GenerateContent API

Python

from google import genai

client = genai.Client()

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

print(response.text)

JavaScript

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

const client = new GoogleGenAI({});

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

console.log(response.text);

جافا

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;

Client client = new Client();

// The GenerateContent API does not store requests by default
GenerateContentResponse response =
    client.models.generateContent(
        "gemini-3.8-flash",
        "Explain quantum entanglement in simple terms.",
        GenerateContentConfig.builder().build());

System.out.println(response.text());

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    // The GenerateContent API does not store requests by default
    response, err := client.Models.GenerateContent(
        ctx,
        "gemini-3.8-flash",
        genai.Text("Explain quantum entanglement in simple terms."),
        &genai.GenerateContentConfig{},
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(response.Text())
}

Interactions API

Python

from google import genai

client = genai.Client()

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

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

JavaScript

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: 'gemini-3.8-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);

جافا

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = new Client();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain quantum entanglement in simple terms."))
        .store(true) // Set to false to disable logging of this request
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Explain quantum entanglement in simple terms."),
            Store: genai.Ptr(true), // Set to false to disable logging of this request
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

عرض سجلّات المشاريع في 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.