AI टूल सेटअप

DeepSeek Harness

DeepSeek Harness को नेटिव DeepSeek अडैप्टर या कस्टम OpenAI-compatible प्रदाता के ज़रिए Felo से जोड़ें।

इस गाइड का उपयोग करें जब आप ओपन-सोर्स DeepSeek Harness को Felo API Platform द्वारा दिए गए मॉडलों के साथ चलाना चाहते हैं। अनुशंसित तरीका harness के अंतर्निहित deepseek-official adapter का पुनः उपयोग करता है। आप Web UI में Felo को अलग कस्टम OpenAI-संगत प्रदाता के रूप में भी जोड़ सकते हैं।

DeepSeek Harness वर्तमान में developer preview है और संगतता तोड़ने वाले बदलाव ला सकता है। जब कोई विकल्प या स्क्रीन इस गाइड से अलग हो, तो उसके upstream release notes देखें।

शुरू करने से पहले

आपको Node.js और एक Felo API Platform key चाहिए। key को source control से बाहर रखें।

export FELO_API_KEY="YOUR_API_KEY"

उदाहरण deepseek-v4-flash का उपयोग करते हैं। कोई अन्य मॉडल ID चुनने से पहले Models and Pricing देखें।

अनुशंसित सेटअप: अंतर्निहित DeepSeek Adapter

DeepSeek Harness अंतर्निहित adapter की credential DEEPSEEK_API_KEY से और उसका endpoint DEEPSEEK_BASE_URL से पढ़ता है।

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

http://127.0.0.1:3080 खोलें, फिर:

अपना प्रोजेक्ट workspace जोड़ें या चुनें।
Settings → Models खोलें।
deepseek-official प्रदाता और deepseek-v4-flash मॉडल चुनें।
नया सेशन शुरू करें और एक छोटा रेपो कार्य भेजें।

base URL में /chat/completions न जोड़ें। अंतर्निहित adapter स्वयं {DEEPSEEK_BASE_URL}/chat/completions पर अनुरोध भेजता है।

Environment मान स्थायी करें

DeepSeek Harness उस डायरेक्टरी से .env फ़ाइल पढ़ सकता है जहां से आप उसे शुरू करते हैं। अगर आप हर सेशन के लिए मान export नहीं करना चाहते, तो अनट्रैक्ड .env फ़ाइल में निम्न मान जोड़ें:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

इस फ़ाइल को कमिट न करें। जब आपको user-level कॉन्फ़िगरेशन चाहिए तो आप $DSH_HOME के तहत harness credential और settings फ़ाइलें भी उपयोग कर सकते हैं।

वैकल्पिक सेटअप: कस्टम OpenAI-संगत प्रदाता

इस तरीके का उपयोग तब करें जब आप चाहते हैं कि Felo अंतर्निहित DeepSeek कनेक्शन को ओवरराइड करने के बजाय अलग प्रदाता के रूप में दिखे।

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 चुने हुए पूरा होता है और कोई प्रमाणीकरण या unknown-model त्रुटि नहीं दिखती।

अनुशंसित adapter के साथ गैर-इंटरैक्टिव smoke test के लिए, लक्ष्य workspace से चलाएं:

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 search चाहिए, तो Felo की Chat API या अन्य Felo Skills अलग से उपयोग करें।

समस्या निवारण

समस्या	क्या जांचें
`MISSING_CREDENTIAL` या 401	पुष्टि करें कि `dsh` शुरू करने वाली प्रक्रिया में `DEEPSEEK_API_KEY` में Felo key है
अनुरोध URL में पथ दो बार है	`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 कॉन्फ़िगर नहीं करती