GuidesOneMux

प्रोडक्शन में Cline: सेशन कॉन्फ़िगर करें और सुरक्षित तरीके से रिकवर करें

ClineCore सेशन कॉन्फ़िगर करने, रनटाइम सेटिंग को प्रोवाइडर कॉन्फ़िगरेशन से अलग रखने और सुरक्षित रीट्राई व रिकवरी नियम बनाने की व्यावहारिक गाइड।

AI

सारांश · TL;DR

ClineCore रनटाइम के विकल्पों—जैसे बैकएंड मोड, क्षमताएँ, टूल नीतियाँ और ऑटोमेशन—को हर सेशन के लिए कॉन्फ़िगर किए गए प्रोवाइडर और मॉडल से अलग रखता है। यह गाइड बताती है कि इस अलगाव को स्पष्ट कैसे रखें और बिना सोचे-समझे काम दोहराने के बजाय सेशन ID और स्थायी रूप से सेव की गई स्थिति के आधार पर रिकवरी व्यवहार कैसे बनाएँ।

मुख्य बातें

  • रनटाइम, टूल अनुमतियों और प्रोवाइडर/मॉडल कॉन्फ़िगरेशन को अलग-अलग निर्णय मानें।
  • रीट्राई करने से पहले विफलताओं की जाँच के लिए सेशन ID और स्थायी रूप से सेव किए गए संदेशों का उपयोग करें।
  • मानकर चलें कि रीट्राई से साइड इफ़ेक्ट दोहराए जा सकते हैं; अपने वर्कफ़्लो के लिए चेकपॉइंट और रिकवरी नियम तय करें।
  • API संदर्भ में सेशन ऑपरेशन दर्ज हैं, लेकिन रीट्राई के अर्थ, चेकपॉइंट फ़ॉर्मैट या प्रोवाइडर संगतता की गारंटी निर्दिष्ट नहीं है।
इस पृष्ठ पर (9)

ClineCore ऐप्लिकेशन को सेशन बनाने, रनटाइम चुनने, टूल अनुमतियाँ तय करने और सेशन इतिहास देखने का नियंत्रण देता है। प्रोडक्शन वर्कफ़्लो चलाते समय मुख्य डिज़ाइन निर्णय सिर्फ़ यह नहीं है कि विफल कॉल को रीट्राई करना चाहिए या नहीं; बल्कि यह तय करना है कि काम दोबारा चलाने से पहले कैसे पता करें कि पहले ही क्या हो चुका है।

नीचे दिया गया कॉन्फ़िगरेशन केवल उदाहरण है, जाँची-परखी डिप्लॉयमेंट रेसिपी नहीं। ClineCore API संदर्भ में यहाँ चर्चा किए गए विकल्प और मेथड दर्ज हैं; सटीक टाइप और व्यवहार के लिए इंस्टॉल किए गए SDK का संस्करण देखें।

रनटाइम सेटिंग को मॉडल सेटिंग से अलग रखें

कॉन्फ़िगरेशन की एक उपयोगी सीमा के तीन हिस्से हैं:

  • रनटाइम: बैकएंड का चयन, क्लाइंट की पहचान और वैकल्पिक रिमोट या हब कनेक्शन सेटिंग।
  • एक्ज़ीक्यूशन नीति: टूल नीतियाँ, क्षमताएँ और ऑटोमेशन API चालू हैं या नहीं।
  • सेशन मॉडल कॉन्फ़िगरेशन: किसी खास सेशन के लिए प्रोवाइडर ID, मॉडल ID, क्रेडेंशियल, वर्कस्पेस पाथ और उपलब्ध टूल।

इससे मॉडल बदलने पर भी रनटाइम नीति को स्वतंत्र रूप से प्रबंधित करना आसान होता है। इसका यह मतलब नहीं कि प्रोवाइडर-विशिष्ट फ़ील्ड एक-दूसरे की जगह इस्तेमाल किए जा सकते हैं: चुने गए प्रोवाइडर के लिए providerId, modelId और apiKey अब भी मान्य होने चाहिए। API संदर्भ हर प्रोवाइडर या एंडपॉइंट के साथ संगतता की पुष्टि नहीं करता।

रनटाइम बनाएँ और सेशन शुरू करें

