الانتقال إلى المحتوى الرئيسي
شغّل واجهة سطر أوامر بلغة Python تعتمد على المكتبة القياسية فقط وتستدعي نقاط نهاية Phaseo أمرًا تلو الآخر. في النهاية يعمل لديك python quickstart.py <command> لكلٍّ من الصحة والنماذج وResponses وChat Completions، إضافةً إلى أوامر للتضمينات والإشراف والصور وOCR والفيديو والموسيقى يمكنك نسخها إلى عامل أو خدمة خلفية. واجهة سطر الأوامر توضيحية: هي مرجع لأشكال الطلبات، وليست أداة مُحزَّمة. عدد من معرّفات النماذج الافتراضية لأوامر الوسائط لم يعد متاحًا، لذا مرّر --model لهذه الأوامر (راجع اختر نماذج لأوامر الوسائط). لتجعل وكيل برمجة ينشئ واجهة سطر أوامر مشابهة من الصفر، الصق هذه المطالبة:

أنشئ واجهة سطر أوامر للـ Gateway باستخدام Python حول مسارات Phaseo.

فتح في Cursor

ما الذي تفعله واجهة سطر الأوامر

العينة هي examples/gateway-python-quickstart: ملف واحد هو quickstart.py، يستخدم فقط urllib وjson وargparse. يُعاد كل طلب مرتين عند 429 و5xx وأخطاء الشبكة، بانتظار ثانية واحدة ثم ثانيتين، وتنتهي مهلته بعد 45 ثانية. يخرج كل أمر بالرمز 1 عندما لا يكون الاستدعاء 2xx، لذا يمكنك استخدامه في السكربتات.

شغّلها

تحتاج إلى Python 3 ومفتاح Phaseo API.
1

أنشئ .env.local

يقرأ السكربت .env.local من المجلد الذي تشغّله منه. لا تحتوي العينة على .env.example، لذا أنشئ الملف:
.env.local
المتغيرات المعيّنة مسبقًا في الطرفية لها الأولوية على الملف. بدون PHASEO_MODEL تستخدم الأوامر النصية openai/gpt-5.6-sol.
2

شغّل الفحص الأولي

يرسل smoke أيضًا طلب Responses قصيرًا واحدًا، لذا يستهلك بعض الأرصدة.
3

أرسل طلبًا واحدًا

تحقّق من نجاحها

  • يطبع smoke القيمة HTTP 200 لكل كتلة ويخرج بالرمز 0.
  • يحتوي ناتج الأمر responses على integration_ok.
  • يعرض --help الأوامر دون إرسال أي طلب.
  • بدون مفتاح، يطبع السكربت Missing PHASEO_API_KEY ويخرج بالرمز 1.
  • تظهر الطلبات في الإعدادات → الاستخدام → السجلات.

اختر نماذج لأوامر الوسائط

هذه القيم الافتراضية في quickstart.py متقاعدة أو ليس لها مزوّد نشط. مرّر نموذجًا حاليًا باستخدام --model، واختره من صفحة النماذج أو من python quickstart.py models: القيمتان الافتراضيتان لـ embeddings (google/gemini-embedding-2) وimage (openai/gpt-image-2) متاحتان. مهام الفيديو والموسيقى غير متزامنة: احفظ المعرّف المُعاد واستعلم بأمر الحالة؛ يشرح الفيديو غير المتزامن والدفعات دورة حياة المهمة. اختصر الملف ليقتصر على الأوامر التي تحتاجها خدمتك، واحتفظ بالدالة المساعدة المشتركة الوحيدة gateway_request()، وانتقل إلى Python SDK عندما تريد طلبات ذات أنواع محددة.
آخر تعديل في ٥ نوفمبر ٢٠٢٦