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

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

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

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

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

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

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

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

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

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

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

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

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

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

الأسعار

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

الحدود

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

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

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

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