ज़रूरी तैयारी: जिस Cline SDK संस्करण को डिप्लॉय करना है, उसे इंस्टॉल करें; अपने ऐप्लिकेशन के सीक्रेट-मैनेजमेंट तरीके से क्रेडेंशियल दें; और तय करें कि एजेंट किन टूल का उपयोग कर सकता है। क्रेडेंशियल को लॉग या सेशन मेटाडेटा में न रखें।

import { ClineCore } from "@cline/sdk"

const cline = await ClineCore.create({
  clientName: "repo-maintenance-worker",
  backendMode: "auto",
  toolPolicies: {},
  automation: false,
})

const session = await cline.start({
  prompt: "Inspect the repository and report failing tests. Do not modify files.",
  source: "scheduled-check",
  interactive: false,
  sessionMetadata: { jobId: "job-123" },
  config: {
    providerId: "anthropic",
    modelId: "claude-sonnet-4-6",
    apiKey: process.env.ANTHROPIC_API_KEY,
    systemPrompt: "Follow the task scope and report actions taken.",
    cwd: process.cwd(),
    workspaceRoot: process.cwd(),
    enableTools: true,
    enableSpawnAgent: false,
    enableAgentTeams: false,
  },
})

console.log(session.sessionId)

ऊपर दिए गए प्रोवाइडर और मॉडल मान API संदर्भ के उदाहरण से लिए गए हैं; वे न तो सिफ़ारिश हैं और न ही उस उदाहरण से आगे प्रोवाइडर संगतता का दावा। संदर्भ में backendMode के auto, local, hub और remote मानों के साथ वैकल्पिक hub और remote सेटिंग भी दर्ज हैं। इसमें यह नहीं बताया गया है कि किसी खास डिप्लॉयमेंट के लिए कौन-सा मोड सबसे अच्छा है। सोच-समझकर चुनें, फिर अपने माहौल में कनेक्टिविटी और अनुमतियों की पुष्टि करें।

खाली toolPolicies ऑब्जेक्ट कोई सुरक्षा नीति नहीं है। इंस्टॉल किए गए SDK में समर्थित नीति टाइप के अनुसार स्पष्ट डिफ़ॉल्ट और हर सेशन की नीतियाँ तय करें। जब क्लाइंट टूल एक्ज़ीक्यूटर या अप्रूवल कॉलबैक देता हो, तब capabilities का उपयोग करें और जाँचें कि प्रतिबंधित कार्रवाइयाँ वास्तव में रोकी जाती हैं।

सेशन की स्थिति के आधार पर रीट्राई नियम बनाएँ

नेटवर्क त्रुटि या वर्कर टाइमआउट से यह साबित नहीं होता कि एजेंट ने काम पूरा होने से पहले रुकना शुरू कर दिया था। मूल प्रॉम्प्ट दोहराने से एडिट, बाहरी कॉल या अन्य साइड इफ़ेक्ट दोहराए जा सकते हैं। API संदर्भ में get, readMessages, getAccumulatedUsage, abort, stop और restore दर्ज हैं, लेकिन इसमें ऑटोमैटिक रीट्राई, ठीक एक बार एक्ज़ीक्यूशन या चेकपॉइंट की सामग्री निर्दिष्ट नहीं है।

एक अधिक सुरक्षित संचालन क्रम यह है:

  1. सेशन ID तुरंत दर्ज करें। इसे अपने जॉब ID के साथ सेव करें, ताकि रीस्टार्ट हुआ वर्कर उसी सेशन को ढूँढ़ सके।
  2. विफलता का प्रकार तय करें। पुष्ट अंतिम विफलता को ऐसे टाइमआउट या कनेक्शन टूटने से अलग रखें जहाँ काम पूरा हुआ या नहीं, यह अनिश्चित हो।
  3. दोबारा सबमिट करने से पहले जाँचें। सेशन मेटाडेटा और सेव किए गए संदेश देखने के लिए get और readMessages का उपयोग करें। जहाँ प्रासंगिक हो, संचित उपयोग की जाँच एक संचालन-संबंधी संकेत के रूप में करें—इस बात के प्रमाण के रूप में नहीं कि कोई खास कार्रवाई पूरी हुई।
  4. सोच-समझकर रिकवरी का तरीका चुनें। अगर सेशन अब भी सक्रिय है, तो तय करें कि इंतज़ार करना है, abort करना है या stop। अगर काम जारी रखना है, तो send में सेशन ID और फ़ॉलो-अप प्रॉम्प्ट दिया जा सकता है। अगर कोई चेकपॉइंट उपलब्ध और उपयुक्त है, तो API restore देता है; इसके लिए ज़रूरी इनपुट और अर्थ जानने के लिए SDK दस्तावेज़ देखें।
  5. साइड इफ़ेक्ट को दोहराने के लिए सुरक्षित बनाएँ। एजेंट के अपने सेशन स्टेट से बाहर की कार्रवाइयों के लिए, जहाँ उचित हो, ऐप्लिकेशन-स्तर की idempotency key, डुप्लिकेशन हटाने की व्यवस्था या इंसानी अप्रूवल चरण इस्तेमाल करें।

