تفکر جوزا

مدل‌های سری Gemini 3 و 2.5 از یک «فرآیند تفکر» استفاده می‌کنند که به طور قابل توجهی توانایی‌های استدلال و برنامه‌ریزی چند مرحله‌ای آنها را بهبود می‌بخشد و آنها را برای کارهای پیچیده‌ای مانند کدنویسی، ریاضیات پیشرفته و تجزیه و تحلیل داده‌ها بسیار مؤثر می‌کند.

وقتی از یک مدل تفکر استفاده می‌کنید، Gemini قبل از پاسخ دادن، استدلال درونی می‌کند. API تعاملات این استدلال را از طریق مراحل thought ، مراحل اختصاصی که به ترتیب زمانی در کنار فراخوانی‌های تابع، ورودی‌های کاربر یا خروجی‌های مدل در آرایه steps ظاهر می‌شوند، آشکار می‌کند.

هر گام فکری شامل دو فیلد است:

میدان مورد نیاز توضیحات
signature ✅ بله یک نمایش رمزگذاری‌شده از وضعیت استدلال داخلی مدل. همیشه وجود دارد، حتی زمانی که مدل کمترین استدلال را انجام می‌دهد.
summary ❌ خیر آرایه‌ای از محتوا (متن و/یا تصاویر) که خلاصه‌ای از استدلال را ارائه می‌دهد. بسته به پیکربندی thinking_summaries ، اینکه آیا مدل به اندازه کافی استدلال انجام داده است یا خیر، یا نوع محتوا (برای مثال، تصاویر نهفته ممکن است خلاصه متنی نداشته باشند)، ممکن است خالی باشد.

تعاملات با تفکر

شروع تعامل با یک مدل متفکر مشابه هر درخواست تعامل دیگری است. یکی از مدل‌های دارای پشتیبانی تفکر را در فیلد model مشخص کنید:

پایتون

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Explain the concept of Occam's Razor and provide a simple, everyday example."
)
print(interaction.output_text)

جاوا اسکریپت

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: "gemini-3.7-flash",
    input: "Explain the concept of Occam's Razor and provide a simple, everyday example."
});
console.log(interaction.output_text);

استراحت

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.7-flash",
    "input": "Explain the concept of Occam'\''s Razor and provide a simple example."
  }'

خلاصه‌های فکری

خلاصه‌های تفکر، بینش‌هایی در مورد فرآیند استدلال داخلی مدل ارائه می‌دهند. به طور پیش‌فرض، فقط خروجی نهایی بازگردانده می‌شود. می‌توانید خلاصه‌های تفکر را با thinking_summaries فعال کنید:

پایتون

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="What is the sum of the first 50 prime numbers?",
    generation_config={
        "thinking_summaries": "auto"
    }
)

for step in interaction.steps:
    if step.type == "thought":
        print("Thought summary:")
        if step.summary:
            for content_block in step.summary:
                if content_block.type == "text":
                    print(content_block.text)
        print()
    elif step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print("Answer:")
                print(content_block.text)
                print()

جاوا اسکریپت

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: "gemini-3.7-flash",
    input: "What is the sum of the first 50 prime numbers?",