API-ja e Ndërveprimeve

API-ja e Ndërveprimeve është ndërfaqja jonë e re dhe mënyra më e drejtpërdrejtë për të ndërtuar me modele dhe agjentë Gemini. Që nga qershori 2026, është përgjithësisht e disponueshme dhe ndërfaqja e rekomanduar për të gjitha projektet e reja.

Edhe pse tani konsiderohet i trashëguar, API-ja origjinale generateContent mbetet e mbështetur plotësisht.

Pse të përdoret API-ja e Ndërveprimeve?

• Aftësi të reja menjëherë : Gjendje bisede opsionale nga ana e serverit duke përdorur previous_interaction_id , hapa ekzekutimi të vëzhgueshëm për debugging dhe renderim të ndërfaqes së përdoruesit, dhe ekzekutim në sfond për detyra që ekzekutohen për një kohë të gjatë duke përdorur background=true .
• Kosto më e ulët me shkallë më të larta të goditjes në memorien e përkohshme : Menaxhimi i gjendjes nga ana e serverit mundëson ruajtje më efikase të kontekstit në memorien e përkohshme nëpër raunde, duke zvogëluar kostot e tokenëve për biseda me shumë raunde.
• Ndërtuar për modele dhe agjentë të nivelit të lartë : I ndërtuar posaçërisht për modelet e të menduarit, përdorimin e mjeteve me shumë hapa dhe rrjedhat komplekse të arsyetimit — duke thjeshtuar procesin e ndërtimit, debuggingut dhe orkestrimit të aplikacioneve agjentike.
• API i vetëm për modelet dhe agjentët : Një ndërfaqe e unifikuar për të thirrur drejtpërdrejt modelet dhe agjentët Gemini, siç janë Deep Research dhe agjentët e menaxhuar me porosi — pa pika fundore ose modele të ndara për t'u mësuar.
• Ku lançohen gjërat e reja : Duke shkuar përpara, modele dhe aftësi të reja përtej familjes kryesore kryesore, së bashku me aftësi dhe mjete të reja agjentësh, do të lançohen në Interactions API.

Si parazgjedhje, API-ja e Ndërveprimeve ruan kërkesat në mënyrë që të mund të shfrytëzoni veçoritë e menaxhimit të gjendjes në anën e serverit duke përdorur previous_interaction_id . Mund të zgjidhni sjelljen pa gjendje duke vendosur store=false . Shihni seksionin e ruajtjes së të dhënave për detaje.

Filloni

• Konfiguroni agjentin tuaj të kodimit : Lidhuni me Gemini Docs MCP dhe instaloni aftësinë gemini-interactions-api për t'i dhënë asistentit tuaj akses të drejtpërdrejtë në dokumentet dhe praktikat më të mira më të fundit të zhvilluesit. Konfiguroni agjentin tuaj të kodimit →
• Migroni nga generateContent : Nëse keni një integrim ekzistues, ndiqni Udhëzuesin e Migrimit për të kaluar në API-në e Ndërveprimeve.
• Filloni : Filloni në udhëzuesin e fillimit të Interactions API .

Udhëzues për veçoritë

Eksploroni aftësitë specifike të Interactions API përmes këtyre udhëzuesve. Mund të përdorni butonin e ndërrimit në këto faqe për të kaluar midis generateContent dhe Interactions API:

• Gjenerimi i tekstit
• Gjenerimi i imazhit
• Kuptimi i imazhit
• Kuptimi i audios
• Kuptimi i videos
• Përpunimi i dokumenteve
• Thirrja e funksionit
• Prodhim i strukturuar
• Agjent i Kërkimeve të Thella
• Përfundim fleksibël
• Përfundimi i përparësisë

Si funksionon API-ja e Ndërveprimeve

API-ja e Ndërveprimeve përqendrohet rreth një burimi kryesor: Interaction . Një Interaction përfaqëson një kthesë të plotë në një bisedë ose detyrë. Ai vepron si një regjistrim sesioni, që përmban të gjithë historinë e një ndërveprimi si një sekuencë kronologjike hapash ekzekutimi . Këta hapa përfshijnë mendime modeli, thirrje dhe rezultate mjetesh nga serveri ose klienti (si function_call dhe function_result ), dhe model_output përfundimtar. Burimi i ruajtur (i marrë nëpërmjet interactions.get ) përfshin gjithashtu hapa user_input për kontekst të plotë, megjithëse përgjigja interactions.create kthen vetëm hapa të gjeneruar nga modeli.

Kur bëni një thirrje në interactions.create , ju po krijoni një burim të ri Interaction .

Menaxhimi i gjendjes nga ana e serverit

