Interactions API पर माइग्रेट करना

इस गाइड से, आपको generateContent API से Interactions API पर माइग्रेट करने में मदद मिलती है.

Interactions API, Gemini मॉडल और एजेंट के साथ काम करने का सबसे आसान और बेहतर तरीका है. generateContent अब भी पूरी तरह से काम करता है. हालांकि, हमारा सुझाव है कि नए डेवलपमेंट के लिए, Interactions API का इस्तेमाल करें.

माइग्रेट क्यों करें?

Interactions API, Gemini मॉडल और एजेंट के साथ काम करने का सबसे आसान और बेहतर तरीका है:

• सर्वर-साइड इतिहास का मैनेजमेंट: previous_interaction_id की मदद से, मल्टी-टर्न फ़्लो को आसान बनाया गया है. सर्वर, डिफ़ॉल्ट रूप से स्टेट को चालू करता है (store=true). हालांकि, store=false सेट करके, स्टेटलेस बिहेवियर को चुना जा सकता है.
• ऑब्ज़र्वेबल एक्ज़ीक्यूशन स्टेप: टाइप किए गए स्टेप की मदद से, कॉम्प्लेक्स फ़्लो को डीबग करना आसान हो जाता है. साथ ही, इंटरमीडिएट इवेंट (जैसे, थॉट या सर्च विजेट) के लिए यूज़र इंटरफ़ेस (यूआई) रेंडर करना आसान हो जाता है.
• टूल का इस्तेमाल और एजेंटिक वर्कफ़्लो: टाइप किए गए एक्ज़ीक्यूशन स्टेप की मदद से, मल्टी-स्टेप टूल के इस्तेमाल, ऑर्केस्ट्रेशन, और कॉम्प्लेक्स रीज़निंग फ़्लो के लिए, नेटिव सपोर्ट मिलता है.
• लंबे समय तक चलने वाले और बैकग्राउंड टास्क: Deep Think और Deep Research जैसी समय लेने वाली कार्रवाइयों को बैकग्राउंड प्रोसेस में ऑफ़लोड करने की सुविधा मिलती है. इसके लिए, background=true का इस्तेमाल किया जाता है.

सामान्य इनपुट/आउटपुट

इस सेक्शन में, टेक्स्ट जनरेट करने के सामान्य अनुरोध को माइग्रेट करने का तरीका बताया गया है.

पहले (generateContent)

generateContent API, स्टेटलेस होता है और सीधे जवाब देता है. जवाब का स्ट्रक्चर, आउटपुट को candidates की सूची में रैप करता है. हर कैंडिडेट में, पार्स करने के लिए parts की सूची के साथ content होता है.

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash-lite", contents="Tell me a joke."
)
print(response.text)

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

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: "gemini-2.5-flash-lite",
  contents: "Tell me a joke.",
});
console.log(response.text);

# Request
curl -X POST "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-lite:generateContent" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "contents": [{
        "parts": [{
            "text": "Tell me a joke."
        }]
    }]
}'

# Response
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Why did the chicken cross the road? To get to the other side!"
          }
        ],
        "role": "model"
      },
      "finishReason":