GET /v1/models، وإجابات من POST /v1/responses.
المثال توضيحي: مساراته بلا تسجيل دخول ولا حدّ للمعدل، لذا يستطيع أي شخص يصل إليها أن ينفق من مفتاحك. أضف الفحوصات الواردة في قبل النشر أولًا.
لكي يبني وكيل برمجة التطبيق نفسه من الصفر، الصق هذه المطالبة:
أنشئ تطبيق دردشة ويب باستخدام Next.js فوق Phaseo Gateway.
كيف بُني المثال
يوجد المثال في 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.