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