API-ja e Ndërveprimeve tani është përgjithësisht e disponueshme. Ne rekomandojmë përdorimin e kësaj API-je për qasje në të gjitha veçoritë dhe modelet më të fundit.

Kjo faqe është përkthyer nga Cloud Translation API.

Logjet dhe grupet e të dhënave

Në këtë udhëzues do të mësoni se si të shikoni regjistrat nga përdorimi i Gemini API në panelin e Google AI Studio për të kuptuar më mirë sjelljen e modelit dhe se si përdoruesit mund të bashkëveprojnë me aplikacionet tuaja. Përdorni regjistrimin për të vëzhguar, debuguar dhe opsionalisht për të ndarë reagimet e përdorimit me Google për të ndihmuar në përmirësimin e Gemini në të gjitha rastet e përdorimit të zhvilluesve . ^*

Mbështeten të gjitha thirrjet API të GenerateContent , BatchGenerateContent , StreamGenerateContent dhe thirrjet API të Interactions , duke përjashtuar Agjentët e Menaxhuar. Kjo përfshin thirrjet e bëra përmes pikave fundore të përputhshmërisë OpenAI .

Konfiguro regjistrimin e projektit

Si parazgjedhje, API-ja ruan të gjitha objektet e ndërveprimit ( store=true ) për të thjeshtuar përdorimin e veçorive të menaxhimit të gjendjes në anën e serverit. Në të kundërt, API-ja e Gjenerimit të Përmbajtjes nuk i ruan kërkesat si parazgjedhje dhe kërkon që ruajtja të aktivizohet për çdo kërkesë ose në nivelin e projektit nga AI Studio.

Në Google AI Studio mund të aktivizoni ose çaktivizoni regjistrimin për të gjitha projektet ose për projekte specifike dhe t'i ndryshoni këto preferenca në çdo kohë përmes panelit të Cilësimeve në faqen Logs and Datasets . Regjistrimi mund të aktivizohet ose çaktivizohet në mënyrë të pavarur për generateContent API dhe Interactions API për të ndryshuar sjelljen e parazgjedhur të ruajtjes për një projekt.

Regjistrimi në nivel kërkese

Sjellja e ruajtjes dhe regjistrimit ndryshon në varësi të API-t:

API-ja e Ndërveprimeve : Ruan kërkesat si parazgjedhje ( store=true ) për të thjeshtuar menaxhimin e gjendjes në anën e serverit.
Generate Content API ( generateContent ): Nuk i ruan kërkesat si parazgjedhje ( store=false ).

Ja se si mund ta caktoni vetinë e store :

API-ja e Gjenerimit të Përmbajtjes

Python

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)

JavaScript

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);

API-ja e Ndërveprimeve

Python

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)

JavaScript

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);

Shikoni regjistrat e projektit në AI Studio

Shko te faqja e Regjistrimeve në AI Studio .
Zgjidhni një projekt nga menyja zbritëse.
Regjistrat do të shfaqen në tabelë në rend kronologjik të kundërt për API-në e Ndërveprimeve, nëse ekzistojnë.
Për të vëzhguar regjistrat e projektit për API-në e Gjenerimit të Përmbajtjes, së pari aktivizojeni këtë në panelin e cilësimeve .

Klikoni një hyrje për një pamje paraprake të ngarkesës. Mund të inspektoni kërkesën dhe përgjigjen e plotë nga Gemini, si dhe kontekstin nga kthesat e mëparshme. Për kërkesat e Interactions API , regjistrat përfshijnë gjithashtu një lidhje të drejtpërdrejtë me previous_interaction_id .

Konfiguro ruajtjen e ruajtjes së projektit

Regjistrat do të skadojnë dhe do të shënohen për fshirje pas një dritareje të parazgjedhur ruajtjeje prej 55 ditësh (përveç nëse ruhen në një grup të dhënash , të cilat nuk skadojnë). Mund ta konfiguroni dritaren e ruajtjes së regjistrave të një projekti në maksimum 7, 14, 28 ose 55 ditë.

Krijo dhe ndaj grupe të dhënash

Mund të ruani regjistrat në grupe të dhënash për t'i organizuar dhe eksportuar ato në mënyrë më efektive.

Nga faqja Logs , gjeni shiritin e filtrit në krye për të zgjedhur një veti për të filtruar.
Nga pamja juaj e filtruar, përdorni kutitë e kontrollit për të zgjedhur të gjitha regjistrat ose regjistrat individualë.
Klikoni butonin Krijo grup të dhënash që shfaqet në krye të listës.
Jepini të dhënave tuaja të reja një emër dhe një përshkrim opsional.
Do të shihni të dhënat që sapo krijuat me grupin e kuruar të regjistrave.
Eksportoni të dhënat tuaja për analiza të mëtejshme si skedarë CSV, JSONL ose në Google Sheets.

Setet e të dhënave mund të jenë të dobishme për një numër rastesh të ndryshme përdorimi.

Përcaktoni grupe sfidash: Nxitni përmirësime të ardhshme që synojnë fushat ku dëshironi që inteligjenca juaj artificiale të përmirësohet.
Përcaktoni grupe mostrash: Për shembull, një mostër nga përdorimi real për të gjeneruar përgjigje nga një model tjetër, ose një koleksion rastesh në skajet e përdorimit për kontrolle rutinë para vendosjes.
Sete vlerësimi: Sete që përfaqësojnë përdorimin real nëpër aftësi të rëndësishme, për krahasim nëpër modele të tjera ose përsëritje të udhëzimeve të sistemit.

Ju mund të kontribuoni në kërkimin dhe zhvillimin e Gemini duke zgjedhur të ndani të dhënat tuaja me Google si shembuj demonstrues.

Kufizime

Regjistrimi nuk mbështetet aktualisht për sa vijon:

Modelet Imagen dhe Veo
Modelet e ngulitjes Gemini
Modeli i Robotikës Gemini
Të dhëna që përmbajnë video, GIF ose PDF
Agjentët e Parapamjes Publike në API-në Gemini

Çfarë vjen më pas

Prototip me historikun e seancave: Përdorni AI Studio Build për të krijuar një atmosferë të gjallë në kodin e aplikacioneve dhe shtoni çelësin tuaj API për të aktivizuar një historik të regjistrave të API-t Gemini për veçoritë e IA-së.
Riekzekutoni regjistrat me Gemini Batch API: Përdorni grupe të dhënash për marrjen e mostrave të përgjigjeve dhe vlerësimin e modeleve ose logjikës së aplikacionit duke riekzekutuar regjistrat me Gemini Batch API .