ویژگی‌های جدید در 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) به‌طور عمومی دردسترس (GA) و آماده استفاده در تولید هستند.

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

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

مدل‌های جدید

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

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

• صفحه مدل 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

• تأخیر کمتر در اجرای تکلیف: بالاترین توان عملیاتی در خانواده ۳.۵ برای تجزیه داده‌های با حجم بالا و استخراج سند.
• استدلال بهبودیافته و عملکرد چندحالته: مسیر انتقال قوی از ‫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 */
  ]
}

✅ انتقال توصیه‌شده (میانای برنامه‌سازی کاربردی تعاملات)

در «میانای برنامه‌سازی کاربردی تعاملات»، نوبت‌های مدل به‌صورت دستی ازپیش تکمیل نمی‌شوند. اگر برنامه شما قبلاً نوبت مدلی را برای سرکوب پیش‌گفتارها یا اجبار قالب‌بندی 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 3.x: برای به‌روزرسانی‌های «کیت توسعه نرم‌افزار» و حفظ امضای اندیشه، فهرست وارسی انتقال Gemini 3.5 را ببینید.

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

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

مراحل بعدی

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