الانتقال إلى المحتوى الرئيسي
شغّل تطبيق دردشة صغيرًا مبنيًا بـ Next.js لا يتحدث كود المتصفح فيه إلا إلى مسارات الخادم الخاصة بك، كي لا يصل مفتاح Phaseo API إلى المتصفح أبدًا. في النهاية تكون لديك صفحة دردشة محلية مع أداة اختيار نموذج تُملأ من GET /v1/models، وإجابات من POST /v1/responses. المثال توضيحي: مساراته بلا تسجيل دخول ولا حدّ للمعدل، لذا يستطيع أي شخص يصل إليها أن ينفق من مفتاحك. أضف الفحوصات الواردة في قبل النشر أولًا. لكي يبني وكيل برمجة التطبيق نفسه من الصفر، الصق هذه المطالبة:

أنشئ تطبيق دردشة ويب باستخدام Next.js فوق Phaseo Gateway.

فتح في Cursor

كيف بُني المثال

يوجد المثال في examples/web-chat-nextjs:

شغّله

تحتاج إلى Node.js ومفتاح Phaseo API.
1

التثبيت

يأتي المثال مع ملف package-lock.json، لذا يثبّت npm الإصدارات التي اختُبرت.
2

أنشئ .env.local

لا يحتوي المثال على .env.example. أنشئ .env.local بنفسك:
.env.local
لا يُقرأ NEXT_PUBLIC_GATEWAY_URL هنا إلا على الخادم، لكن البادئة NEXT_PUBLIC_ قد تكشفه لكود المتصفح، لذا لا تضع فيه مفتاحًا أبدًا. تشرح صفحة نسب التطبيق الترويستين الاختياريتين.
3

أصلح دور الدردشة الثاني

يرسل ChatClient.tsx قيمة id للإجابة السابقة بوصفها previous_response_id. لا يخزّن الـ Gateway الاستجابات، لذا يرفض هذا الحقل بالخطأ 400 validation_error (الكلمة المفتاحية unsupported_param) وتفشل الرسالة الثانية. في app/api/responses/route.ts، احذف الكتلة التي تنسخ previous_response_id إلى الحمولة:
app/api/responses/route.ts
بعد ذلك يُجاب عن كل دور بمفرده. للحفاظ على السياق، أرسل الأدوار السابقة كمصفوفة رسائل في input.
4

شغّل خادم التطوير

افتح http://localhost:3000.

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

  • تمتلئ أداة اختيار النموذج بمعرّفات النماذج.
  • تحصل رسالتان متتاليتان على إجابة لكل منهما.
  • في لوحة الشبكة في المتصفح، لا تذهب الطلبات إلا إلى /api/models و/api/responses، ولا يحمل أي طلب PHASEO_API_KEY.
  • يعرض معرّف النموذج الخاطئ رسالة الخطأ من الـ Gateway بدلًا من إجابة فارغة.
  • تظهر الطلبات في الإعدادات → الاستخدام → السجلات مع عنوان التطبيق الذي ضبطته.

قبل النشر

  • صادِق على المسارات. اشترط وجود مستخدم مسجّل الدخول على /api/responses و/api/models، أو استخدم منضدة OAuth كي ينفق كل مستخدم من أرصدته الخاصة.
  • ضع قائمة سماح للنماذج. يمرّر المسار أي سلسلة model تأتي من المتصفح. تحقّق منها مقابل قائمة ثابتة على الخادم.
  • حدّ من المدخلات والمعدل. قيّد طول المدخلات وعدد الطلبات لكل مستخدم، واضبط حدّ إنفاق على المفتاح.
  • استخدم البث إن احتجت إليه. اضبط stream: true ومرّر الأحداث؛ توضح صفحة البث الحدث الذي يُنهي بث Responses.
لسكربت خلفي بدلًا من واجهة مستخدم، ابدأ من تطبيق اختبار Node REST السريع أو أداة Python CLI للـ Gateway.
آخر تعديل في ٥ نوفمبر ٢٠٢٦