ویژگی‌های جدید در Gemini 3.6 Flash و 3.5 Flash-Lite

جدیدترین مدل مدل‌های دیگر

‫Gemini 3.6 Flash (gemini-3.6-flash) و Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite) نسخه‌های نسل قبلی در سری Gemini 3 هستند و همچنان برای استفاده تولیدی دردسترس‌اند. برای جدیدترین مدل Flash ما، Gemini 3.8 Flash را ببینید.

• ‫Gemini 3.6 Flash: عملکرد قوی‌تر در تکالیف چندحالتی و عاملی پیچیده با کاهش استفاده از نشانگر، با قیمتی پایین‌تر از 3.5 Flash.
• Gemini 3.5 Flash-Lite: سریع‌ترین و کم‌هزینه‌ترین مدل در خانواده 3.5. برای اجرای توان گذرداد بالا، از نسل‌های قبلی Flash-Lite بهتر عمل می‌کند.

این راهنما توضیح می‌دهد که چه چیزی در هر مدل معرفی شده است، چه تغییراتی در API بر کد شما تأثیر می‌گذارد، و چگونه باید مهاجرت کنید.

مدل‌های جدید

هر دو مدل از پنجره بافت ۱ میلیون داده‌واحد، حداکثر ۶۴ هزار داده‌واحد خروجی، اندیشیدن، و مجموعه کامل ابزارهای داخلی ازجمله استفاده از رایانه پشتیبانی می‌کنند.

برای مشخصات کامل، به صفحه‌های مدل مراجعه کنید:

• صفحه مدل Gemini 3.6 Flash
• صفحه مدل Gemini 3.5 Flash-Lite

برای قیمت‌گذاری دقیق، صفحه قیمت‌گذاری را ببینید.

راه‌اندازی سریع

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Write a three.js script that renders an interactive 3D robot."
)

print(interaction.output_text)

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

const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Write a three.js script that renders an interactive 3D robot.",
  });
  console.log(interaction.outputText);
}

main();

curl "https://generativelanguage.googleapis.com/v1beta/interactions"       -H "x-goog-api-key: $GEMINI_API_KEY"       -H 'Content-Type: application/json'       -X POST       -d '{
    "model": "gemini-3.6-flash",
    "input": "Write a three.js script that renders an interactive 3D robot."
  }'

ویژگی‌های جدید Gemini 3.6 Flash

• کاهش نوبت و کد: گردش‌های کاری چندمرحله‌ای را با مراحل استدلال، نوبت‌های مکالمه، و فراخوانی‌های ابزار کمتری نسبت‌به Gemini 3.5 تکمیل می‌کند. همچنین مارپیچ حلقه اجرا را کاهش می‌دهد.
• تولید کد بهبودیافته: کد آماده تولید با کیفیت بالاتر و با ویرایش‌های ناخواسته کمتر و حلقه‌های اشکال‌زدایی کمتر تولید می‌کند.
• بهتر از دستورالعمل‌ها پیروی می‌کند: تغییرات ناخواسته فایل را درطول وظایف تشخیص خرابی کاهش می‌دهد.
• استدلال فضایی و چندحالته قوی: عملکرد بهبودیافته در تفسیر نمودار، تبدیل طرح اولیه بصری، و تولید چیدمان وب چندعنصری.
• بازرسی برنامه‌ریزی‌شده پیشاپیش: ترجیح می‌دهد که پیش‌از اعمال تغییرات، کدهای تشخیصی را بیشتر از Gemini 3.5 Flash اجرا کند. این کار دقت را در تکالیف پیچیده بهبود می‌بخشد، اما می‌تواند مراحل اکتشافی اضافی به کارهای معمول در پیش‌زمینه اضافه کند.
• پشتیبانی از «استفاده از رایانه»: به‌عنوان ابزاری داخلی برای خودکارسازی واسط کاربر عامل پشتیبانی می‌شود.
• اولویت سبک واسط کاربر: در ایجاد کد کاربردی بهتر است، اگرچه ارزیابان انسانی مدل‌های قبلی را برای چیدمان دیداری و سبک ترجیح می‌دادند. با ارائه دستورالعمل‌های طراحی صریح می‌توانید این مشکل را کاهش دهید.
• تلاش اندیشیدن پیش‌فرض (متوسط): از همان سطح اندیشیدن پیش‌فرض medium Gemini 3.5 Flash استفاده می‌کند.
• قیمت‌گذاری کاهش‌یافته: هزینه کمتر برای داده‌واحد برونداد (۷٫۵۰ دلار برای ۱ میلیون در مقایسه با ۹٫۰۰ دلار برای ۱ میلیون در ‫۳.۵ Flash). داده‌واحدهای ورودی همچنان ۱٫۵۰ دلار به‌ازای هر ۱ میلیون است.

