এটি মূল ইংরেজি নথির একটি মেশিন অনুবাদ। এই অনুবাদ এবং মূল ইংরেজি সংস্করণের মধ্যে কোনো বিরোধ দেখা দিলে, ইংরেজি সংস্করণটিই প্রাধান্য পাবে। মূল ইংরেজি সংস্করণটি পড়ুন

---

ট্রাবলশুটিং

কিছু কাজ করছে না? এখান থেকে শুরু করুন।

ব্রাউজার এক্সটেনশন সমস্যা

এক্সটেনশন লোড হচ্ছে না

১. নিশ্চিত করুন যে আপনি এটি Chrome Web Store থেকে ইনস্টল করেছেন (ডেভেলপমেন্ট ভার্সন নয়) ২. chrome://extensions-এ যান এবং কোনো এরর মেসেজ আছে কি না দেখুন ৩. এক্সটেনশনটি নিষ্ক্রিয় করে আবার সক্রিয় করার চেষ্টা করুন ৪. কাজ না করলে Chrome সম্পূর্ণভাবে রিস্টার্ট করুন

সাইডপ্যানেল খুলছে না

১. আপনার টুলবারের (উপরে ডানে) Caiioo আইকনে ক্লিক করুন ২. নিশ্চিত করুন যে আপনি একটি সাধারণ ওয়েবপেজে আছেন (Chrome সেটিংসের মতো কিছু পেজ এক্সটেনশন অনুমতি দেয় না) ৩. chrome://extensions-এ যান, Caiioo খুঁজুন এবং "Reload"-এ ক্লিক করুন ৪. আইকনে আবার ক্লিক করার চেষ্টা করুন

আপডেটের পর সাইডবার ফাঁকা বা ভাঙা দেখাচ্ছে

• আপনার ব্রাউজার ক্যাশে ক্লিয়ার করুন এবং এক্সটেনশনটি রিলোড করুন
• সাইডপ্যানেলটি বন্ধ করে আবার খুলুন
• কিছুতেই কাজ না হলে, এক্সটেনশনটি নিষ্ক্রিয় করে আবার সক্রিয় করুন

সাইন-ইন সমস্যা

Google / Apple / Microsoft দিয়ে সাইন ইন করা যাচ্ছে না

১. নিশ্চিত করুন যে আপনার ব্রাউজার পপআপ ব্লক করছে না — OAuth-এর জন্য একটি পপআপ উইন্ডো প্রয়োজন ২. iOS-এ, যদি Google সাইন-ইন আটকে যায়, তবে পরিবর্তে "Sign in with Apple" অপশনটি চেষ্টা করুন ৩. caiioo.ai-এর জন্য কুকিজ পরিষ্কার করুন এবং আবার চেষ্টা করুন ৪. আপনি যদি সম্প্রতি পাসওয়ার্ড পরিবর্তন করে থাকেন, তবে প্রথমে আপনার ব্রাউজারে প্রদানকারী থেকে সাইন আউট করুন, তারপর আবার চেষ্টা করুন

সাইন ইন করার পর লগইন স্ক্রিনে আটকে আছে

• কয়েক সেকেন্ড অপেক্ষা করুন — অ্যাপটি আপনার প্রোফাইল আনছে
• যদি আটকে থাকে, অ্যাপটি বন্ধ করে আবার খুলুন (অথবা এক্সটেনশনটি রিলোড করুন)
• নিশ্চিত করুন যে আপনার ডিভাইসের ঘড়ি সঠিক আছে — ঘড়ি ভুল থাকলে OAuth টোকেন যাচাইকরণ ব্যর্থ হয়

API কী সম্পর্কিত সমস্যা

API কী কাজ করছে না

1. প্রোভাইডারের ওয়েবসাইট থেকে আপনার কী আবার কপি করুন এবং সতর্কতার সাথে পেস্ট করুন (শুরুতে বা শেষে যেন স্পেস না থাকে)
2. আপনার অ্যাকাউন্টে ক্রেডিট অবশিষ্ট আছে কিনা তা পরীক্ষা করুন
3. একটি নতুন কী তৈরি করে তার পরিবর্তে সেটি ব্যবহার করে দেখুন
4. কী-এর ফরম্যাট সঠিক কিনা তা পরীক্ষা করুন — OpenRouter কী sk-or- দিয়ে শুরু হয়

