বেস URL ট্রাবলশুটিং
মডেল পরিবর্তন করা সহজ হওয়া উচিত। আপনি শুধু এন্ডপয়েন্ট (endpoint) পরিবর্তন করবেন এবং একই SDK ব্যবহার করতে থাকবেন। প্রায়শই, এটি 401, 404, বা 429 এর মতো ত্রুটি (error) সহ ব্যর্থ হয়।
SDK-কে দোষ দেওয়ার আগে, এই ৭টি পরীক্ষা করে দেখুন।
১. /v1 প্রিফিক্স (prefix) পরীক্ষা করুন বেশিরভাগ গেটওয়েতে (gateway) বেস URL-এ /v1 সাফিক্স (suffix) প্রয়োজন হয়। আপনি যদি শুধুমাত্র ডোমেইন ব্যবহার করেন, তবে SDK ভুল পাথে (path) কল করতে পারে। সর্বদা প্রোভাইডার ডকুমেন্টেশন থেকে সঠিক ফরম্যাটটি কপি করুন।
২. আপনার API কী (key) যাচাই করুন কী (key) গুলোর মিশ্রণ ব্যবহারের কারণে বেশিরভাগ ব্যর্থতা ঘটে। এই বিষয়গুলোর দিকে খেয়াল রাখুন:
- রিলে URL-এর সাথে OpenAI কী ব্যবহার করা।
- OpenAI URL-এর সাথে রিলে কী ব্যবহার করা।
- নিষ্ক্রিয় (disabled) প্রজেক্টের কী ব্যবহার করা।
- কী-তে অতিরিক্ত স্পেস রাখা।
যদি আপনি 401 এরর দেখেন, তবে আপনার ড্যাশবোর্ডের সাথে তুলনা করার জন্য কী-এর শুধুমাত্র প্রথম এবং শেষ কয়েকটি অক্ষর প্রিন্ট করুন। কখনোই সম্পূর্ণ কী লগ (log) করবেন না।
৩. সঠিক মডেলের নাম ব্যবহার করুন মডেলের নাম অনুমান করবেন না। প্রাপ্যতা বা অ্যাভেইলেবিলিটির (availability) ওপর ভিত্তি করে গেটওয়ে-র নাম পরিবর্তিত হয়। প্রোভাইডার লিস্ট থেকে মডেল ID হুবহু কপি করুন। ভুল নামের কারণে 404 বা model_not_found এরর হতে পারে।
৪. একটি ছোট টেস্ট রিকোয়েস্ট (request) চালান আপনার পুরো অ্যাপ ডিবাগ (debug) করার আগে একটি মাত্র ছোট রিকোয়েস্টের মাধ্যমে আপনার কানেকশন পরীক্ষা করে নিন। যদি একটি সাধারণ "ping" কাজ করে, তবে আপনার URL, কী এবং মডেল সঠিক আছে। সমস্যাটি তখন আপনার অ্যাপ লজিকের (app logic) মধ্যে রয়েছে, যেমন স্ট্রিমিং (streaming) বা টুল কলিং (tool calling)।
৫. এরর কোডগুলো (error codes) বুঝুন
- 401 মানে আপনার কী বা অ্যাকাউন্টের অবস্থা ভুল।
- 429 মানে আপনি রেট লিমিট (rate limit) অতিক্রম করেছেন বা আপনার ব্যালেন্স নেই। যদি আপনি 429 দেখেন, তবে আপনার বিলিং পেজটি পরীক্ষা করুন। ঘন ঘন রিট্রাই লুপ (retry loops) এড়িয়ে চলুন, কারণ এটি লিমিট বা সীমাবদ্ধতাকে আরও খারাপ করে তোলে।
৬. স্ট্যাটাস পেজ (status page) পরীক্ষা করুন যদি আপনার কোড গতকাল কাজ করে কিন্তু আজ ব্যর্থ হয়, তবে আপনার ইন্টিগ্রেশন (integration) পুনরায় লিখবেন না। প্রোভাইডারের স্ট্যাটাস পেজটি পরীক্ষা করুন। রিলে সার্ভিসের ক্ষেত্রে আপস্ট্রিম ইনসিডেন্ট (upstream incidents) সাধারণ বিষয়।
৭. একটি curl কমান্ড ব্যবহার করুন আপনার প্রজেক্ট ডকুমেন্টেশনে একটি মিনিমাল curl কমান্ড রাখুন। অ্যাপ কাজ না করলে এটি চালান।
- যদি curl ব্যর্থ হয়: আপনার অ্যাকাউন্ট, গেটওয়ে বা নেটওয়ার্ক ডিবাগ করুন।
- যদি curl কাজ করে: আপনার অ্যাপ্লিকেশন কোড ডিবাগ করুন।
গোছানো মৌলিক বিষয়গুলো মডেল পরিবর্তন করা সহজ করে তোলে।
ঐচ্ছিক লার্নিং কমিউনিটি: https://t.me/GyaanSetuAi