التنفيذ في الخلفية

بالنسبة إلى المهام التي تستغرق وقتًا طويلاً، مثل البحث المعمّق أو الاستدلال المعقّد أو عمليات التنفيذ المتعدّدة الخطوات للوكيل، يمكن أن تؤدي مهلات انتهاء الاتصال إلى مقاطعة طلبات HTTP العادية (التي يتم إغلاقها عادةً بعد 60 ثانية). توفّر واجهة برمجة التطبيقات Interactions API ميزة التنفيذ في الخلفية لتشغيل هذه المهام بشكل غير متزامن.

للسماح بتنفيذ التفاعل إلى أن يكمل المهمة على الخادم، اضبط "background": true عند إنشاء التفاعل. تعرض واجهة برمجة التطبيقات على الفور معرّف تفاعل، ويمكن لتطبيقات العميل استخدامه للتحقّق من الحالة أو تقدّم البث أو إعادة الاتصال ببث تم قطع اتصاله.

تتوفّر ميزة التنفيذ في الخلفية لنماذج Gemini العادية (مثل gemini-3.6-flash وgemini-3.1-pro-preview) و"الوكلاء المُدارون" (مثل antigravity-preview-05-2026).

إنشاء تفاعل في الخلفية

لبدء تفاعل في الخلفية، اضبط المَعلمة background على true عند إنشاء المورد.

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.6-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.6-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" \
  -d