আমার API কী খুঁজে পাচ্ছি না

• OpenRouter: openrouter.ai/keys
• Ollama: কোনো কী-এর প্রয়োজন নেই — আপনার লোকাল সার্ভার http://localhost:11434-এ চলছে কিনা তা নিশ্চিত করুন

আরও বিস্তারিত তথ্যের জন্য AI প্রোভাইডার এবং API কী দেখুন।

আমার নির্বাচিত মডেলে "Rate limited" বা "overloaded" দেখাচ্ছে

এটি প্রোভাইডারের সমস্যা, আপনার কী-এর নয়। আপনার নির্বাচিত কোনো মডেল রেট-সীমিত, ওভারলোড বা অনুপলব্ধ হলে, Caiioo আপনাকে নীরবে অন্য মডেলে সরিয়ে নেওয়ার বদলে মডেলটির নাম উল্লেখ করে কী ঘটেছে তা জানায়। এক মিনিট অপেক্ষা করে আবার পাঠান, অথবা নিজেই অন্য কোনো মডেল বেছে নিন। (Caiioo যখন আপনার জন্য মডেল নির্বাচন করে, তখন এটি এখনও স্বয়ংক্রিয়ভাবে পরিবর্তন করে — এটাই পার্থক্য।)

একটি ফ্রি মডেল বারবার আমার অনুরোধ প্রত্যাখ্যান করছে

কিছু ফ্রি OpenRouter মডেল তাদের নিজস্ব অনুমতি-তালিকায় (allow-list) নেই এমন অ্যাপগুলোর অনুরোধ প্রত্যাখ্যান করে। Caiioo এমন কোনো মডেলকে মনে রাখে যা প্রত্যাখ্যান করেছে, পিকার-এ সেটিকে চিহ্নিত করে এবং অন্য মডেলে যাওয়ার সময় সেটি এড়িয়ে যায় — এরপর ব্লক তুলে নেওয়া হয়েছে কিনা তা পরবর্তীতে আবারও যাচাই করে। ইতিমধ্যে অন্য একটি মডেল বেছে নিন।

Google ইন্টিগ্রেশন (Pro স্তর)

Google-এ সংযোগ করা যাচ্ছে না

১. সেটিংস > কানেক্টর-এ যান ২. "Google অ্যাকাউন্ট সংযুক্ত করুন"-এ ক্লিক করুন ৩. সমস্ত অনুরোধ করা অনুমতি অনুমোদন করেছেন কিনা তা নিশ্চিত করুন ৪. আপনার অ্যাকাউন্ট সংযুক্ত হিসেবে দেখাচ্ছে কিনা পরীক্ষা করুন ৫. এটি এখনও কাজ না করলে, সংযোগ বিচ্ছিন্ন করুন এবং আবার চেষ্টা করুন

Google টুলগুলি কাজ করছে না

১. Google সংযুক্ত রয়েছে কিনা তা যাচাই করুন (সেটিংস > কানেক্টর) ২. আপনার Google সংযোগ রিফ্রেশ করার চেষ্টা করুন ("Google পুনরায় সংযুক্ত করুন" বোতাম) ৩. নির্দিষ্ট টুলটি সক্রিয় আছে কিনা তা নিশ্চিত করুন (সেটিংস > টুল ও ইন্টিগ্রেশন > টুল কনফিগারেশন)

Private Sync সম্পর্কিত সমস্যা

সিঙ্ক কাজ করছে না