ویژگی‌های جدید Gemini 3.5 Flash-Lite

• کاهش تأخیر اجرای تکلیف: بالاترین توان عملیاتی در خانواده 3.5 برای تجزیه داده‌های با حجم بالا و استخراج سند.
• استدلال بهبودیافته و عملکرد چندحالته: مسیر انتقال قوی از Gemini 2.5 Flash، با امتیازهای بالاتر در تکالیف استدلالی مانند HLE (‏۱۸٫۰٪ درمقابل ۱۱٫۰٪) و محک‌های چندحالته مانند CharXIV (‏۷۴٫۵٪ درمقابل ۶۳٫۷٪).
• هماهنگ‌سازی زیرعامل و قابلیت اطمینان ابزار: قابلیت اطمینان اجرای ابزار را برای اجرای کد، جستجو، و گردش‌های کاری MCP بهبود می‌بخشد. سطح تفکر را برای برنامه‌ریزی خودکار و تکالیف پیچیده عامل فرعی افزایش دهید.
• درک سند بهبودیافته: دقت را در تجزیه سند و استخراج داده‌های ساختاریافته بهبود می‌بخشد. بسته به پیچیدگی سند، سطوح تفکر حداقلی و بالا را آزمایش کنید.
• کدنویسی وب تعاملی و پردازش داده‌های جدولی: با برنامه‌ریزی بااستفاده از اجرای کد سبک، در جاوا اسکریپت واسط کاربری و پردازش داده‌های جدولی عملکرد قوی‌ای دارد.
• ماندگاری روبات گپ و شخصیت: پیروی از دستورالعمل‌های چند مرحله‌ای و ثبات شخصیت در Gemini 3.1 Flash-Lite قوی‌تر است.
• پشتیبانی از «استفاده از رایانه»: به‌عنوان ابزاری داخلی برای خودکارسازی واسط کاربر عامل پشتیبانی می‌شود.

انتخاب مدل Flash یا Flash-Lite مناسب

از این جدول برای انتخاب مدل و مسیر انتقال مناسب برای حجم‌های کاری‌تان استفاده کنید.

هر دو مدل نیاز به حذف پارامترهای نمونه‌برداری منسوخ‌شده (temperature، top_p، top_k) و نوبت‌های ازپیش تکمیل‌شده مدل دارند. برای جزئیات، تغییرات میانای برنامه‌سازی کاربردی را ببینید.

پشتیبانی عامل Antigravity

‫Gemini 3.6 Flash از عامل Antigravity در «عامل‌های مدیریت‌شده Gemini» پشتیبانی می‌کند.

برای نمونه‌های کد فعلی و جدیدترین پیکربندی عامل پیش‌فرض، راهنمای عامل Antigravity و راهنمای Gemini 3.8 Flash را ببینید.

تغییرات میانای برنامه‌سازی کاربردی و به‌روزرسانی‌های پارامتر

با شروع از Gemini 3.6 Flash و Gemini 3.5 Flash-Lite، تغییرات API زیر برای این مدل‌ها و همه نسخه‌های آتی مدل Gemini اعمال می‌شود.

• منسوخ شدن پارامتر نمونه‌برداری: temperature، top_p، و top_k منسوخ شده‌اند. این API این پارامترها را نادیده می‌گیرد و در نسل‌های مدل آینده خطا برمی‌گرداند.
• اعتبارسنجی نوبت ازپیش تکمیل‌شده مدل: ازپیش تکمیل کردن نوبت‌های مدل دیگر پشتیبانی نمی‌شود. اگر آخرین نوبت غیرخالی در درخواست نوبت model باشد، API خطای 400 را برمی‌گرداند.

بخش‌های زیر توضیحات دقیق و نمونه کدهای مربوط به هر تغییر API را ارائه می‌دهند.

۱. منسوخ شدن پارامتر نمونه‌برداری (temperature،‏ top_p،‏ top_k)

‫temperature،‏ top_p، و top_k منسوخ شده‌اند و نادیده گرفته می‌شوند. در نسل‌های آینده مدل، ارائه این پارامترها خطای HTTP 400 برمی‌گرداند. این پارامترها را از همه درخواست‌ها بردارید.

