توفّر ساحة لعب Google AI Studio واجهة مرئية لإنشاء نماذج أولية ومعرفة كيفية إنشاء وكلاء مُدارين بدون الحاجة إلى إنشاء طلبات من واجهة برمجة التطبيقات وكتابتها.
للبدء، انتقِل إلى علامة التبويب ساحة اللعب في لوحة التنقّل في Google AI Studio، وغيِّر مفتاح التبديل إلى الوكلاء.
نماذج مُنشأة مسبقًا
تحتوي علامة التبويب الوكلاء على سلسلة من النماذج التي تُعدّ مسبقًا "الوكيل الأساسي" من خلال ضبط إعدادات الأدوات والبيئة. جميع النماذج مفتوحة المصدر ومنشورة ضِمن مستودع google-gemini/gemini-managed-agents-templates. إنّ استكشاف هذه النماذج طريقة رائعة لمعرفة كيفية إنشاء وكيل مُدار خاص بك وتنظيمه.
على سبيل المثال، عند اختيار نموذج "البرنامج الإذاعي بالذكاء الاصطناعي"، يتم تفعيل جميع الأدوات المسموح بها، ويتم ربط ملف AGENTS.md متخصص ومهارات لإنتاج البرامج الإذاعية. يمكنك الاطّلاع على هذه الإعدادات في واجهة مستخدم "ساحة اللعب" ضِمن قسم البيئة من خلال النقر على الزر المصادر.
إعدادات الأدوات
ضِمن إعدادات الوكيل في "ساحة اللعب"، يمكنك تفعيل الوصول إلى الأدوات المضمّنة التالية أو إيقافه:
- بحث Google: يمكنك الوصول إلى الويب المفتوح للحصول على معلومات في الوقت الفعلي.
- سياق عنوان URL: يمكنك جلب المحتوى النصي لعناوين URL لصفحات ويب معيّنة وتحليله.
- تنفيذ الرموز البرمجية: يمكنك تشغيل أوامر Bash وPython مباشرةً ضِمن بيئة الحماية المعزولة.
- أدوات نظام الملفات: يمكنك قراءة الملفات وكتابتها وعرضها وحذفها داخل مساحة العمل.
إعدادات البيئة
تعمل الوكلاء المُدارون ضِمن بيئة حماية آمنة ومؤقتة على Linux (البيئة) توفّر مساحة العمل والأدوات التي يحتاجون إليها للتشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على دليل بيئة الوكيل المُدار .
التحكّم في سلوك الوكيل
يتم تحديد سلوك الوكيل وشخصيته وقدراته بشكل أساسي من خلال الملفات المتوفّرة في بيئته. يرصد الوكيل الإعدادات ويحمّلها تلقائيًا من مجلد خاص باسم .agents:
AGENTS.md: يتم تحميله مسبقًا في سياق الوكيل لتحديد تعليمات النظام وشخصيته.SKILL.md: يقع ضِمن مجلدات المهارات المعنيّة (مثل.agents/skills/my-skill/SKILL.md) لتحديد قدرات وسير عمل معيّنين.
توفير البيئة
يمكنك ضبط البيئة التي سيستخدمها الوكيل من خلال ربط الملفات بالبيئة قبل بدء الجلسة. يمكنك إنشاء بيئة جديدة من خلال ربط المصادر، أو استعادة بيئة سابقة:
- لإنشاء بيئة جديدة، انقر على إضافة مصادر في لوحة إعدادات البيئة واختَر من بين أنواع المصادر التالية:
| نوع المصدر | الوصف | مسار الربط |
|---|---|---|
| الملفات المضمّنة | يمكنك كتابة ملفات الإعدادات أو لصقها أو مجموعات البيانات التجريبية أو النصوص البرمجية للأدوات المساعدة (بحد أقصى 100 كيلوبايت) مباشرةً في واجهة مستخدم "ساحة اللعب". | مسار الوجهة الذي يحدّده المستخدم (مثل /workspace/scripts/parser.py) |
| Google Cloud Storage | يمكنك ربط حزمة علنية أو خاصة على Cloud Storage. تتطلب الحزم الخاصة رمزًا مميزًا عاديًا من نوع OAuth 2.0 Bearer. لمزيد من المعلومات، يُرجى الاطّلاع على المصادر الخاصة. |
يربط مسار حزمة GCS (مثل gs://your-bucket-name/data/) بدليل مساحة العمل (مثل /workspace/data/) |
| مستودعات GitHub | يمكنك استنساخ قواعد بيانات علنية أو خاصة. تتطلب المستودعات الخاصة مصادقة أساسية باستخدام رمز الوصول الشخصي (PAT) على GitHub. لمزيد من المعلومات، يُرجى الاطّلاع على المصادر الخاصة. |
يتم استنساخها مباشرةً في /workspace/ (عادةً ضِمن /workspace/<repo-name>). |
- لاستعادة بيئة سابقة، يمكنك إعادة استخدام معرّف بيئة حالي لاستنساخ حالتها الدقيقة وإنشاء نسخة منها.
إعادة استخدام معرّف بيئة حالي
إذا سبق لك قضاء بعض الوقت في إعداد بيئة حماية، لن تحتاج إلى البدء من جديد. لاستخدام بيئة حالية:
- انتقِل إلى لوحة "البيئات" في AI Studio وغيِّر النوع إلى الحالية.
- أدخِل معرّف البيئة (مثل
env_abc123)
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد بيئة. يمكنك أيضًا استرداد معرّف البيئة للجلسة الحالية من علامة التبويب "البيئة" في واجهة المستخدم.
بعد إرسال أول رسالة إلى الوكيل، يصبح إعداد البيئة ثابتًا لتلك الجلسة. لا يمكنك ربط مصادر جديدة أو تعديل القائمة المسموح بها للشبكة أثناء تشغيل التفاعل بنشاط.
تنزيل البيئة
بعد إنشاء بيئة، يمكنك تنزيل لقطة البيئة في أي وقت باستخدام الزر تنزيل في إعدادات البيئة في "ساحة لعب AI Studio" لاسترداد ملفات البيئة كملف tarball.
الأمان وإدارة التكاليف
إدارة استهلاك الرموز المميّزة
على عكس طلب محادثة عادي ينتج عنه رد واحد، يُنفّذ وكيل Antigravity سير عمل تلقائيًا. يخطّط الوكيل وينفّذ الرموز البرمجية ويراقب النتائج ويُجري عمليات تكرار. وهذا يعني أنّ طلبًا واحدًا يمكن أن يؤدي إلى استهلاك غير محدود للرموز المميّزة.
لإدارة التكاليف، قدِّم معايير إنهاء واضحة في طلباتك وحدِّد نطاق المهام بدقة للوكيل. يمكن أن يكون مثالاً جيدًا على ذلك طلبًا مثل راجِع طلب سحب التغييرات وتوقّف بعد إنشاء ملخّص بتنسيق Markdown. لا تحاول كتابة الإصلاح بنفسك.
التكاليف الإضافية
تلقائيًا، يمكن لجميع نماذج الوكلاء في "ساحة اللعب" الوصول إلى خدمة Gemini API وإجراء طلبات من واجهة برمجة التطبيقات من البيئة لتلبية الطلبات. قد يؤدي ذلك إلى تكاليف إضافية لن تظهر في استهلاك الرموز المميّزة.
وبالمثل، إذا أضفت خدمات خارجية أخرى، قد يتحمّل الوكيل تكاليف إضافية من خلال استدعاء هذه الخدمات نيابةً عنك.
القائمة المسموح بها للشبكة
تلقائيًا، في AI Studio، يتم التحكّم بإحكام في جميع طلبات الشبكة الصادرة من بيئة الحماية الخاصة بالوكيل ويتم حصرها لضمان الأمان. لمنح الوكيل إمكانية الوصول إلى واجهات برمجة التطبيقات الخارجية أو خدمات الويب أو مديري الحِزم، عليك الإعلان عنها صراحةً:
- انتقِل إلى لوحة "البيئات" في AI Studio.
- انقر على الزر القواعد بجانب الشبكة.
- في لوحة إعدادات الشبكة ، انقر على الإضافة إلى القائمة المسموح بها وأدخِل التفاصيل ذات الصلة:
- قيود النطاق: لا يمكن للجهاز الافتراضي للوكيل الوصول إلا إلى النطاقات المحدّدة أو الأنماط العامة التي تمت إضافتها إلى القائمة. على سبيل المثال، يمكنك إدخال نطاقات دقيقة مثل
api.github.comأو أنماط عامة مثل*.googleapis.com. - إضافة عنوان HTTP ورمز مميّز: استخدِم الخيار إضافة عنوان HTTP لإدخال بيانات الاعتماد المطلوبة بأمان (مثل رمز مميّز لواجهة برمجة التطبيقات) لنطاق معيّن. تمر بيانات الاعتماد هذه بأمان من خلال وكيل الخروج ولا يتم عرضها مطلقًا مباشرةً كنص عادي داخل بيئة الحماية الخاصة بالوكيل.
- قيود النطاق: لا يمكن للجهاز الافتراضي للوكيل الوصول إلا إلى النطاقات المحدّدة أو الأنماط العامة التي تمت إضافتها إلى القائمة. على سبيل المثال، يمكنك إدخال نطاقات دقيقة مثل
يُرجى توخي الحذر دائمًا عند إضافة نطاقات إلى القائمة المسموح بها. إنّ منح الوكيل إمكانية الوصول إلى الخدمات التي تتطلب المصادقة يعني أنّه يمكنه التصرّف نيابةً عنك، ما قد يؤدي إلى إجراءات غير مقصودة إذا لم تتم مراقبته بعناية.
أفضل الممارسات المتعلّقة ببيانات الاعتماد
إذا كان سير عملك يتطلب من الوكيل المصادقة باستخدام خدمات خارجية، أنت مسؤول عن توفير بيانات الاعتماد هذه وتحديد نطاقها. اتّبِع هذه الإرشادات لتقليل المخاطر:
- استخدِم بيانات اعتماد بأقل الامتيازات: أنشئ حسابات خدمة أو مفاتيح واجهة برمجة تطبيقات لا تتضمّن سوى الأذونات التي يحتاج إليها الوكيل. تجنَّب تمرير بيانات الاعتماد التي تمنح وصولاً واسع النطاق أو وصولاً إداريًا.
- استخدِم الرموز المميّزة القصيرة الأجل: استخدِم بيانات الاعتماد أو الرموز المميّزة التي تنتهي صلاحيتها بعد فترة زمنية محدّدة بدلاً من مفاتيح واجهة برمجة التطبيقات الطويلة الأجل، إذا أمكن ذلك.
- افترِض الوصول الكامل: قد يستخدم الوكيل أي بيانات اعتماد يمكنه الوصول إليها لإكمال المهمة التي أوكلتها إليه. لا تقدّم إلا بيانات الاعتماد التي أنت على استعداد لمنح نطاق الوصول الكامل إليها.
- غيِّر بيانات الاعتماد بانتظام: تعامَل مع بيانات الاعتماد التي تتم مشاركتها مع الوكيل بالطريقة نفسها التي تتعامل بها مع أي بيانات اعتماد برمجية، أي غيِّرها بانتظام.
ربط الأدوات الخارجية وواجهات برمجة التطبيقات
يمكنك ربط الأدوات الخارجية وواجهات برمجة التطبيقات (مثل خوادم بروتوكول سياق النموذج / MCP) لتوسيع إمكانات الوكيل. عند إجراء ذلك:
- لا تربط إلا الأدوات من المصادر التي تثق بها. يمكن أن تكشف أداة ضارة أو مكتوبة بشكل سيئ عن البيانات أو تنفّذ إجراءات غير مقصودة.
- اضبط الأدوات بأقل الأذونات المطلوبة لحالة الاستخدام. إذا كانت الأداة تتيح وضع القراءة فقط، استخدِم هذا الوضع ما لم تكن عمليات الكتابة ضرورية للغاية.
- قبل ربط أداة بمصدر بيانات الإنتاج، اختبِرها باستخدام بيانات نموذجية أو بيانات اصطناعية للتأكّد من أنّ الوكيل يستخدمها على النحو المتوقّع.
الإشراف البشري
يمكن للوكلاء الاستدلال والتخطيط وتنفيذ مهام سير العمل المتعدّدة الخطوات بدرجة عالية من الاستقلالية. على الرغم من أنّ هذه الإمكانية قوية، إلا أنّها تعني أيضًا أنّه عليك تطبيق إشراف مناسب، خاصةً للمهام التي تعدِّل البيانات أو تتفاعل مع الأنظمة الخارجية.
تحقَّق دائمًا من النتائج المهمة، مثل الرموز البرمجية التي تم إنشاؤها أو عمليات تحويل البيانات أو تغييرات الإعدادات قبل نشرها.