Mund të përdorni id në e një bashkëveprimi të përfunduar në një thirrje pasuese duke përdorur parametrin previous_interaction_id për të vazhduar bisedën. Serveri përdor këtë ID për të rimarrë historikun e bisedës, duke ju kursyer nga ridërgimi i të gjithë historikut të bisedës.

Parametri previous_interaction_id ruan vetëm historikun e bisedës (të dhënat hyrëse dhe dalëse) duke përdorur previous_interaction_id . Parametrat e tjerë janë të përcaktuar sipas ndërveprimit dhe zbatohen vetëm për ndërveprimin specifik që po gjeneroni aktualisht:

• tools
• system_instruction
• generation_config (duke përfshirë thinking_level , temperature , etj.)

Kjo do të thotë që duhet t'i rispecifikoni këto parametra në çdo bashkëveprim të ri nëse dëshironi që ato të zbatohen. Ky menaxhim i gjendjes nga ana e serverit është opsional; gjithashtu mund të veproni në modalitetin pa gjendje duke dërguar historikun e plotë të bisedës në çdo kërkesë.

Ruajtja dhe ruajtja e të dhënave

Si parazgjedhje, API 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 (me previous_interaction_id ), ekzekutimin në sfond (duke përdorur background=true ) dhe për qëllime vëzhgueshmërie.

• Niveli i Paguar : Sistemi ruan ndërveprimet për 55 ditë .
• Niveli Falas : Sistemi ruan ndërveprimet për 1 ditë .

Nëse nuk e dëshironi këtë, mund të vendosni store=false në kërkesën tuaj. Ky kontroll është i ndarë nga menaxhimi i gjendjes; mund të zgjidhni të mos përdorni hapësirën e ruajtjes për çdo ndërveprim. Megjithatë, vini re se store=false nuk është i përputhshëm me background=true dhe parandalon përdorimin e previous_interaction_id për raundet pasuese.

Mund t’i fshini ndërveprimet e ruajtura në çdo kohë duke përdorur metodën e fshirjes që gjendet në Referencën API . Mund t’i fshini ndërveprimet vetëm nëse e dini ID-në e ndërveprimit.

Pas skadimit të periudhës së ruajtjes, të dhënat tuaja do të fshihen automatikisht.

Sistemi përpunon objektet e Ndërveprimit sipas termave .

Praktikat më të mira

• Shkalla e klikimeve në memorien e përkohshme : Përdorimi i previous_interaction_id për të vazhduar bisedat i lejon sistemit të përdorë më lehtë ruajtjen implicite në memorien e përkohshme për historikun e bisedave, gjë që përmirëson performancën dhe ul kostot.
• Përzierja e ndërveprimeve : Ju keni fleksibilitetin për të përzier dhe përputhur ndërveprimet e Agjentit dhe Modelit brenda një bisede. Për shembull, mund të përdorni një agjent të specializuar, si agjenti i Kërkimit të Thellë, për mbledhjen fillestare të të dhënave, dhe më pas të përdorni një model standard Gemini për detyra pasuese, të tilla si përmbledhja ose riformatimi, duke i lidhur këto hapa me previous_interaction_id .

Modele dhe agjentë të mbështetur

SDK-të

Mund të përdorni versionin më të fundit të SDK-ve të Google GenAI për të aksesuar API-në e Ndërveprimeve.

• Në Python, kjo është paketa google-genai nga versioni 2.3.0 e tutje.
• Në JavaScript, kjo është paketa @google/genai nga versioni 2.3.0 e tutje.

Mund të mësoni më shumë rreth mënyrës së instalimit të SDK-ve në faqen e Bibliotekave .

Kufizime

• MCP në distancë : Gemini 3 nuk e mbështet MCP në distancë, kjo do të vijë së shpejti.

Karakteristikat e mëposhtme mbështeten nga generateContent API, por nuk janë ende të disponueshme në Interactions API:

• Meta të dhëna videoje : Fusha video_metadata , përdoret për të vendosur intervalet e prerjes dhe shpejtësitë e personalizuara të kuadrove për të kuptuar videon.
• API-ja e grupeve
• Thirrja automatike e funksionit (Python)
• Ruajtja në memorje të qartë : Vini re se ruajtja në memorje e nënkuptuar nga ana e serverit është e disponueshme në Interactions API nëpërmjet previous_interaction_id .

Reagime

Reagimet tuaja janë thelbësore për zhvillimin e API-t të Ndërveprimeve. Ndani mendimet tuaja, raportoni gabime ose kërkoni veçori në Forumin tonë të Komunitetit të Zhvilluesve të IA-së në Google .

Çfarë vjen më pas

• Provo fletoren e nisjes së shpejtë të Interactions API .
• Mësoni më shumë rreth Agjentit të Kërkimeve të Thellë Gemini .