توفّر ساحة لعب Google AI Studio واجهة مرئية لإنشاء نماذج أولية من الوكلاء المُدارين وتعلُّم كيفية إنشائهم بدون الحاجة إلى إنشاء طلبات بيانات من واجهة برمجة التطبيقات وكتابتها.
للبدء، انتقِل إلى علامة التبويب ساحة اللعب في لوحة التنقّل في Google AI Studio، وفعِّل خيار الوكلاء.
نماذج مُنشأة مسبقًا
تتضمّن علامة التبويب الوكلاء سلسلة من النماذج التي تُعدّ مسبقًا إعدادات "وكيل Antigravity" الأساسي من خلال ضبط إعدادات الأدوات والبيئة. جميع النماذج مفتوحة المصدر ومنشورة ضمن مستودع 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) لتوسيع إمكانات الوكيل. عند إجراء ذلك:
- لا تربط سوى الأدوات من المصادر التي تثق بها. يمكن أن تكشف أداة ضارة أو مكتوبة بشكل سيئ عن البيانات أو تنفّذ إجراءات غير مقصودة.
- اضبط الأدوات بأقل الأذونات المطلوبة لحالة الاستخدام. إذا كانت إحدى الأدوات تتيح وضع القراءة فقط، استخدِم هذا الوضع ما لم تكن عمليات الكتابة ضرورية للغاية.
- قبل ربط أداة بمصدر بيانات إنتاج، اختبِرها على بيانات نموذجية أو بيانات اصطناعية للتأكّد من أنّ الوكيل يستخدمها على النحو المتوقّع.
الإشراف البشري
يمكن للوكلاء الاستنتاج والتخطيط وتنفيذ مهام سير العمل المتعدّدة الخطوات بقدر كبير من الاستقلالية. على الرغم من أنّ هذه الإمكانية قوية، إلا أنّها تعني أيضًا أنّه عليك تطبيق إشراف مناسب، خاصةً للمهام التي تعدِّل البيانات أو تتفاعل مع الأنظمة الخارجية.
تحقَّق دائمًا من النتائج المهمة، مثل التعليمات البرمجية التي تم إنشاؤها أو عمليات تحويل البيانات أو تغييرات الإعدادات قبل نشرها.