GET /v1/models से भरा मॉडल पिकर और POST /v1/responses से आए जवाब होंगे।
यह सैंपल उदाहरण के लिए है: इसके रूट में न साइन-इन है, न रेट लिमिट, इसलिए जो भी उन तक पहुँच सकता है वह आपकी कुंजी खर्च कर सकता है। पहले डिप्लॉय करने से पहले वाली जाँचें जोड़ें।
किसी कोडिंग एजेंट से यही ऐप शुरू से बनवाने के लिए, यह प्रॉम्प्ट पेस्ट करें:
Phaseo Gateway पर Next.js वेब चैट ऐप बनाएँ।
सैंपल कैसे बना है
सैंपल 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 को payload में कॉपी करता है:app/api/responses/route.ts
input में संदेशों की array के रूप में भेजें।4
डेव सर्वर शुरू करें
http://localhost:3000 खोलें।जाँचें कि यह काम किया
- मॉडल पिकर मॉडल ID से भर जाता है।
- लगातार दो संदेशों में से हर एक को जवाब मिलता है।
- ब्राउज़र के नेटवर्क पैनल में अनुरोध सिर्फ़
/api/modelsऔर/api/responsesपर जाते हैं, और किसी अनुरोध मेंPHASEO_API_KEYनहीं होती। - गलत मॉडल ID खाली जवाब के बजाय Gateway का त्रुटि संदेश दिखाता है।
- अनुरोध सेटिंग → उपयोग → लॉग्स में आपके सेट किए ऐप टाइटल के साथ दिखते हैं।
डिप्लॉय करने से पहले
- रूट प्रमाणित करें।
/api/responsesऔर/api/modelsपर साइन-इन किया हुआ उपयोगकर्ता ज़रूरी करें, या OAuth workbench इस्तेमाल करें ताकि हर उपयोगकर्ता अपने क्रेडिट खर्च करे। - मॉडल की अनुमति-सूची बनाएँ। रूट ब्राउज़र से आई कोई भी
modelस्ट्रिंग आगे भेज देता है। सर्वर पर उसे एक तय सूची से जाँचें। - इनपुट और दर सीमित करें। इनपुट की लंबाई और हर उपयोगकर्ता के अनुरोध सीमित करें, और कुंजी पर खर्च सीमा सेट करें।
- ज़रूरत हो तो स्ट्रीम करें।
stream: trueसेट करें और इवेंट आगे भेजें; स्ट्रीमिंग बताता है कि कौन-सा इवेंट Responses स्ट्रीम खत्म करता है।