> ## 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.

# موجّهات بدء التطبيقات المصغرة

> موجّهات قابلة للنسخ تساعد وكلاء البرمجة على إنشاء تطبيقات Phaseo صغيرة باستخدام HTTP الخام أو SDK أو بيئات تشغيل الوكلاء.

استخدم هذه الصفحة عندما تريد تزويد وكيل برمجة بموجّه واضح ينشئ تطبيقًا صغيرًا يعمل بدلًا من خطة تكامل مبهمة.

<Tip>
  صيغت هذه الموجّهات للتركيز على النتائج وتحديد تفاصيل التنفيذ كي تعمل بشكل أفضل في Cursor وClaude Code وCodex والأدوات المشابهة.
</Tip>

## كيفية استخدام هذه الموجّهات

<Steps>
  <Step title="اختر واجهة التكامل">
    اختر الموجّه الذي يناسب طريقة استدعاء التطبيق لـPhaseo:

    * HTTP الخام
    * SDK رسمي واحد
    * Vercel AI SDK
    * SDK الوكلاء
  </Step>

  <Step title="استبدل المتغيرات بين الأقواس المعقوفة">
    املأ قيمًا مثل `[فكرة التطبيق]` و`[إطار العمل]` و`[النموذج]` و`[LANGUAGE]` قبل لصق الموجّه في وكيل البرمجة.
  </Step>

  <Step title="اطلب التحقق، لا الرمز فقط">
    أبقِ أسطر التحقق في الموجّه، فهي تلزم الوكيل بذكر ما نفذه فعليًا وما افترضه وما يتطلب إعدادًا يدويًا.
  </Step>
</Steps>

## حزم الموجّهات