1. Private sync প্রকৃতপক্ষে সক্রিয় আছে কিনা তা পরীক্ষা করুন (Settings > Connectivity > Private Sync)
2. আপনার Google অ্যাকাউন্ট সংযুক্ত আছে কিনা তা যাচাই করুন
3. আপনার Google Drive-এ স্টোরেজ স্পেস খালি আছে কিনা তা নিশ্চিত করুন
4. আপনার টোকেনের মেয়াদ শেষ হয়ে থাকলে "Reconnect Google"-এ ক্লিক করুন
5. সিঙ্ক বন্ধ করে আবার চালু করার চেষ্টা করুন

ডিভাইসগুলোর মধ্যে ডেটা সিঙ্ক হয়নি

• Private sync ব্যাকগ্রাউন্ডে কাজ করে—কয়েক সেকেন্ড সময় দিন
• সব ডিভাইসে একই Google অ্যাকাউন্ট ব্যবহার করছেন কিনা তা পরীক্ষা করুন
• নিশ্চিত করুন যে অন্য ডিভাইসেও private sync সক্রিয় রয়েছে
• সিঙ্ক বন্ধ ও পুনরায় চালু করে ম্যানুয়ালি রিফ্রেশ করুন

দূরবর্তী ব্রাউজার অ্যাক্সেসের সমস্যা

relay.caiioo.ai/app পৃষ্ঠাটি সংযুক্ত হবে না

• আপনার মূল ডিভাইসে, প্রাইভেট রিলে চালু আছে কিনা (সেটিংস > সংযোগ > ডিভাইস ও রিলে) এবং "সংযুক্ত" দেখাচ্ছে কিনা তা নিশ্চিত করুন
• আপনার মূল ডিভাইসের একই অ্যাকাউন্ট দিয়ে দূরবর্তী ব্রাউজারে সাইন ইন করুন—রিলে শুধুমাত্র আপনার নিজস্ব ইনস্ট্যান্সে পৌঁছায়
• দূরবর্তী ব্রাউজার থেকে এটি চালানোর জন্য আপনার মূল ডিভাইসের এক্সটেনশন বা ডেস্কটপ অ্যাপ চালু এবং অনলাইনে থাকতে হবে
• প্রথমবার খোলার সময় এনক্রিপ্ট করা সেশন স্থাপন করার সময় পৃষ্ঠাটি কয়েক সেকেন্ডের জন্য একটি "সংযুক্ত হচ্ছে" স্পিনার দেখাতে পারে—রিলোড করার আগে এটি শেষ হতে দিন

সাইন ইন করা সত্ত্বেও দূরবর্তী পৃষ্ঠাটি লগইন স্ক্রিনে আটকে থাকে

• কয়েক সেকেন্ড অপেক্ষা করুন—এনক্রিপ্ট করা সেশন স্থাপিত হলেই কেবল এটি অ্যাপটি বুট করে
• এটি আটকে থাকলে, আপনার মূল ডিভাইসটি অনলাইনে আছে এবং প্রাইভেট রিলে সংযুক্ত আছে কিনা তা নিশ্চিত করুন, তারপর পৃষ্ঠাটি রিলোড করুন

পারফরম্যান্স সমস্যা

প্রতিক্রিয়া ধীরগতিতে আসছে

১. AI প্রদানকারীর কোনো সমস্যা হচ্ছে কিনা তা পরীক্ষা করুন (তাদের স্ট্যাটাস পেজ দেখুন) ২. একটি দ্রুত এবং সস্তা মডেল ব্যবহার করার চেষ্টা করুন (যেমন Gemini Flash বা Mistral) ৩. আপনার যদি শত শত পুরনো কথোপকথন থাকে তবে সেগুলি আর্কাইভ করুন ৪. আপনার ইন্টারনেট সংযোগ পরীক্ষা করুন

কথোপকথন অনেক সময় নিচ্ছে

• AI কাজ করছে—স্পিনিং ইন্ডিকেটরটি দেখুন
• কিছু মডেল অন্যদের তুলনায় ধীর। আপনি যদি তাড়াহুড়োতে থাকেন তবে দ্রুত মডেলে সুইচ করুন
• যদি এটি কয়েক মিনিটের বেশি সময় নেয়, তবে AI আটকে যেতে পারে। Stop ক্লিক করুন এবং আবার চেষ্টা করুন

