Skip to main content
هذا الدليل مخصص للفرق التي تنشئ أدوات داخلية أو واجهات سطر أوامر أو تدفقات عمل لوكلاء البرمجة باستخدام SDKs الخاصة بـ Gateway.
إذا أردت نقطة بداية قابلة لإعادة الاستخدام بدل كتابة كل مهارة من الصفر، فثبّت مهارات Phaseo العامة من phaseoteam/skills:
ثم احتفظ بالتعليمات الخاصة بالمشروع في ملف SKILL.md المحلي.
الفكرة الأساسية بسيطة:
  • احتفظ بإعداد SDK داخل المستودع
  • أضف ملف SKILL.md يوضح للوكيل الطريقة التي يتوقع المشروع إرسال الطلبات بها
  • وجّه الوكيل إلى هذا الملف أثناء الإعداد حتى تظل أنماط الطلبات متسقة

1. تثبيت SDK

إذا كنت تستخدم TypeScript أو JavaScript:
إذا كنت تستخدم Python:

2. إضافة ملف مهارة خاص بالمشروع

أنشئ SKILL.md في جذر المستودع أو في موقع مهارات الوكلاء الذي يستخدمه فريقك.

3. إبقاء التكامل الأول صغيرًا

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

4. ما ينبغي أن توضحه المهارة

ينبغي أن يجيب ملف SKILL.md عن الأسئلة التي تهدر معظم وقت الوكيل:
  • عائلة نقاط النهاية التي ينبغي تفضيلها
  • متغير البيئة الذي يحتوي على بيانات الاعتماد
  • معرّفات النماذج أو معرّفات الإعدادات المسبقة المعتمدة
  • طريقة تسجيل معرّفات الطلبات
  • طريقة تتبع المهام غير المتزامنة

5. نمط المستودع الموصى به

  • وحدة مشتركة لمساعدات SDK
  • ملف SKILL.md بجوار كود التكامل أو في جذر المستودع
  • مثال قصير لكل نقطة نهاية رئيسية
  • ملاحظة عن تسجيل الطلبات ومعالجة الأخطاء
يوفر ذلك للبشر ووكلاء البرمجة نقطة دخول تشغيلية واحدة.

أدلة ذات صلة

آخر تعديل في ٢ أكتوبر ٢٠٢٦