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

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

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

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

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

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

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

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

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

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

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

للاطّلاع على أنواع بيانات الاعتماد وعمليات الإدارة، يُرجى الانتقال إلى بيانات الاعتماد. يمكنك أيضًا ضبط العناوين المضمّنة في قاعدة قائمة السماح، راجِع إعدادات الشبكة.

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

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

الأسعار

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

الحدود

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

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

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