Ekzekutimi në sfond

Për detyra që ekzekutohen për një kohë të gjatë, si kërkime të thella, arsyetime komplekse ose ekzekutime agjentësh me shumë hapa, skadimet e kohës së lidhjes mund të ndërpresin kërkesat standarde HTTP (të cilat zakonisht mbyllen pas 60 sekondash). API-ja e Ndërveprimeve ofron ekzekutim në sfond për të ekzekutuar këto detyra në mënyrë asinkrone.

Për ta lënë bashkëveprimin të funksionojë derisa të përfundojë detyra në server, vendosni "background": true kur krijoni bashkëveprimin. API-ja kthen menjëherë një ID bashkëveprimi, të cilin aplikacionet e klientit mund ta përdorin për të pyetur për statusin, progresin e transmetimit ose për t'u rilidhur me një transmetim të shkëputur.

Ekzekutimi në sfond mbështetet për modelet standarde Gemini (siç janë gemini-3.7-flash dhe gemini-3.1-pro-preview ) dhe Agjentët e Menaxhuar (siç është antigravity-preview-05-2026 ).

Krijo një ndërveprim në sfond

Për të filluar një bashkëveprim në sfond, vendosni parametrin e background në true kur krijoni burimin.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Write a guide on space exploration.",
    background=True,
)
print(f"Created background interaction ID: {interaction.id}")

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: "gemini-3.7-flash",
    input: "Write a guide on space exploration.",
    background: true,
});
console.log(`Created background interaction ID: ${interaction.id}`);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Api-Revision: 2026-05-20" \