সাবস্ক্রিপশন ও বিলিং

"প্ল্যান পরিচালনা করুন" দেখতে পাচ্ছি না

• নিশ্চিত করুন যে আপনি সাবস্ক্রিপশন ধারণকারী অ্যাকাউন্ট দিয়ে সাইন ইন করেছেন
• আপনি যদি iOS-এ সাবস্ক্রাইব করে থাকেন, তবে "প্ল্যান পরিচালনা করুন" বোতামটি Apple-এর সাবস্ক্রিপশন সেটিংসে নির্দেশ করে
• আপনি ওয়েবে সাবস্ক্রাইব করে থাকলে, এটি Stripe বিলিং পোর্টালের দিকে নির্দেশ করে
• আপনার সাবস্ক্রিপশন স্ট্যাটাস রিফ্রেশ করতে সাইন আউট করে আবার সাইন ইন করুন

"প্ল্যান পরিচালনা করুন" ভুল জায়গা খুলে দেয়

• iOS ইন-অ্যাপ ক্রয় সেটিংস > Apple ID > সাবস্ক্রিপশন-এ পরিচালিত হয় — caiioo.ai/account এ নয়
• Stripe সাবস্ক্রিপশন সেটিংস > অ্যাকাউন্ট > ইউজার প্রোফাইল-এ বা caiioo.ai/account এ পোর্টাল লিঙ্কের মাধ্যমে পরিচালিত হয়
• আপনি কোথায় সাবস্ক্রাইব করেছেন তার ওপর ভিত্তি করে Caiioo স্বয়ংক্রিয়ভাবে রুট করে — এটি স্বাভাবিক

আপগ্রেড করা হয়েছে কিন্তু এখনও পুরানো টায়ারেই আছি

• Stripe আপগ্রেড ছড়াতে এক মিনিট সময় নেয় — অ্যাপটি রিলোড করুন
• Apple IAP যাচাই করতে ২৪ ঘণ্টা পর্যন্ত সময় নিতে পারে। প্রক্রিয়াটি দ্রুত করতে সেটিংস > অ্যাকাউন্ট > ইউজার প্রোফাইল-এ "Restore Purchases" এ ট্যাপ করুন
• আপনার যদি ইতিমধ্যেই অন্য প্ল্যাটফর্মে সাবস্ক্রিপশন থাকে, তবে Subscribe বোতামটি আপনাকে পরিবর্তে সেখানে এটি পরিচালনা করতে বলবে

অন্যান্য সমস্যা

ডেস্কটপ বা মোবাইল অ্যাপে ফাঁকা স্ক্রিন

• অ্যাপটি সম্পূর্ণ রিস্টার্ট করুন
• ইন্টারনেটের সাথে সংযুক্ত আছেন কিনা তা পরীক্ষা করুন
• অ্যাপের ক্যাশ মুছে ফেলার চেষ্টা করুন (প্ল্যাটফর্ম অনুযায়ী পরিবর্তিত হয়)
• সর্বশেষ সংস্করণে আপডেট করুন

টুলগুলি কাজ করছে না

১. সেটিংস > টুল ও ইন্টিগ্রেশন > টুল কনফিগারেশন-এ যান এবং টুলটি সক্রিয় আছে কিনা তা পরীক্ষা করুন ২. কিছু টুলের জন্য অনুমতি বা সেটআপ প্রয়োজন (যেমন Google টুলের জন্য সংযুক্ত Google অ্যাকাউন্ট) ৩. আপনি যদি "অনুমতি প্রয়োজন" ত্রুটি দেখতে পান, তবে সেটিংস > কানেক্টর-এ প্রদানকারীকে পুনরায় সংযুক্ত করুন এবং স্কোপগুলি পুনরায় অনুমোদন করুন

এক্সটেনশনটি ডেস্কটপ অ্যাপে সংযুক্ত হতে পারছে না

