يتيح Google AI Studio الآن تطوير التطبيقات المتكاملة، ما يمكّنك من إنشاء تطبيقات تتجاوز النماذج الأولية من جهة العميل. باستخدام وقت التشغيل من جهة الخادم، يمكنك إدارة الأسرار والربط بواجهات برمجة التطبيقات الخارجية وإنشاء تجارب متعددة اللاعبين في الوقت الفعلي.
وقت التشغيل من جهة الخادم
يمكن أن تتضمّن تطبيقات Google AI Studio الآن مكوّنًا من جهة الخادم (Node.js). ويتيح لك هذا ما يلي:
- تنفيذ منطق من جهة الخادم: يمكنك تشغيل رمز لا يجب عرضه للعميل.
- الوصول إلى حِزم npm: يمكن لـ Antigravity Agent تثبيت الحِزم واستخدامها من نظام npm المتكامل.
- التعامل مع الأسرار: يمكنك استخدام مفاتيح واجهة برمجة التطبيقات وبيانات الاعتماد بأمان.
استخدام حِزم npm
لست بحاجة إلى تشغيل npm install يدويًا. ما عليك سوى أن تطلب من Agent إضافة وظيفة تتطلّب حزمة، وسيتولّى تثبيتها واستيرادها.
مثال: > "استخدِم axios لجلب البيانات من واجهة برمجة التطبيقات الخارجية".
إدارة الأسرار بأمان
باستخدام الرمز من جهة الخادم وإدارة الأسرار، يمكنك الآن إنشاء تطبيقات تتفاعل مع العالم.
مفتاح Gemini API
عند إنشاء تطبيق جديد يستخدم Gemini API، يضبط AI Studio تلقائيًا GEMINI_API_KEY كسر من جهة الخادم، بدون الحاجة إلى الإعداد اليدوي. يمكنك عرض هذا المفتاح في لوحة الأسرار ضِمن "الإعدادات". يتم إجراء طلبات Gemini API في تطبيقك من الرمز من جهة الخادم باستخدام هذا المفتاح، لذا لا يتم عرضه مطلقًا في المتصفّح.
مفاتيح واجهات برمجة التطبيقات الخارجية
بالنسبة إلى الخدمات الأخرى، يمكنك إضافة مفاتيح واجهة برمجة التطبيقات يدويًا:
- واجهات برمجة التطبيقات الخارجية: يمكنك الربط بخدمات مثل Stripe أو SendGrid أو واجهات برمجة تطبيقات REST المخصّصة.
- قواعد البيانات: يمكنك الربط بقواعد بيانات خارجية (مثل Supabase أو Firebase أو MongoDB Atlas) للاحتفاظ بالبيانات بعد انتهاء الجلسة.
عند إنشاء تطبيقات واقعية، غالبًا ما تحتاج إلى الربط بخدمات خارجية (مثل Twilio أو Slack أو قواعد البيانات) تتطلّب مفاتيح واجهة برمجة التطبيقات. يمكنك إضافة المفاتيح يدويًا باتّباع الخطوات التالية:
- إضافة سر: انتقِل إلى قائمة الإعدادات في Google AI Studio وابحث عن قسم "الأسرار".
- تخزين المفتاح: أضِف مفاتيح واجهة برمجة التطبيقات أو الرموز السرية هنا.
- الوصول في الرمز: يمكن لـ Agent كتابة رمز من جهة الخادم يصل إلى هذه الأسرار بأمان (عادةً من خلال متغيّرات البيئة)، ما يضمن عدم عرضها مطلقًا في المتصفّح من جهة العميل.
عند الحاجة، سيُظهر Agent أيضًا بطاقة في المحادثة تطلب منك إضافة المفاتيح كلما كان هناك سر جديد مطلوب أو عند رصد مفتاح جديد في متغيّرات البيئة للمشروع.
التكامل مع Firebase لقاعدة البيانات والمصادقة
يسهّل Google AI Studio الآن إضافة قاعدة بيانات أو مصادقة إلى تطبيقك من خلال التكامل مع Firebase. يمكن لـ Antigravity Agent توفير الخدمات التالية وإعدادها لك تلقائيًا:
- قاعدة بيانات Firestore: هي قاعدة بيانات NoSQL مرنة وقابلة للتوسّع في السحابة الإلكترونية لتخزين البيانات ومزامنتها من أجل التطوير من جهة العميل ومن جهة الخادم.
- مصادقة Firebase: تتيح للمستخدمين تسجيل الدخول بأمان إلى تطبيقك باستخدام مسارات "تسجيل الدخول باستخدام حساب Google".
ما عليك سوى أن تطلب من Agent "إضافة قاعدة بيانات إلى تطبيقي" أو "إعداد ميزة تسجيل الدخول باستخدام حساب Google"، وسيتولّى إعداد التكوين اللازم وإنشاء الرمز لك.
تتيح لك Firebase البدء مجانًا، ويمكنك اختياريًا التوسّع باستخدام حساب مدفوع عندما تكون مستعدًا للحصول على حصة أكبر أو لاستخدام الميزات المدفوعة.
واجهات برمجة التطبيقات في Google Workspace
يتيح لك Google AI Studio إنشاء تطبيقات تتصل بواجهات برمجة التطبيقات في Google Workspace، ما يسمح للمستخدمين بالعمل على بياناتهم الحقيقية: الرسائل الإلكترونية وجداول البيانات والمستندات وأحداث التقويم وغير ذلك، كل ذلك ضِمن تطبيقك. لم يعُد عليك إعداد مشروع على السحابة الإلكترونية في Google Cloud أو ضبط OAuth أو إدارة واجهة برمجة التطبيقات يدويًا.
آلية العمل
يمكنك إضافة عملية تكامل مع Workspace بطريقتَين:
- وصفها في لو1حة المحادثة: ما عليك سوى إخبار Agent بما تريده في لوحة المحادثة في أسفل الصفحة. على سبيل المثال، "أنشئ أداة لتتبُّع النفقات تسجِّل الإيصالات في "جدول بيانات Google"" أو "أنشئ لوحة بيانات تلخّص رسائل Gmail غير المقروءة."
- الاختيار من لوحة عمليات التكامل: افتح لوحة عمليات التكامل في الشريط الجانبي الأيسر من وضع "الإنشاء" وفعِّل تطبيق Workspace الذي تريد ربطه.
عند إضافة تطبيق Workspace، يتولّى AI Studio تلقائيًا ما يلي:
- ربط واجهة برمجة تطبيقات Google اللازمة بتطبيقك
- إنشاء الرمز من جهة الخادم لاستدعاء واجهة برمجة التطبيقات
- إضافة مسار آمن "لتسجيل الدخول باستخدام حساب Google" حتى يتمكّن المستخدمون النهائيون لتطبيقك من منح الإذن بالوصول إلى بياناتهم
التطبيقات المتوافقة
تتوفّر تطبيقات Google Workspace التالية:
| التطبيق | ما يمكنك إنشاؤه |
|---|---|
| تقويم Google | قراءة الأحداث والتقاويم وإنشاؤها وإدارتها |
| Google Chat | قراءة المحادثات والمساحات الجماعية والتفاعل معها |
| مستندات Google | إنشاء المستندات وقراءتها وتعديلها وتنسيقها |
| Google Drive | تنظيم الملفات والمجلدات والبحث عنها وإدارتها |
| نماذج Google | إنشاء الاستطلاعات وتعديل الأسئلة واسترداد الردود |
| Gmail | قراءة محتوى البريد الإلكتروني وإرساله وإدارته |
| Google Keep | إدارة الملاحظات والقوائم والمرفقات |
| Google Meet | جدولة مكالمات الفيديو وإدارتها |
| جهات الاتصال | مزامنة جهات الاتصال وإدارتها |
| جداول بيانات Google | قراءة بيانات جدول البيانات وكتابتها وتنسيقها |
| العروض التقديمية من Google | إنشاء العروض التقديمية وتعديلها |
| مهام Google | إنشاء المهام وإدارتها وتنظيمها |
المصادقة والأذونات
بصفتك منشئ التطبيق، لست بحاجة إلى ضبط عملاء OAuth أو إدارة بيانات الاعتماد أو إعداد مشروع على السحابة الإلكترونية من Google. يتولّى AI Studio كل ذلك نيابةً عنك.
تستخدم التطبيقات التي تتضمّن واجهات برمجة تطبيقات Workspace ميزة "تسجيل الدخول باستخدام حساب Google" لمصادقة المستخدمين النهائيين. عندما يفتح المستخدم تطبيقك، يُطلب منه تسجيل الدخول ومنح الأذونات المحدّدة التي يحتاجها تطبيقك (على سبيل المثال، الوصول للقراءة فقط إلى تقويمه أو إمكانية تعديل جدول بيانات). لا يصل تطبيقك إلا إلى بيانات الشخص الذي يستخدمه. يمنح كل مستخدم الإذن بالوصول إلى حسابه.
أمثلة على الطلبات
في ما يلي بعض الأفكار للبدء باستخدام عمليات التكامل مع Workspace:
- "أنشئ تطبيقًا يقرأ تقويم Google ويُنشئ مسودات رسائل إلكترونية تحضيرية في Gmail لكل اجتماع."
- "أنشئ أداة تأخذ مستند Google وتُنشئ عرضًا تقديميًا ملخّصًا من 5 شرائح في "العروض التقديمية من Google"."
- "أنشئ أداة لتتبُّع النفقات، حيث يمكنني تحميل إيصال، ويستخرج Gemini التفاصيل، ويسجِّل صفًا جديدًا في "جدول بيانات Google"."
إعداد OAuth
إحدى حالات الاستخدام الرئيسية لإدارة الأسرار هي إعداد OAuth للربط بمواقع إلكترونية أو تطبيقات أخرى. عندما يتضمّن طلبك تعليمات حول الربط بتطبيق خارجي يتطلّب مصادقة OAuth، سيقدّم Agent تعليمات حول كيفية إعداد OAuth لهذا التطبيق. ستتضمّن هذه التعليمات عناوين URL الضرورية لردّ الاتصال لضبط تطبيق OAuth. يمكنك أيضًا العثور على عناوين URL لردّ الاتصال ضِمن عمليات التكامل في لوحة "الإعدادات".
إنشاء تجارب متعددة اللاعبين
يتيح وقت التشغيل المتكامل ميزات التعاون في الوقت الفعلي.
- الحالة في الوقت الفعلي: يمكنك أن تطلب من الوكيل إنشاء ميزات مثل "محادثة مباشرة" أو "لوحة بيضاء تعاونية" أو "لعبة متعددة اللاعبين".
- الجلسات المتزامنة: يدير الخادم الحالة، ما يسمح لعدة مستخدمين بالتفاعل مع مثيل التطبيق نفسه في الوقت الفعلي.
مثال على الطلب: > "اجعل هذه اللعبة متعددة اللاعبين حيث يمكن للاعبين رؤية مؤشرات بعضهم البعض."
نصائح لاختبار التطبيقات متعددة اللاعبين
يمكنك اختبار وضع اللعب المتعدد بطريقتَين قبل نشر تطبيقك.
- افتح تطبيقك في وضع "الإنشاء" في Google AI Studio في علامات تبويب متعددة. عند التطوير في وضع "الإنشاء"، يكون تطبيقك في حاوية تطوير. سيسمح لك فتح التطبيق في علامات تبويب متعددة بمحاكاة عدة لاعبين يستخدمون تطبيقك.
- شارك التطبيق مع مستخدمين آخرين باستخدام قائمة مشاركة في أعلى يسار الشاشة، ثم استخدِم عنوان URL الذي تمت مشاركته من علامة التبويب عمليات التكامل في قائمة مشاركة لاستخدام التطبيق مع اللاعبين الذين شاركت تطبيقك معهم.
أفضل الممارسات
- طلبات Gemini API: يتم ضبط
GEMINI_API_KEYتلقائيًا كسر من جهة الخادم. يمكنك إجراء طلبات Gemini API من الرمز من جهة الخادم باستخدام هذا المفتاح. يمكنك عرضه في لوحة الأسرار. - أمان الأسرار: استخدِم دائمًا مدير الأسرار للمفاتيح الحسّاسة. لا تضعها مطلقًا في الرمز البرمجي لملفاتك.
- فصل الاهتمامات: احتفِظ بمنطق واجهة المستخدم في إطار عمل من جهة العميل (React/Angular) ومنطق النشاط التجاري/معالجة البيانات من جهة الخادم.
- معالجة الأخطاء: تأكَّد من أنّ الرمز من جهة الخادم يعالج الأخطاء بشكل فعّال من طلبات واجهة برمجة التطبيقات الخارجية لمنع تعطُّل التطبيق.