# ⚠️ Remove these parameters (deprecated)
generation_config = {
     "temperature": 0.7,
     "top_p": 0.9,
     "top_k": 40,
}

برای بهبود قطعیت، دستورالعمل سیستم را با قوانین صریح برای مورد استفاده خاص خود تعریف کنید.

۲. اعتبارسنجی نوبت ازپیش تکمیل‌شده مدل

درخواست‌های API که با نوبت نقش مدل غیرخالی پایان می‌یابند مجاز نیستند و خطای HTTP 400 برمی‌گردانند.

⚠️ پرهیز شود

در generateContent قدیمی یا بار داده‌های REST خام، پایان دادن با نوبت نقش مدل اکنون غیرمجاز است:

/* ❌ DO NOT: End payload contents with a 'model' role turn */
{
  "contents": [
    {"role": "user", "parts": [{"text": "Translate 'Hello world' to Spanish."}]},
    {"role": "model", "parts": [{"text": "Translation:"}]}  /* ❌ Returns error */
  ]
}

✅ انتقال توصیه‌شده (Interactions API)

در Interactions API، نوبت‌های مدل به‌صورت دستی پیش‌تکمیل نمی‌شوند. اگر برنامه شما قبلاً نوبت مدل را ازپیش تکمیل می‌کرد تا مقدمه‌ها را سرکوب کند یا قالب‌بندی JSON را اجباری کند، به‌جای آن از system_instruction یا بروندادهای ساختاریافته استفاده کنید.

# ✅ RECOMMENDED: Use system_instruction in the Interactions API to specify output format
interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Translate 'Hello world' to Spanish.",
    system_instruction="Output only the translation without introductory text.",
)

بازبینه انتقال

انتقال به gemini-3.6-flash

• به‌روزرسانی شناسه مدل: رشته مدل هدف را به gemini-3.6-flash تغییر دهید.
• اعمال به‌روزرسانی‌های پارامتر: پارامترهای نمونه‌گیری منسوخ‌شده (temperature، top_p، top_k)، candidate_count (در Gemini 3 و نسخه‌های جدیدتر پشتیبانی نمی‌شود)، و نوبت‌های مدل پیش‌تکمیل‌شده را همان‌طور که در تغییرات API و به‌روزرسانی‌های پارامتر به‌تفصیل شرح داده شده است بردارید.
• پیکربندی سطح تفکر: thinking_budget را با thinking_level ("medium" یا "high") جایگزین کنید.
• فراخوانی تابع ممیزی:
  • دارایی‌های چندحالتی را در محموله پاسخ قرار دهید.
  • دستورالعمل‌های درون‌خطی را بااستفاده از \n\n قالب‌بندی کن.
  • اگر Malformed_Function_Call خطای مربوط به نوشتار پیش‌ابزار مشاهده کردید، راهکارهای دور زدن الزامات نوشتار پیش‌ابزار را ببینید.
• ملزومات پایه Gemini نسخه ۳.x: برای به‌روزرسانی‌های «کیت توسعه نرم‌افزار» و حفظ امضای فکر، امضاهای فکر را ببینید.

انتقال به gemini-3.5-flash-lite

• به‌روزرسانی شناسه مدل: رشته مدل هدف را به gemini-3.5-flash-lite تغییر دهید.
• پیکربندی سطح تلاش اندیشیدن:
  • برای استخراج، مسیریابی، یا طبقه‌بندی با حجم بالا: thinking_level را روی "minimal" (پیش‌فرض) بگذارید تا حداکثر توان عملیاتی را داشته باشید.
  • برای کارگزاران فرعی خودکار با فراخوانی ابزار، اجرای کد، یا استدلال چندمرحله‌ای: thinking_level را روی "medium" یا "high" تنظیم کنید تا از پایان زودهنگام ابزار جلوگیری شود.
• پارامترهای منسوخ‌شده را بردارید و فراخوانی تابع را اعتبارسنجی کنید: همان قوانین 3.6 Flash را اعمال کنید.
• الزامات پایه Gemini 3.x: به امضاهای فکری مراجعه کنید.

مدل‌های دیگر

• ‫Gemini 4 Argon (جدیدترین)
• Gemini 3.8 Flash
• دیدن همه مدل‌ها

قدم بعدی چیست

• مشخصات «میانای برنامه‌سازی کاربردی» را در نمای کلی مدل‌ها مرور کنید.
• هماهنگی چند عامل را در راهنمای میانای برنامه‌سازی کاربردی تعاملات کاوش کنید.
• پیام‌واره‌ها را در Google AI Studio آزمایش و پالایش کنید.