সমস্যা সমাধান

💡TL;DR

বেশিরভাগ Notemd সমস্যা চারটি বিভাগে পড়ে: API মূল সমস্যাগুলি, নেটওয়ার্ক সংযোগ, অথেনটিকেশন ত্রুটি (401/403), এবং রেট লিমিট (429)। অন্তর্নির্মিত কানেকশন টেস্ট ও ডায়াগনস্টিক্স প্যানেল দ্রুত মূল কারণটি চিহ্নিত করে। এই পৃষ্ঠাটি প্রতিটি সাধারণ ত্রুটি বার্তা, তার কারণ এবং সমাধান নিয়ে আলোচনা করে। যেসব সমস্যা এখানে তালিকাভুক্ত নেই, সেগুলি ডায়াগনস্টিক্স আউটপুটসহ GitHub Issues-এ রিপোর্ট করুন.

এটি Obsidian AI Knowledge Management Guide-এর অংশ।

সংক্ষিপ্ত বিবরণ

Notemd বাহ্যিক সেবাগুলির উপর নির্ভরশীল -- LLM প্রদানকারী ও অনুসন্ধান API সার্ভিসগুলি -- তাই বেশিরভাগ সমস্যার উৎপত্তি প্লাগইনটির বাইরেই হয়। সেটিংসের ডায়াগনস্টিক্স প্যানেলটি শেষ API কলটির একটি কাঠামোবদ্ধ দৃশ্য প্রদান করে, যার মধ্যে রয়েছে রিকোয়েস্ট URL, রেসপন্স স্ট্যাটাস এবং ত্রুটি বডি। আরও তদন্ত করার আগে সর্বদা প্রথমে এটি পরীক্ষা করুন.

কীভাবে এটি কাজ করে: ডায়াগনস্টিক্স

কানেকশন টেস্ট

প্রতিটি প্রদানকারী কনফিগারেশন বিভাগে একটি “Test Connection” বাটন রয়েছে। এটি ক্লিক করলে একটি ন্যূনতম API রিকোয়েস্ট (সাধারণত একটি মডেল তালিকা বা সংক্ষিপ্ত কমপ্লিশন) পাঠানো হয় এবং সাফল্য বা নির্দিষ্ট HTTP ত্রুটি সম্পর্কে জানানো হয়। এটাই আপনার API কী ও বেস URL সঠিক আছে কিনা যাচাই করার সবচেয়ে দ্রুত উপায়.

ডায়াগনস্টিক্স প্যানেল

Settings --> Notemd --> Diagnostics এ নিম্নলিখিতগুলি দেখানো হয়:

ফিল্ড	কন্টেন্ট
শেষ প্রদানকারী	কোন প্রদানকারীকে সর্বশেষ কল করা হয়েছিল
শেষ মডেল	কোন মডেলটিকে সর্বশেষ কল করা হয়েছিল
শেষ অবস্থা	HTTP স্ট্যাটাস কোড অথবা ট্রান্সপোর্ট ত্রুটি
শেষ ত্রুটি	API থেকে প্রাপ্ত কাঁচা ত্রুটি বার্তা
শেষ রিকোয়েস্ট URL	শেষ রিকোয়েস্টের পূর্ণ URL (API কী মুছে দেওয়া হয়েছে)
শেষ রেসপন্স বডি	সংক্ষিপ্ত রেসপন্স বডি (প্রথম 500 অক্ষর)

GitHub-এ সমস্যা রিপোর্ট করার সময় পূর্ণ ডায়াগনস্টিক্স আউটপুট কপি করুন.

সাধারণ ত্রুটিসমূহ

API কী অবৈধ বা অনুপস্থিত

লক্ষণ: HTTP 401 অথবা "ভুল API কী প্রদান করা হয়েছে"

কারণ: API কীটি অনুপস্থিত, এতে হোয়াইটস্পেস রয়েছে, অথবা এটি অন্য কোনো প্রোভাইডারের হতে পারে.

সমাধান:

