مدلهای سری 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?",