• প্রথমে, পরীক্ষা করুন যে Caiioo Bridge সক্রিয় করুন চালু আছে কিনা (সেটিংস > সংযোগ > ডিভাইস ও রিলে) — এটি ডিফল্টভাবে বন্ধ থাকে, এবং এটি বন্ধ থাকাকালীন এক্সটেনশন কখনোই ডেস্কটপ অ্যাপের সাথে সংযুক্ত হয় না এবং পুনঃসংযোগ/পোর্ট নিয়ন্ত্রণগুলি ধূসর থাকে
• আপনি যদি ব্রাউজার এক্সটেনশন এবং ডেস্কটপ অ্যাপ উভয়ই ব্যবহার করেন, তবে এক্সটেনশনটি একটি স্থানীয় ওয়েবসকেটের (ক্যাপাবিলিটি ব্রিজ, সিঙ্ক নয়) মাধ্যমে ডেস্কটপ অ্যাপে সংযুক্ত হয়
• ডেস্কটপ অ্যাপটি রিস্টার্ট করুন এবং তারপর এক্সটেনশনটি পুনরায় লোড করুন
• ডেস্কটপ অ্যাপের অন্য কোনো কপি চলছে না তা নিশ্চিত করুন — একাধিক ইনস্ট্যান্স দ্বন্দ্ব তৈরি করে

ব্রাউজার খোলা থাকা সত্ত্বেও macOS-এ "ব্রাউজার সংযুক্ত নয়" সতর্কতা

• Caiioo এখন Chrome, Safari, Edge, এবং Firefox শনাক্ত করতে পারে — যেকোনো একটি সংযুক্ত হওয়ার মুহূর্তেই সতর্কতাটি দূর হয়ে যায়
• Safari একটি ভিন্ন চ্যানেলের মাধ্যমে সংযুক্ত হয় এবং এটি ফোরগ্রাউন্ড অ্যাপ না থাকলে সংক্ষিপ্তভাবে নিষ্ক্রিয় হতে পারে; এটি সংযুক্তই থাকে এবং কোনো কমান্ডের প্রয়োজন হলে Caiioo স্বয়ংক্রিয়ভাবে এটিকে সক্রিয় করে
• সতর্কতা অব্যাহত থাকলে, আপনার ব্রাউজারটি একবার সামনে নিয়ে আসুন, তারপর পুনরায় চেষ্টা করুন

বার্তার সংযুক্তি আপলোড হবে না

• ফাইল ফরম্যাট সমর্থিত কিনা তা পরীক্ষা করুন (PDF, ছবি, Word নথি, স্প্রেডশীট, প্রেজেন্টেশন)
• একটি ছোট ফাইল দিয়ে চেষ্টা করুন
• আপনার ইন্টারনেট সংযোগ আছে কিনা তা নিশ্চিত করুন

সাহায্য পাওয়া

• দ্রুত উত্তর: হেডার-এর ? আইকনে ক্লিক করুন
• সেটিংস ও ট্রাব্লশুটিং: গিয়ার আইকনে ক্লিক করুন
• এই গাইড: সেটিংস > সাহায্য > ডকুমেন্টেশন ও লিগ্যাল
• Caiioo কে আপনার জন্য একটি বাগ রিপোর্ট ফাইল করতে বলুন: এটিকে একটি সমস্যা রিপোর্ট করতে বলুন এবং এটি আপনার পর্যালোচনা ও পাঠানোর জন্য একটি বিস্তারিত বিবরণ সহ অন্তর্নির্মিত সাপোর্ট ফর্ম খুলে দেবে। "শুধু এটি ফাইল করুন" বলুন এবং — আপনার অনুমোদনে — এটি সরাসরি টিকিট জমা দেয়, কথোপকথনের টেকনিক্যাল বিবরণ যুক্ত করে যাতে টিম আপনি যা দেখেছেন তা পুনরুৎপাদন করতে পারে।

আরও দেখুন

• রিলিজ নোট — লেটেস্ট ভার্সনে কী পরিবর্তন হয়েছে
• গোপনীয়তা নীতি
• ব্যবহারের শর্তাবলী

---

This guide is maintained by the Caiioo team using Slate, our built-in editor.