1. নিশ্চিত করুন যে কীটির শুরু ও শেষে কোনো স্পেস নেই
2. নিশ্চিত করুন যে কীটি নির্বাচিত প্রোভাইডারের সাথে মিলে যায় (একটি OpenAI কী Anthropic-এর সাথে কাজ করবে না)
3. আপনার অ্যাকাউন্টে ক্রেডিট বা সক্রিয় সাবস্ক্রিপশন আছে কিনা তা যাচাই করুন
4. যাচাই করার জন্য "Test Connection"-এ ক্লিক করুন

নেটওয়ার্ক / কানেকশন ত্রুটি

লক্ষণ: ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed

কারণ: আপনার মেশিন থেকে API এন্ডপয়েন্টটি অ্যাক্সেস করা যাচ্ছে না.

সমাধান:

1. আপনার ইন্টারনেট কানেকশন যাচাই করুন
2. যদি প্রক্সি বা ফায়ারওয়ালের পিছনে থাকেন, তবে API ডোমেইনটি ব্লক হয়নি তা নিশ্চিত করুন
3. Ollama-এর জন্য: ollama serve চালু আছে কিনা নিশ্চিত করুন (ollama list থেকে models রিটার্ন হওয়া উচিত)
4. LMStudio-এর জন্য: localhost:1234-এ সার্ভারটি চালু আছে কিনা নিশ্চিত করুন
5. অন্য কোনো ট্রান্সপোর্ট ব্যবহার করে দেখুন -- মোবাইল ব্যবহারকারীদের requestUrl ট্রান্সপোর্টটি সক্রিয় আছে তা নিশ্চিত করা উচিত
6. অস্থায়ী ত্রুটিগুলোর জন্য স্বয়ংক্রিয় পুনরাবৃত্তির জন্য enableStableApiCall সক্রিয় করুন

403 Forbidden

লক্ষণ: HTTP 403

কারণ: আপনার API কীটি বৈধ হলেও অনুরোধকৃত রিসোর্সের জন্য অনুমতি নেই.

সমাধান:

1. কিছু মডেলের জন্য বিশেষ অ্যাক্সেস প্রয়োজন (উদাহরণস্বরূপ, Azure-এর মাধ্যমে GPT-4-এর জন্য একটি ডিপ্লয়মেন্ট নাম দরকার)
2. কিছু প্রদানকারী প্ল্যান স্তর অনুযায়ী মডেলগুলোকে সীমিত করে -- আপনার অ্যাকাউন্ট পরীক্ষা করুন
3. আঞ্চলিক সীমাবদ্ধতা প্রযোজ্য হতে পারে (কিছু চীনা প্রদানকারী আন্তর্জাতিক IP-গুলোকে ব্লক করে এবং উল্টোটাও হয়)
4. নিশ্চিত হওয়া উচিত যে মডেলের নামটি সঠিকভাবে লেখা হয়েছে (উদাহরণস্বরূপ, আপনার প্ল্যানে যখন শুধুমাত্র মিনি মডেল অনুমোদিত থাকে তখন gpt-4o নয়, gpt-4o-mini ব্যবহার করবেন)

রেট লিমিট (429)

লক্ষণ: HTTP 429 অথবা "রেট লিমিট অতিক্রান্ত"

কারণ: সংক্ষিপ্ত সময়ের মধ্যে অতিরিক্ত সংখ্যক রিকোয়েস্ট করা হয়েছে.

সমাধান:

1. batchConcurrency কে 1 অথবা 2 এ কমিয়ে আনুন
2. পুনরায় চেষ্টা করার আগে কয়েক মিনিট অপেক্ষা করুন
3. আপনার প্ল্যান স্তরের জন্য আপনার প্রদানকারীর রেট লিমিট সংক্রান্ত নির্দেশিকা পরীক্ষা করুন
4. ব্যাকঅফ সহ স্বয়ংক্রিয় পুনরায় চেষ্টার জন্য enableStableApiCall সক্রিয় করুন
5. উচ্চতর লিমিটযুক্ত প্রদানকারীতে স্বিচ করার কথা বিবেচনা করুন (DeepSeek, Ollama)

মডেল পাওয়া যায়নি

