بناء تطبيق عبر Google AI Studio: دليل عملي محدث 2026 ونماذج Gemini الجديدة

بعد الاهتمام الكبير والتفاعل الملحوظ من متابعي مدونة Samcoi حول شرح Google AI Studio وأداة Vibe Coding لبناء التطبيقات، واجه العديد من المطورين والمبتدئين تساؤلات حاسمة حول كيفية بناء تطبيق عبر Google AI Studio بالاعتماد على التوثيقات الرسمية المحدثة، لا سيما بعد التغييرات الجذرية التي أقرتها شركة جوجل في دورة حياة نماذجها وإيقاف الإصدارات السابقة لصالح أجيال أكثر كفاءة وسرعة.

في هذا الدليل العملي المحدث، سنأخذ بيدك خطوة بخطوة لبناء أول تطبيق حقيقي للذكاء الاصطناعي، مستعرضين خارطة النماذج المعتمدة حالياً، ومحذرين من النماذج المهجورة، مع تقديم كود بايثون القياسي الجاهز للتشغيل باستخدام مكتبة جوجل الرسمية الحديثة google-genai.

خارطة نماذج جوجل في AI Studio: ما هي النماذج النشطة وما الذي تم إيقافه؟

شهدت منظومة الذكاء الاصطناعي في جوجل مرحلة انتقالية كبرى استهدفت توحيد البنية التحتية، وهو ما يفرض على كل مطور معرفة النماذج المعتمدة لتجنب توقف تطبيقاته:

• النماذج التي تم إيقافها وإغلاقها رسمياً (Deprecated & Retired): قررت جوجل الإيقاف التام لسلسلة Gemini 1.5 (مثل gemini-1.5-flash و gemini-1.5-pro بإصداراتها 001 و 002)، فضلاً عن إغلاق نقاط النهاية التجريبية المبكرة لسلسلة Gemini 2.0. وتؤكد توثيقات جوجل أن أي استدعاء برمجي لهذه المعرفات القديمة سيعود بأخطاء توقف فورية.
• النموذج القياسي المعتمد للإنتاج (Gemini 3.8 Flash): يمثل gemini-3.8-flash اليوم العمود الفقري لمنصة Google AI Studio؛ فهو مصمم خصيصاً لتطبيقات الويب والوكلاء المستقلين (Agentic AI) بفضل سرعته الفائقة، وتكلفته المنخفضة للغاية، ودعمه لمعالجة النصوص والصور والفيديو بدقة استثنائية.
• نماذج التفكير والاستدلال المتقدم (Gemini 3.8 Pro / Frontier): مخصصة للمهام البرمجية المعقدة، والتحليلات الرياضية متعددة الخطوات، وهندسة الأنظمة الحساسة التي تتطلب استدلالاً منطقياً عميقاً وضبطاً لميزانية التفكير (Thinking Budget).

الخطوة 1: تهيئة الحساب واستخراج مفتاح Gemini API الجديد

للبدء في بناء تطبيق عبر Google AI Studio وفق المعايير الحديثة:

1. ادخل إلى موقع Google AI Studio الرسمي وسجل الدخول بحساب جوجل المعتمد.
2. انقر على قسم Get API key في القائمة الجانبية، ثم اختر إنشاء مفتاح جديد (Create API Key) في مشروع Google Cloud مخصص.
3. انسخ المفتاح السري، واحرص على تخزينه في ملف بيئة محلي .env لحمايته من أي تسريب برمجيات غير مقصود.

الخطوة 2: استغلال واجهة “Build your ideas with Gemini” السريعة

توفر منصة AI Studio واجهة مطورة تتيح لك كتابة فكرة التطبيق بنص طبيعي في مربع “Describe your idea”؛ لتقوم المنصة تلقائياً بصياغة نموذج مبدئي واختيار المعلمات الأمثل. كما توفر المنصة نماذج جاهزة للانطلاق السريع مثل:

• تطبيقات تحرير وتعديل الصور: بالاستفادة من نماذج التوليد مثل نانو بانانا التي شرحناها بالتفصيل في تعديل وتحسين جودة الصور بنماذج نانو بانانا.
• أدوات البحث المباشر (Search Grounding): ربط النموذج بمحرك بحث جوجل لجلب معلومات حية في الوقت الفعلي والحد من الهلوسة.
• تطبيقات الصوت التفاعلية: عبر واجهة Gemini Live API للمحادثات الصوتية المباشرة ثنائية الاتجاه.

الخطوة 3: تصدير الكود باستخدام حزمة google-genai الحديثة

تخلت جوجل رسمياً عن حزمتها القديمة google-generativeai واستبدلتها بالحزمة الموحدة google-genai. لتثبيت الحزمة الحديثة على جهازك، نفّذ الأمر التالي في الطرفية:

pip install google-genai

وفيما يلي كود بايثون الرسمي المحدث، كما يتم تصديره مباشرة عبر زر Get Code داخل Google AI Studio، مع تفعيل الإخراج المهيكل (Structured JSON):

import os
from google import genai
from google.genai import types

# 1. تهيئة العميل بمفتاح API
client = genai.Client(api_key=os.environ.get("GEMINI_API_KEY"))

# 2. إعداد مواصفات الاستجابة وتحديد سلوك المساعد
config = types.GenerateContentConfig(
    system_instruction="أنت مساعد تقني ذكي لمدونة Samcoi، تجيب بدقة واختصار دون كليشيهات.",
    temperature=0.3,
    response_mime_type="application/json"
)

# 3. استدعاء النموذج القياسي الحديث gemini-3.8-flash
response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="اذكر 3 خطوات أساسية لنشر تطبيق ذكاء اصطناعي على السحابة.",
    config=config
)

print(response.text)

3 ممارسات جوهرية توصي بها دوكيومنتيشن جوجل

• الاعتماد على Structured Outputs: استخدم response_mime_type="application/json" لضمان استلام بيانات متوافقة مع قواعد بيانات وتطبيقات الواجهة الأمامية دون الحاجة لمعالجة نصوص معقدة.
• تفعيل ميزة تنفيذ الأكواد (Code Execution): تتيح للنموذج كتابة كود بايثون وتشغيله في حاوية سحابية آمنة لحل العمليات الحسابية الدقيقة وتوليد الرسوم البيانية.
• الترقية السلسة إلى Vertex AI: تتيح لك المنصة بضغطة زر واحدة نقل مشروعك من Google AI Studio إلى منصة المؤسسات Google Cloud Vertex AI عندما تتطلب بيئة العمل مستويات أمان وحوكمة متقدمة.

الأسئلة الشائعة حول بناء تطبيق عبر Google AI Studio

لماذا توقفت استدعاءات نماذج Gemini 1.5 في الأكواد القديمة؟

لأن جوجل أعلنت إيقاف نماذج Gemini 1.5 Pro و Flash رسمياً وأغلقت خوادمها، ويتعين على جميع المطورين تحديث أسماء النماذج في أكوادهم إلى Gemini 3.8 Flash لضمان استمرار عمل التطبيقات.

ما هي الحزمة البرمجية المعتمدة حالياً في توثيق بايثون؟

الحزمة الرسمية الوحيدة المعتمدة حالياً هي google-genai، بينما تصنف مكتبة google-generativeai السابقة كإصدار قديم مهجور لا يوصى باستخدامه في المشاريع الجديدة.

هل يوفر Google AI Studio استهلاكاً مجانياً للنماذج الحديثة؟

نعم، تمنح جوجل حصة استهلاك مجانية سخية يومياً للمطورين لتجربة وبناء النماذج الأولية عبر Gemini 3.8 Flash دون الحاجة لإدخال بيانات بطاقة دفع بنكية.