start को बिना शर्त रीट्राई करने वाले लूप में न लपेटें। अगर कॉलर को जवाब मिलने से पहले शुरुआती अनुरोध से सेशन बन गया हो, तो दूसरा start अलग काम शुरू कर सकता है। API संदर्भ में start के लिए idempotency key दर्ज नहीं है, इसलिए यह न मानें कि ऐसी कोई key मौजूद है।

प्रोडक्शन की आम समस्याओं का निवारण

सेशन गलत रनटाइम के साथ शुरू होता है

चुना गया बैकएंड मोड और गैर-गोपनीय सेशन पहचानकर्ता लॉग करें। जिस माहौल में वर्कर चलता है, उसके अनुसार backendMode, hub और remote विकल्प जाँचें। संदर्भ इन्हें रनटाइम चुनने के विकल्प बताता है, लेकिन ऑटोमैटिक फ़ेलओवर का व्यवहार दर्ज नहीं करता। इसलिए किसी अनुमानित फ़ॉलबैक पर निर्भर रहने के बजाय अपने SDK संस्करण में auto का व्यवहार जाँचें।

टूल उपलब्ध नहीं हैं या अनपेक्षित रूप से अनुमति पा रहे हैं

सेशन के config के साथ लागू डिफ़ॉल्ट और प्रति-सेशन toolPolicies या capabilities जाँचें। संदर्भ इन्हें टूल नीति और क्लाइंट के स्वामित्व वाले एक्ज़ीक्यूटर/अप्रूवल नियंत्रण के रूप में बताता है। दिए गए API सारांश में नीति की प्राथमिकता का विवरण नहीं है; इसलिए इंस्टॉल किए गए SDK के दस्तावेज़ में प्राथमिकता की पुष्टि करें और अनुमति व अस्वीकृति—दोनों स्थितियों की जाँच करें।

वर्कर का रन के बीच में कनेक्शन टूट जाता है

सेशन ID और जॉब ID को ऐप्लिकेशन की स्थायी स्थिति में रखें। रीस्टार्ट होने पर, send से आगे बढ़ने, सेशन रोकने या चेकपॉइंट से रिकवर करने का निर्णय लेने से पहले मौजूदा सेशन की जाँच करें। सिर्फ़ जवाब न मिलने से काम पूरा होने का निष्कर्ष न निकालें।

प्रोवाइडर या मॉडल कॉन्फ़िगरेशन विफल होता है

चुने गए सेटअप के लिए प्रोवाइडर और Cline के दस्तावेज़ों में प्रोवाइडर ID, मॉडल ID, क्रेडेंशियल और एंडपॉइंट की ज़रूरतों की पुष्टि करें। ClineCore संदर्भ में प्रोवाइडर/मॉडल कॉन्फ़िगरेशन का एक रूप दिखाया गया है; यह गारंटी नहीं देता कि मनमाने OpenAI-संगत एंडपॉइंट या प्रोवाइडर-विशिष्ट पैरामीटर बिना बदलाव काम करेंगे।

प्रोडक्शन चेकलिस्ट

  • सेशन ID को स्थायी रूप से सेव करें और लॉग व मेटाडेटा से सीक्रेट बाहर रखें।
  • टूल अनुमतियाँ स्पष्ट रूप से तय करें; अप्रूवल और अस्वीकृति के रास्तों की जाँच करें।
  • विफल ऑपरेशन और ऐसे ऑपरेशन में फ़र्क करें जिसका परिणाम अज्ञात हो।
  • काम दोबारा सबमिट करने से पहले सेशन इतिहास देखें।
  • बाहरी साइड इफ़ेक्ट को idempotent बनाएँ या उन्हें दोहराने से पहले अप्रूवल ज़रूरी करें।
  • वास्तविक डिप्लॉयमेंट माहौल में बैकएंड और प्रोवाइडर के व्यवहार की पुष्टि करें।
  • व्यवस्थित शटडाउन के दौरान SDK के दस्तावेज़ित लाइफ़साइकल का पालन करते हुए रनटाइम संसाधन मुक्त करें।

