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