AI টুল সেটআপ
DeepSeek Harness
নেটিভ DeepSeek অ্যাডাপ্টার বা কাস্টম OpenAI-compatible প্রোভাইডারের মাধ্যমে DeepSeek Harness-কে Felo-র সঙ্গে যুক্ত করুন।
Felo API Platform-এর পরিবেশন করা মডেলসহ ওপেন-সোর্স DeepSeek Harness চালাতে এই গাইডটি ব্যবহার করুন। প্রস্তাবিত পথটি harness-এর অন্তর্নির্মিত deepseek-official adapter পুনরায় ব্যবহার করে। আপনি Web UI-তে Felo-কে একটি আলাদা কাস্টম OpenAI-সামঞ্জস্যপূর্ণ প্রোভাইডার হিসেবেও যোগ করতে পারেন।
DeepSeek Harness বর্তমানে একটি ডেভেলপার প্রিভিউ এবং সামঞ্জস্য-ভাঙা পরিবর্তন আনতে পারে। কোনো অপশন বা স্ক্রিন এই গাইড থেকে ভিন্ন হলে এর আপস্ট্রিম রিলিজ নোট দেখুন।
শুরু করার আগে
আপনার Node.js এবং একটি Felo API Platform key প্রয়োজন। key সোর্স কন্ট্রোলের বাইরে রাখুন।
export FELO_API_KEY="YOUR_API_KEY"উদাহরণগুলো deepseek-v4-flash ব্যবহার করে। ভিন্ন মডেল ID বেছে নেওয়ার আগে Models and Pricing দেখুন।
প্রস্তাবিত সেটআপ: অন্তর্নির্মিত DeepSeek Adapter
DeepSeek Harness DEEPSEEK_API_KEY থেকে অন্তর্নির্মিত adapter credential এবং DEEPSEEK_BASE_URL থেকে এর endpoint পড়ে।
export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh webhttp://127.0.0.1:3080 খুলুন, তারপর:
- আপনার প্রজেক্ট ওয়ার্কস্পেস যোগ করুন বা নির্বাচন করুন।
- Settings → Models খুলুন।
deepseek-officialপ্রোভাইডার ওdeepseek-v4-flashমডেল নির্বাচন করুন।- একটি নতুন সেশন শুরু করে একটি ছোট রেপো টাস্ক পাঠান।
base URL-এ /chat/completions যোগ করবেন না। অন্তর্নির্মিত adapter নিজেই {DEEPSEEK_BASE_URL}/chat/completions-এ অনুরোধ পাঠায়।
পরিবেশ মান স্থায়ী করুন
DeepSeek Harness আপনি যে ডিরেক্টরি থেকে এটি শুরু করেন সেখানকার .env ফাইল পড়তে পারে। প্রতিটি সেশনের জন্য এক্সপোর্ট করতে না চাইলে একটি untracked .env ফাইলে নিচের মানগুলো যোগ করুন:
DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1এই ফাইলটি কমিট করবেন না। ইউজার-লেভেল কনফিগারেশন দরকার হলে $DSH_HOME-এর অধীনে harness credential ও settings ফাইলও ব্যবহার করতে পারেন।
বিকল্প সেটআপ: কাস্টম OpenAI-সামঞ্জস্যপূর্ণ প্রোভাইডার
অন্তর্নির্মিত DeepSeek সংযোগ override করার বদলে Felo-কে আলাদা প্রোভাইডার হিসেবে দেখাতে চাইলে এই পথ ব্যবহার করুন।
npx @deepseek-ai/dsh webদিয়ে Web UI শুরু করুন।- Settings → Models খুলুন।
- Add custom provider বেছে নিন।
- নিচের মানগুলো লিখে প্রোভাইডার সংরক্ষণ করুন।
| ফিল্ড | মান |
|---|---|
| Provider ID | felo |
| Display name | Felo API Platform |
| Base URL | https://openapi.felo.ai/api/v1 |
| API protocol | OpenAI-সামঞ্জস্যপূর্ণ Chat Completions (openai-completions) |
| API key | আপনার Felo API key |
| Model ID | deepseek-v4-flash |
মডেল ডিসকভারি ব্যর্থ হলে মডেল ID ম্যানুয়ালি যোগ করুন। একটি প্রোভাইডারের Get available models অ্যাকশন OpenAI-সামঞ্জস্যপূর্ণ GET /models রুটের উপর নির্ভর করে এবং ম্যানুয়াল কনফিগারেশনের জন্য আবশ্যক নয়।
সেটআপ যাচাই করুন
একটি নতুন সেশন শুরু করে জিজ্ঞাসা করুন:
Summarize this repository and identify its main packages.deepseek-v4-flash নির্বাচিত অবস্থায় সেশন সম্পূর্ণ হলে এবং কোনো প্রমাণীকরণ বা অজানা-মডেল ত্রুটি না এলে সেটআপ প্রস্তুত।
প্রস্তাবিত adapter দিয়ে নন-ইন্টারঅ্যাকটিভ smoke test-এর জন্য লক্ষ্য ওয়ার্কস্পেস থেকে চালান:
npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."Web Search নোট
এই সেটআপ Felo-র মাধ্যমে মডেল অনুরোধ রাউট করে। DeepSeek Harness-এর অন্তর্নির্মিত web_search প্রোভাইডারের আলাদা endpoint প্রয়োজনীয়তা আছে, যদিও এর ডিফল্ট credential ভেরিয়েবলও DEEPSEEK_API_KEY। স্পষ্টভাবে সামঞ্জস্যপূর্ণ search endpoint ব্যবহার না করলে DEEPSEEK_SEARCH_BASE_URL-কে Felo-তে নির্দেশ করবেন না। আপনার ওয়ার্কফ্লোর Felo সার্চ দরকার হলে Felo-র Chat API বা অন্যান্য Felo Skills আলাদাভাবে ব্যবহার করুন।
সমস্যা সমাধান
| সমস্যা | কী পরীক্ষা করবেন |
|---|---|
MISSING_CREDENTIAL বা 401 | dsh চালু করে এমন প্রসেসে DEEPSEEK_API_KEY-তে Felo key আছে তা নিশ্চিত করুন |
| অনুরোধ URL-এ path দুবার আছে | https://openapi.felo.ai/api/v1 ব্যবহার করুন, /chat/completions-এ শেষ হওয়া URL নয় |
UNKNOWN_MODEL | deepseek-v4-flash নির্বাচন বা ম্যানুয়ালি যোগ করুন, অথবা অন্য প্রকাশিত Felo মডেল ID ব্যবহার করুন |
| Felo আলাদাভাবে তালিকাভুক্ত নয় | কাস্টম-প্রোভাইডার সেটআপ ব্যবহার করুন; প্রস্তাবিত পথ প্রোভাইডার ID deepseek-official রাখে |
| সেটিংস বদলানো হয়েছে কিন্তু পুরোনো সেশন ভিন্নভাবে আচরণ করছে | নতুন সেশন শুরু করুন যাতে এটি নতুন নির্বাচিত প্রোভাইডার ও মডেল রুট ব্যবহার করে |
| Web search প্রমাণীকরণ ব্যর্থ | harness search প্রোভাইডার আলাদাভাবে কনফিগার করুন; মডেল endpoint সেটিংস web search কনফিগার করে না |