व्यावहारिक नियम सरल है: रीट्राई तभी करें जब आपको पता हो कि आप किस चीज़ को दोहरा रहे हैं। ClineCore सेशन और रिकवरी से जुड़े API देता है, लेकिन प्रोडक्शन में सुरक्षित व्यवहार अब भी आपके ऐप्लिकेशन की स्थायी जॉब ट्रैकिंग, अनुमति डिज़ाइन और दोहराए गए साइड इफ़ेक्ट को संभालने के तरीके पर निर्भर करता है।

सामान्य प्रश्न

ClineCore की कौन-सी सेटिंग मॉडल प्रोवाइडर से स्वतंत्र हैं?

`clientName`, `backendMode`, वैकल्पिक हब या रिमोट सेटिंग, क्षमताएँ, टूल नीतियाँ और ऑटोमेशन जैसे रनटाइम विकल्प सेशन के प्रोवाइडर और मॉडल फ़ील्ड से अलग हैं। विकल्पों का सटीक व्यवहार इस्तेमाल किए जा रहे SDK संस्करण के अनुसार जाँचना चाहिए।

क्या टाइमआउट के बाद मुझे ClineCore.start रीट्राई करना चाहिए?

बिना जाँच के नहीं। टाइमआउट से यह पता नहीं चलता कि सेशन बना था या नहीं। उपलब्ध होने पर सेशन ID सेव करें और नया काम शुरू करने से पहले मौजूदा सेशन जाँचें। दिए गए API संदर्भ में `start` के लिए idempotency key दर्ज नहीं है।

क्या ClineCore विफल सेशन को रीस्टोर कर सकता है?

API संदर्भ में `restore` मेथड दर्ज है, लेकिन दिए गए सारांश में इसके लिए ज़रूरी इनपुट या चेकपॉइंट का अर्थ निर्दिष्ट नहीं है। इसके आधार पर रिकवरी डिज़ाइन करने से पहले इंस्टॉल किए गए SDK के दस्तावेज़ देखें।

क्या यह कॉन्फ़िगरेशन किसी भी OpenAI-संगत प्रोवाइडर के साथ काम करता है?

उद्धृत ClineCore संदर्भ इसकी पुष्टि नहीं करता। प्रोवाइडर की संगतता और स्वीकार किए जाने वाले पैरामीटर, एंडपॉइंट और चुने गए प्रोवाइडर कॉन्फ़िगरेशन के लिए दस्तावेज़ित समर्थन पर निर्भर करते हैं; उन्हें एक-दूसरे के बदले इस्तेमाल किया जा सकता है, यह मानने के बजाय उनकी पुष्टि करें।

संबंधित लेख

Guides

दोहराए जा सकने वाले कोडिंग-एजेंट मूल्यांकनों के लिए Cline को कैसे कॉन्फ़िगर करें

निश्चित इनपुट, स्पष्ट टूल सीमाओं, दोहराए जा सकने वाले टेस्ट केस और समस्या-निवारण चेकलिस्ट के साथ ClineCore सेशन कॉन्फ़िगर करें।

阅读全文 →

Guides

API Incident की जाँच के लिए Cline कॉन्फ़िगर करें

API incident की जाँच के लिए Cline SDK session कॉन्फ़िगर करें, provider से स्वतंत्र runtime settings चुनें और दिखाई देने वाले failure signals के आधार पर troubleshooting करें।

阅读全文 →

Guides

भरोसेमंद retry और recovery निर्णयों के लिए Hugging Face मॉडलों का मूल्यांकन

प्रोडक्शन में retry और recovery निर्णयों के लिए Hugging Face मॉडलों की तुलना करने हेतु एक दोहराने योग्य, कार्य-विशिष्ट मूल्यांकन तैयार करें।

阅读全文 →

Guides

गोपनीयता-सचेत कोडिंग सत्रों के लिए ClineCore कॉन्फ़िगर करें

ClineCore सत्र कॉन्फ़िगर करने, संवेदनशील डेटा का खुलासा सीमित रखने और सेटअप की आम समस्याएँ सुलझाने के लिए एक व्यावहारिक मार्गदर्शिका।

阅读全文 →