در این راهنما یاد خواهید گرفت که چگونه گزارشهای مربوط به استفاده از API Gemini را در داشبورد Google AI Studio مشاهده کنید تا رفتار مدل و نحوه تعامل کاربران با برنامههای خود را بهتر درک کنید. از گزارشگیری برای مشاهده، اشکالزدایی و در صورت تمایل به اشتراکگذاری بازخورد استفاده با Google استفاده کنید تا به بهبود Gemini در موارد استفاده توسعهدهندگان کمک کنید . *
تمام فراخوانیهای API مربوط GenerateContent ، BatchGenerateContent ، StreamGenerateContent و فراخوانیهای API مربوط به Interactions به جز Managed Agents پشتیبانی میشوند. این شامل فراخوانیهای انجام شده از طریق نقاط پایانی سازگاری OpenAI نیز میشود.
*توجه: فضای ذخیرهسازی برای گزارشهای API Gemini فقط برای پروژههای موجود در سطح پولی Gemini API در دسترس است.
پیکربندی ثبت وقایع پروژه
به طور پیشفرض، API تمام اشیاء تعاملی ( store=true ) را ذخیره میکند تا استفاده از ویژگیهای مدیریت وضعیت سمت سرور را ساده کند. در مقابل، API تولید محتوا (Generate Content API) به طور پیشفرض درخواستها را ذخیره نمیکند و نیاز دارد که ذخیرهسازی برای هر درخواست یا در سطح پروژه از AI Studio فعال شود.
در Google AI Studio میتوانید ثبت وقایع را برای همه پروژهها یا برای پروژههای خاص فعال یا غیرفعال کنید و این تنظیمات را در هر زمان از طریق پنل تنظیمات در صفحه Logs and Datasets تغییر دهید. ثبت وقایع را میتوان به طور مستقل برای generateContent API و Interactions API فعال یا غیرفعال کرد تا رفتار ذخیرهسازی پیشفرض برای یک پروژه تغییر کند.
ثبت وقایع در سطح درخواست
رفتار ذخیرهسازی و ثبت وقایع بسته به API متفاوت است:
- API تعاملات : درخواستها را به صورت پیشفرض (
store=true) ذخیره میکند تا مدیریت وضعیت سمت سرور را سادهتر کند. - API تولید محتوا (
generateContent): به طور پیشفرض درخواستها را ذخیره نمیکند (store=false).
در اینجا نحوه تنظیم ویژگی store آورده شده است:
API generateContent
پایتون
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);
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
- به صفحه گزارشها در AI Studio بروید.
- یک پروژه را از منوی کشویی انتخاب کنید.
- در صورت وجود، گزارشها برای Interactions API به ترتیب زمانی معکوس در جدول نمایش داده میشوند.
- برای مشاهده گزارشهای پروژه برای Generate Content API، ابتدا این گزینه را در پنل تنظیمات فعال کنید.
برای پیشنمایش payload، روی یک ورودی کلیک کنید. میتوانید کل prompt و پاسخ Gemini و متن مربوط به نوبتهای قبلی را بررسی کنید. برای درخواستهای Interactions API ، گزارشها همچنین شامل یک لینک مستقیم به previous_interaction_id هستند.
پیکربندی نگهداری فضای ذخیرهسازی پروژه
گزارشها پس از یک دوره نگهداری پیشفرض ۵۵ روزه منقضی شده و برای حذف علامتگذاری میشوند (مگر اینکه در یک مجموعه داده ذخیره شده باشند که منقضی نمیشوند). میتوانید دوره نگهداری گزارشهای یک پروژه را حداکثر روی ۷، ۱۴، ۲۸ یا ۵۵ روز پیکربندی کنید.
ایجاد و اشتراکگذاری مجموعه دادهها
شما میتوانید لاگها را در مجموعه دادهها ذخیره کنید تا آنها را به طور مؤثرتری سازماندهی و صادر کنید.
- از صفحه Logs ، نوار فیلتر را در بالا پیدا کنید تا یک ویژگی را برای فیلتر کردن انتخاب کنید.
- از نمای فیلتر شده خود، از کادرهای انتخاب برای انتخاب همه یا گزارشهای جداگانه استفاده کنید.
- روی دکمهی «ایجاد مجموعه داده» که در بالای لیست ظاهر میشود، کلیک کنید.
- به مجموعه داده جدید خود یک نام و توضیحات اختیاری بدهید.
- مجموعه دادهای که ایجاد کردهاید را به همراه مجموعه لاگهای انتخابشده مشاهده خواهید کرد.
- مجموعه دادههای خود را برای تجزیه و تحلیل بیشتر به صورت فایلهای CSV، JSONL یا به Google Sheets صادر کنید.
مجموعه دادهها میتوانند برای تعدادی از موارد استفاده مختلف مفید باشند.
- مجموعه چالشها را انتخاب کنید: پیشرفتهای آینده را در حوزههایی که میخواهید هوش مصنوعی شما در آنها بهبود یابد، هدایت کنید.
- گردآوری مجموعههای نمونه: به عنوان مثال، نمونهای از کاربرد واقعی برای تولید پاسخهایی از مدل دیگر، یا مجموعهای از موارد خاص برای بررسیهای معمول قبل از استقرار.
- مجموعههای ارزیابی: مجموعههایی که نمایانگر میزان استفاده واقعی در قابلیتهای مهم هستند، برای مقایسه با سایر مدلها یا تکرارهای دستورالعمل سیستم.
شما میتوانید با انتخاب اشتراکگذاری مجموعه دادههای خود با گوگل به عنوان نمونههای نمایشی، در تحقیق و توسعه Gemini مشارکت کنید.
محدودیتها
ثبت وقایع در حال حاضر برای موارد زیر پشتیبانی نمیشود:
- مدلهای ایمیجن و وئو
- مدلهای جاسازی جمینی
- مدل رباتیک جمینی
- ورودیهای حاوی ویدیو، GIF یا PDF
- نمایندگان پیشنمایش عمومی در API جمینی
قدم بعدی چیست؟
- نمونه اولیه با سابقه جلسه: از AI Studio Build برای کدنویسی پویای برنامهها استفاده کنید و کلید API خود را برای فعال کردن سابقه گزارشهای API Gemini برای ویژگیهای هوش مصنوعی اضافه کنید.
- اجرای مجدد لاگها با Gemini Batch API: با اجرای مجدد لاگها با Gemini Batch API ، از مجموعه دادهها برای نمونهبرداری پاسخ و ارزیابی مدلها یا منطق برنامه استفاده کنید.