লক্ষণ: "মডেল পাওয়া যায়নি" অথবা HTTP 404

কারণ: নির্বাচিত প্রদানকারীর কাছে মডেলের নামটি অস্তিত্বহীন।

সমাধান:

1. আপনার প্রোভাইডারের জন্য উপলব্ধ সমস্ত মডেল দেখতে "Get Model List"-এ ক্লিক করুন
2. কিছু মডেলের নাম সময়ের সাথে পরিবর্তিত হয় -- প্রোভাইডারের ডকুমেন্টেশনে বর্তমান নামটি যাচাই করুন
3. Ollama-এর জন্য: পুল করা মডেলগুলো দেখতে ollama list চালান; শুধুমাত্র ডাউনলোড করা মডেলগুলোই উপলব্ধ

কোনো লিঙ্ক/কোনো কনসেপ্ট তৈরি হয়নি

লক্ষণ: কমান্ডটি চলে কিন্তু কোনো আউটপুট পাওয়া যায় না

কারণ: LLM একটি খালি বা অপারেট করা যায় না এমন রেসপন্স ফেরত দিয়েছে.

সমাধান:

1. প্রকৃত LLM রেসপন্স দেখার জন্য ডায়াগনস্টিক্স প্যানেলটি পরীক্ষা করুন
2. আরও শক্তিশালী একটি মডেল চেষ্টা করুন (কিছু ছোট মডেল স্ট্রাকচারড আউটপুট নিয়ে সমস্যায় পড়ে)
3. নোটটিতে যথেষ্ট বিষয়বস্তু থাকছে তা নিশ্চিত করুন (>50 শব্দ)
4. পরস্পর বিরোধী নির্দেশাবলী থাকলে আপনার কাস্টম প্রম্পটটি পর্যালোচনা করুন
5. এটি খুব বেশি কঠোরভাবে ফিল্টার করছে কিনা দেখতে অস্থায়ীভাবে সিনোনিম সাপ্রেশন নিষ্ক্রিয় করুন

Doubao এন্ডপয়েন্ট ID অনুপস্থিত

লক্ষণ: ByteDance Doubao প্রোভাইডার ব্যবহার করার সময় ত্রুটি

কারণ: Doubao-এর জন্য মডেলের নামের পরিবর্তে একটি Ark এন্ডপয়েন্ট ID (ফরম্যাট: ep-xxxxxxxx-xxxx-xxxx) প্রয়োজন.

সংশোধন: Volcengine কনসোল থেকে আপনার প্রকৃত এন্ডপয়েন্ট ID দিয়ে ডিফল্ট প্লেসহোল্ডার মডেলটি প্রতিস্থাপন করুন।

কনফিগারেশন

ডায়াগনস্টিক সেটিং	অবস্থান	উদ্দেশ্য
কানেকশন পরীক্ষা করুন	Settings --> Provider বিভাগ	API কী এবং সংযোগ যোগ্যতা যাচাই করুন
মডেল তালিকা পাওয়া	Settings --> Provider বিভাগ	কোন মডেলগুলো অ্যাক্সেসযোগ্য তা নিশ্চিত করুন
enableStableApiCall	Settings --> Advanced	ব্যাকঅফ সহ রিট্রাই সক্রিয় করুন
batchConcurrency	Settings --> Batch	রেট লিমিট এড়াতে প্যারালালিজম নিয়ন্ত্রণ করুন

সমস্যা রিপোর্ট করার উপায়

যদি আপনার সমস্যা উপরে উল্লিখিত না থাকে:

1. Open Settings --> Notemd --> Diagnostics
2. Copy the full diagnostics output
3. Open a GitHub Issue at github.com/Jacobinwwey/obsidian-NotEMD/issues
4. Include: Obsidian version, Notemd version, provider, model, diagnostics output, and steps to reproduce
5. Redact your API key from any shared logs

---

পরবর্তী ধাপসমূহ

• LLM Providers -- Full provider configuration reference
• Batch Processing -- Concurrency and retry settings for large operations
• Custom Prompts -- Fix unexpected LLM behavior by adjusting prompts