وب‌هوک‌های Gemini؛ ضربه نهایی گوگل به تأخیر در گردش‌کارهای عامل‌محور

هنوز هم هر چند ثانیه یک‌بار از API می‌پرسید که آیا کار تمام شده است؟ اگر بله، شما در حال سوزاندن منابع محاسباتی و افزایش تأخیر در سیستم خود هستید.

در ۴ مه ۲۰۲۶، گوگل (Google) وب‌هوک‌های (Webhooks) رویداد-محور را برای Gemini API راه‌اندازی کرد. این اقدام، معماری سیستم را از مدل «کشیدن» (Pull-based) به مدل «هل دادن» (Push-based) تغییر داد تا اعلان‌ها به‌صورت آنی ارسال شوند.

به نقل از وبلاگ رسمی گوگل، این به‌روزرسانی دقیقاً برای پاسخ به نیازهای فزاینده در گردش‌کارهای عامل‌محور (Agentic Workflows) طراحی شده است. عملیات‌های پیچیده‌ای مانند «تحقیق عمیق» (Deep Research)، تولید ویدئوهای طولانی یا پردازش هزاران پرامپت از طریق Batch API ممکن است دقایق یا حتی ساعت‌ها زمان ببرند. پیش از این، توسعه‌دهندگان مجبور بودند برای ردیابی وضعیت کار، به‌طور مداوم از درخواست‌های GET استفاده کنند.

سیستم جدید به‌گونه‌ای عمل می‌کند که به محض تکمیل یک وظیفه، یک محموله (Payload) از نوع HTTP POST را به‌صورت آنی به سرور توسعه‌دهنده ارسال می‌کند. بر اساس مستندات گوگل، برای تضمین امنیت و پایداری در سطح سازمانی، پروتکل‌های زیر پیاده‌سازی شده‌اند:

• پروتکل‌های امنیتی: درخواست‌ها با استفاده از هدرهای webhook-signature ،webhook-id و webhook-timestamp امضا می‌شوند تا از حملات بازپخش (Replay Attacks) جلوگیری شود.
• پیکربندی منعطف: توسعه‌دهندگان می‌توانند نقاط انتهایی (Endpoints) خود را در سطح پروژه با استفاده از HMAC یا به‌صورت پویا در هر درخواست از طریق JWKS ایمن کنند.
• تضمین تحویل: سیستم تحویل «حداقل یک‌بار» (At-least-once delivery) را تضمین می‌کند و تا ۲۴ ساعت تلاش مجدد (Retry) خودکار را انجام می‌دهد.

همان‌طور که در تحلیل قبلی ما درباره‌ی استقرار Gemini Nano در مرورگر کروم برای کاهش وابستگی به ابر اشاره کردیم، گوگل در حال بهینه‌سازی تمام لایه‌های اکوسیستم خود است. این به‌روزرسانی اکنون عملیات‌های سنگین ابری را که قدرت عامل‌ها (Agents) را تأمین می‌کنند، بهینه می‌کند.

با گذار از رابط‌های ساده‌ی چت به سمت کارکنان خودکاری که ساعت‌ها فعالیت می‌کنند، تمرکز صنعت احتمالاً به سمت مدیریت «وضعیت پایدار» (Persistent State) در این جلسات طولانی‌مدت تغییر خواهد کرد.

اما این تنها بخشی از پازل است؛ مدیریت وضعیت در جلسات طولانی‌مدت، چالش بعدی است که در گزارش‌های آتی بررسی خواهیم کرد.

گام بعدی شما

• نقاط انتهایی (Endpoints) خود را از مدل Polling به HTTP POST تغییر دهید.
• برای اعتبارسنجی درخواست‌ها، پیاده‌سازی HMAC یا JWKS را در اولویت قرار دهید.
• منطق سیستم خود را برای پذیرش تحویل «حداقل یک‌بار» (At-least-once) بهینه‌سازی کنید تا از پردازش تکراری داده‌ها جلوگیری شود.