نظرة عامة على الوكلاء

تمنحك الوكلاء المُدارون على Gemini API أداة قابلة للضبط. يؤدي طلب واحد من واجهة برمجة التطبيقات إلى توفير وضع حماية على Linux حيث يحلّل الوكيل ويُنفّذ الرموز البرمجية ويدير الملفات ويتصفّح الويب بشكل مستقل.

الوكلاء المُدارون المتاحون

  • وكيل Antigravity: وكيل مُدار للأغراض العامة يستند إلى Gemini 3.6 Flash. يُنفّذ الرموز البرمجية ويدير الملفات ويبحث في الويب داخل وضع حماية آمن على Linux تستضيفه Google. يمكنك ضبط النموذج الأساسي (مثل Gemini 3.6 Flash أو Gemini 3.5 Flash أو Gemini 3.5 Flash-Lite) باستخدام agent_config، وتوسيعه باستخدام التعليمات والمهارات والبيانات الخاصة بك لـ إنشاء وكيل مخصّص.
  • Deep Research: وكيل بحث مستقل يخطّط وينفّذ ويُجمّع مهام البحث المتعددة الخطوات لحالات استخدام مثل تحليل السوق والتحقّق من سلامة الإجراءات ومراجعات الأدبيات.

الأمان وأفضل الممارسات

يتم تشغيل كل وكيل في بيئة وضع حماية معزولة على مستوى نظام التشغيل. يتم منح وضع الحماية إذن وصول غير مقيّد إلى الشبكة الصادرة تلقائيًا. يمكنك تقييد الوصول إلى الشبكة أو إيقافه باستخدام قائمة السماح.

الوصول إلى الشبكة

تتضمّن البيئات تلقائيًا إذن وصول غير مقيّد إلى الشبكة الصادرة. استخدِم قائمة السماح network لتقييد حركة المرور الصادرة إلى نطاقات محدّدة أو أنماط أحرف بدل. لمعرفة تفاصيل الإعداد، يُرجى الاطّلاع على قائمة السماح بالشبكة (AI Studio) أو قواعد الشبكة (واجهة برمجة التطبيقات).

الأدوات وواجهات برمجة التطبيقات الخارجية

يمكنك ربط الأدوات وواجهات برمجة التطبيقات الخارجية لتوسيع نطاق الوكيل. استخدِم الأدوات من مصادر موثوقة فقط، واضبط الأذونات على الحد الأدنى المطلوب. يمكن إدخال بيانات الاعتماد بشكل آمن من خلال عمليات تحويل رؤوس الخادم الوكيل الصادر ولا يتم عرضها مطلقًا داخل وضع الحماية. قد يستخدم الوكيل أي بيانات اعتماد يمكنه الوصول إليها، لذا لا تقدّم إلا بيانات الاعتماد التي تريد منح نطاقها الكامل.

  • استخدِم حسابات الخدمة أو مفاتيح واجهة برمجة التطبيقات التي تتضمّن أقل عدد من الأذونات.
  • فضِّل الرموز المميزة القصيرة الأجل على المفاتيح الطويلة الأجل.
  • لا تقدّم إلا بيانات الاعتماد التي تريد منح نطاقها الكامل.
  • غيِّر بيانات الاعتماد وفقًا لجدول زمني منتظم.

لمعرفة تفاصيل ضبط عمليات تحويل الرؤوس، يُرجى الاطّلاع على بيانات الاعتماد.

الإشراف البشري

يُرجى دائمًا التحقّق من النتائج (الرموز البرمجية التي تم إنشاؤها وعمليات تحويل البيانات والتغييرات في الإعدادات) قبل نشرها، خاصةً بالنسبة إلى المهام التي تعدِّل البيانات أو تتفاعل مع الأنظمة الخارجية.

الأسعار

يستخدم الوكلاء المُدارون نموذج الدفع حسب الاستخدام استنادًا إلى رموز نموذج Gemini واستخدام الأدوات. يمكن أن يؤدي تفاعل واحد إلى تشغيل حلقات تحليل متعددة، ما يؤدي عادةً إلى استهلاك ما بين 100 ألف و3 ملايين رمز مميّز. لا يتم تحصيل رسوم مقابل حوسبة البيئة خلال فترة المعاينة. يمكنك الاطّلاع على التكاليف المقدّرة لكل عملية تفصيلية حسب المهمة. تتوفّر أيضًا الوكلاء المُدارون في المستوى المجاني مع حدّ مجاني لمعدّل الاستخدام وحصة استخدام.

الحدود

الحدّ الوصف
الفترة منذ إنشاء البيئة يتم حذف البيئات نهائيًا بعد 7 أيام من عدم النشاط.
إيقاف الجهاز الظاهري يتم إيقاف الأجهزة الظاهرية بعد فترة وجيزة من عدم النشاط للحفاظ على الموارد. يؤدي الطلب التالي إلى استعادة الحالة (مع بدء التشغيل البارد).
البرامج المثبَّتة مسبقًا بيئة مستندة إلى Ubuntu مع Python 3.12 وNode.js 22 لمزيد من المعلومات حول الصورة الأساسية للبيئة، يُرجى الاطّلاع على البرامج المثبَّتة مسبقًا.
الحد الأقصى لعدد الوكلاء يمكنك استخدام ما يصل إلى 1,000 وكيل مُدار.

أطر عمل الوكلاء

يمكنك أيضًا إنشاء وكلاء باستخدام Gemini باستخدام أطر العمل وحِزم SDK التالية:

  • LangChain / LangGraph: يمكنك إنشاء تدفقات تطبيقات معقدة ومستندة إلى الحالة وأنظمة متعددة الوكلاء باستخدام هياكل الرسم البياني.
  • LlamaIndex: يمكنك ربط وكلاء Gemini بـ بياناتك الخاصة للحصول على مهام سير عمل محسّنة باستخدام RAG.
  • CrewAI
  • Vercel AI SDK: يمكنك إنشاء واجهات مستخدم ووكلاء مستندين إلى الذكاء الاصطناعي في JavaScript/TypeScript.
  • **Google ADK**: إطار عمل مفتوح المصدر لإنشاء وكلاء ذكاء اصطناعي قابلين للتشغيل المتبادل وتنظيمهم
  • Antigravity SDK: يمكنك إنشاء وكلاء ذكاء اصطناعي مستقلين باستخدام الأدوات نفسها وحلقة الوكيل وإدارة السياق التي تستند إليها Google Antigravity، والتي يمكن برمجتها بلغة Python.