> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# إنشاء واجهة سطر أوامر لبوابة Python

> استخدم مثال البدء السريع لـ Python كشرح عملي متكامل لإنشاء واجهة سطر أوامر أو تكامل خلفي يعتمد على Python.

استخدم هذه الصفحة إذا كان أول تكامل فعلي لك مع Phaseo مبنيًا بـ Python وتحتاج إلى نقطة انطلاق عملية لواجهة سطر أوامر أو عامل أو خدمة خلفية.

**الهدف:** تشغيل مسارات التحكم والتوليد في Phaseo من تطبيق صغير لسطر الأوامر مكتوب بـ Python.

**النتيجة:** واجهة سطر أوامر قليلة الاعتماديات يمكنك تكييفها لتصبح عاملًا أو نصًا برمجيًا أو تكاملًا خلفيًا.

<Prompt description="أنشئ **واجهة سطر أوامر لبوابة Python** لتشغيل مسارات Phaseo." icon="terminal-square" actions={["copy", "cursor"]}>
  {`أنت تطوّر أداة سطر أوامر بلغة Python أو تكاملًا على جانب الخادم لـ Phaseo Gateway.

    أنشئ تطبيقًا صغيرًا بلغة Python يقوم بما يلي:
    - قراءة PHASEO_API_KEY من متغيرات البيئة
    - توفير وضع اختبار سريع لمسار التحكم
    - توفير أمر واحد لتوليد النص
    - تقليل التبعيات إلى الحد الأدنى

    المتطلبات:
    - فضّل مكتبة Python القياسية ما لم يوجد سبب وجيه لعدم استخدامها.
    - اجعل محتوى الطلبات واضحًا.
    - اعرض رسائل واضحة للنجاح والإخفاق.
    - أضف أمرًا أو أمرين مفيدين بدلًا من أداة سطر أوامر عامة ضخمة.
    - أضف ملف README موجزًا يتضمن أمثلة.

    المخرجات المطلوبة:
    - شيفرة تطبيق Python
    - أوامر استخدام بسيطة
    - ملف .env.example أو توثيق مكافئ لمتغيرات البيئة

    التحقق:
    - شغّل اختبارًا سريعًا للمسار إن أمكن.
    - نفّذ عملية ناجحة واحدة لتوليد النص إن أمكن.
    - اذكر بدقة ما تحققت منه وما لم يتم التحقق منه بعد.`}
</Prompt>

## مشروع نموذجي

* GitHub: [examples/gateway-python-quickstart](https://github.com/phaseoteam/Phaseo/tree/main/examples/gateway-python-quickstart)
* المسار المحلي في المستودع: `examples/gateway-python-quickstart`

## وظائف هذا التطبيق

* يدعم مسارات التحكم مثل:
  * `GET /v1/health`
  * `GET /v1/models`
  * `GET /v1/providers`
* يدعم مسارات التوليد مثل:
  * `POST /v1/responses`
  * `POST /v1/chat/completions`
  * `POST /v1/embeddings`
  * وعدة نقاط نهاية إضافية

## فائدة هذا المثال

يوفر لك:

* مرجعًا يعتمد على Python دون اعتماديات خارجية
* حمولات طلبات ومعالجة استجابات واضحة
* نمطًا عمليًا للعوامل والنصوص البرمجية والأدوات الداخلية

## المتطلبات الأساسية

* Python 3
* مفتاح API من Phaseo

## تشغيل المثال

```bash theme={null}
cd examples/gateway-python-quickstart
cp .env.example .env.local
```

عيّن:

* `PHASEO_API_KEY`

ثم جرّب:

```bash theme={null}
python quickstart.py smoke
python quickstart.py responses --prompt "Return exactly: integration_ok"
python quickstart.py --help
```

## التحقق من عملك

* يؤكد وضع الاختبار السريع إمكانية الوصول إلى API.
* يطبع أمر Responses القيمة `integration_ok`.
* يعرض `--help` الأوامر المتاحة دون إرسال طلب.
* تظهر أخطاء المصادقة وAPI بوضوح في الطرفية.

## ما ينبغي مراجعته في الشيفرة

* طريقة تحميل متغيرات البيئة
* كيفية توزيع الأوامر في واجهة سطر الأوامر
* طريقة إنشاء حمولات الطلبات المختلفة
* كيفية معالجة مسارات الفيديو والموسيقى غير المتزامنة بصورة منفصلة عن مسارات النص ذات الاستجابة الواحدة

## تكييف المثال لاحتياجاتك

* احذف نقاط النهاية التي لا تحتاج إليها خدمتك
* استخدم دالة مساعدة مشتركة للطلبات بدل تكرار الترويسات في كل موضع
* انتقل لاحقًا إلى Python SDK إذا احتجت إلى عميل بمستوى تجريد أعلى

## أدلة ذات صلة

* [مطالبات بدء التطبيقات المصغّرة](./mini-app-starter-prompts.mdx)
* [إخراج JSON منظّم من Python](./sdk-python-presets-and-json.mdx)
* [أمثلة](../guides/examples.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.