<AccordionGroup>
  <Accordion title="تطبيق مصغر باستخدام HTTP الخام" icon="globe">
    <Prompt description="أنشئ تطبيقًا صغيرًا يستخدم **HTTP الخام** مع Phaseo بدلًا من SDK." icon="globe" actions={["copy", "cursor"]}>
      {`أنت تنفذ تطبيقًا تجريبيًا صغيرًا بطابع إنتاجي باستخدام Phaseo Gateway.

            أنشئ تطبيقًا مصغرًا باستخدام [إطار العمل] لفكرة [فكرة التطبيق].

            المتطلبات:
            - استخدم طلبات HTTP الخام، وليس SDK من Phaseo.
            - استخدم نقطة نهاية Phaseo [ENDPOINT].
            - استخدم النموذج [النموذج].
            - اقرأ مفتاح API من متغير البيئة PHASEO_API_KEY.
            - أبقِ التطبيق صغيرًا عمدًا: صفحة رئيسية واحدة ومسار خادم أو معالج واحد وتنسيق بسيط.
            - اعرض إدخال المستخدم وحالة إرسال الطلب ومخرجات النموذج وأي حالة خطأ في البوابة.
            - أضف مثالًا لحمولة الطلب في التعليقات أو الوثائق لتسهيل مراجعة التكامل لاحقًا.

            تفاصيل التنفيذ:
            - استخدم fetch.
            - أبقِ نص الطلب واضحًا بدلًا من إخفاء الحقول خلف طبقات تجريد.
            - أضف تحققًا أساسيًا من الإدخال الفارغ قبل إرسال طلب API.
            - تعامل جيدًا مع الاستجابات غير 200 واعرض نص الاستجابة عند الحاجة.
            - أبقِ الأسرار على جانب الخادم فقط.

            المخرجات:
            - رمز التطبيق.
            - قسم قصير في README يشرح كيفية تشغيله.
            - إدخال PHASEO_API_KEY في ملف .env.example.

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

  <Accordion title="تطبيق مصغر باستخدام SDK TypeScript" icon="file-code-2">
    <Prompt description="أنشئ تطبيقًا مصغرًا باستخدام **SDK TypeScript** مع تكامل صغير يسهل فحصه." icon="file-code-2" actions={["copy", "cursor"]}>
      {`أنت تنشئ تطبيقًا صغيرًا باستخدام SDK TypeScript من Phaseo.

            أنشئ تطبيقًا مصغرًا باستخدام [إطار العمل] لفكرة [فكرة التطبيق].

            المتطلبات:
            - استخدم @phaseo/sdk.
            - استخدم النموذج [النموذج].
            - فضّل Responses API ما لم يوجد سبب قوي لاستخدام نقطة نهاية أخرى.
            - اقرأ مفتاح API من PHASEO_API_KEY.
            - أبقِ الرمز موجزًا وسهل الفهم للتكامل الأول.
            - اعرض حالات التحميل والنجاح والفشل في الواجهة.

            تفاصيل التنفيذ:
            - استخدم نقطة تكامل واحدة على جانب الخادم بدل توزيع استدعاءات SDK على ملفات متعددة.
            - أبقِ بنية الطلب واضحة، بما يشمل النموذج والمدخلات والخيارات المهمة.
            - أضف مثالًا لتحليل الاستجابة يستخرج النص النهائي للمساعد بأمان.
            - أضف أقل قدر من التعليقات، وفقط عندما تكون بنية استجابة SDK غير واضحة.

            المخرجات:
            - رمز التطبيق العامل.
            - تعليمات إعداد موجزة.
            - شرح موجز لسبب ملاءمة SDK TypeScript لهذا التطبيق المصغر أكثر من HTTP الخام.

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

  <Accordion title="تطبيق مصغر باستخدام SDK Python" icon="snake">
    <Prompt description="أنشئ تطبيقًا أو خدمة Python صغيرة باستخدام **SDK Python الرسمي**." icon="snake" actions={["copy", "cursor"]}>
      {`أنت تنفذ تطبيق Python صغيرًا مدعومًا بالذكاء الاصطناعي باستخدام Phaseo Gateway.

            أنشئ تطبيقًا من نوع [إطار عمل Python أو نوع التطبيق] لفكرة [فكرة التطبيق].

            المتطلبات:
            - استخدم SDK Python الرسمي phaseo.
            - استخدم النموذج [النموذج].
            - اقرأ بيانات الاعتماد من PHASEO_API_KEY.
            - أبقِ الرمز موجزًا بما يكفي ليفهمه عضو جديد في الفريق بسرعة.
            - أضف مسارًا واحدًا لإدخال المستخدم وآخر لمخرجات النموذج.
            - أضف معالجة واضحة للأخطاء الناتجة عن الإدخال غير الصالح وإخفاقات البوابة في المنبع.

            تفاصيل التنفيذ:
            - فضّل استخدام وحدة تكامل واحدة تتولى إنشاء عميل Phaseo.
            - استخدم بنية استجابة SDK مباشرة بدل تغليفها بطبقات تجريد غير ضرورية.
            - إذا كان الإخراج المنظم مفيدًا للتطبيق، فاستخدمه وتحقق من بنية البيانات المُعادة.
            - أضف قسمًا موجزًا في README يشرح خطوات التثبيت والتشغيل.

            المخرجات:
            - رمز التطبيق.
            - أي تحديثات للتبعيات.
            - تعليمات استخدام موجزة.

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

  <Accordion title="تطبيق مصغر باستخدام Vercel AI SDK" icon="code">
    <Prompt description="أنشئ تطبيقًا صغيرًا يستخدم **Phaseo عبر Vercel AI SDK**." icon="code" actions={["copy", "cursor"]}>
      {`أنت تنشئ تطبيقًا مصغرًا يستخدم Phaseo عبر مزود Vercel AI SDK.

            أنشئ تطبيقًا باستخدام [إطار العمل] لفكرة [فكرة التطبيق].

            المتطلبات:
            - استخدم مزود Vercel AI SDK من Phaseo.
            - استخدم النموذج [النموذج].
            - اقرأ مفتاح API الخاص بـPhaseo من PHASEO_API_KEY.
            - أبقِ تجربة المستخدم بسيطة ومركزة على مهمة واحدة واضحة.
            - ادعم الإخراج المتدفق إذا كان التطبيق شبيهًا بالمحادثة؛ وإلا فاشرح سبب بساطة عدم استخدام البث هنا.

            تفاصيل التنفيذ:
            - أبقِ توصيل المزود واضحًا.
            - استخدم عناصر AI SDK الأساسية بطريقة معيارية ومناسبة لإطار العمل.
            - تجنب إدارة الحالة الإضافية غير الضرورية في الإصدار الأول.
            - أضف شرحًا موجزًا لكيفية اختيار معرّف نموذج المزود.

            المخرجات:
            - رمز التطبيق.
            - خطوات الإعداد.
            - ملاحظة موجزة حول كيفية التبديل إلى نموذج آخر لاحقًا.

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

  <Accordion title="تطبيق مصغر باستخدام Agent SDK" icon="bot">
    <Prompt description="أنشئ تطبيقًا صغيرًا باستخدام **Phaseo Agent SDK** وحلقة أدوات محدودة." icon="bot" actions={["copy", "cursor"]}>
      {`أنت تنشئ تطبيقًا صغيرًا يعتمد على الوكلاء فوق Phaseo Gateway.

            أنشئ تطبيقًا مصغرًا بلغة [LANGUAGE] لفكرة [فكرة التطبيق] باستخدام Phaseo Agent SDK.

            المتطلبات:
            - استخدم Phaseo Agent SDK للغة [LANGUAGE].
            - استخدم النموذج [النموذج].
            - أضف أداة محلية حتمية واحدة أو اثنتين فقط.
            - اجعل حلقة الأدوات محدودة وسهلة التصحيح.
            - اقرأ مفتاح API من PHASEO_API_KEY.
            - اعرض المخرجات النهائية، ونشاط الأدوات أو حالة الاستدلال الوسيطة عند الاقتضاء.

            تفاصيل التنفيذ:
            - أبقِ تعريف الوكيل في مكان واحد.
            - أبقِ تعريفات الأدوات صغيرة وحتمية.
            - تجنب إنشاء إطار عمل ضخم وعام للوكلاء في الإصدار الأول.
            - أضف ملاحظة حول مكان حفظ حالة التشغيل إذا أصبح التطبيق قابلًا للاستئناف لاحقًا.

            المخرجات:
            - رمز التطبيق.
            - تعليمات الإعداد.
            - شرح موجز لسبب ملاءمة Agent SDK لهذا التدفق أكثر من إكمال واحد.

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

## كيفية تحسين هذه الموجّهات

* استبدل `[فكرة التطبيق]` بمهمة واحدة محددة للمستخدم، لا بوصف عام للمنتج.
* استبدل `[النموذج]` بمعرّف النموذج الدقيق الذي تريد من الوكيل استخدامه.
* حدد ما إذا كانت المخرجات نصًا حرًا أو JSON صارمًا أو محادثة أو عنصرًا مولدًا واحدًا.
* اذكر إطار واجهة المستخدم ووجهة النشر إن كنت تعرفهما.
* أضف قيدًا أو اثنين مهمين، مثل `مزودو الاتحاد الأوروبي فقط` أو `استخدم البث` أو `أبقِ جميع الأسرار على الخادم`.

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

* [البدء السريع](../quickstart.mdx)
* [أمثلة](../guides/examples.mdx)
* [نظرة عامة على SDK TypeScript](../sdk-reference/typescript/overview.mdx)
* [نظرة عامة على SDK Python](../sdk-reference/python/overview.mdx)
* [نظرة عامة على Agent SDK](../sdk-reference/agent-sdk/overview.mdx)


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