Routines and headless

क्लाउड कोड (Cloud Code) के मुख्य अवधारणाएँ

• रूटीन (Routines):
• यह एक स्वचालित कार्य है जिसे मैन्युअल हस्तक्षेप के बिना क्लाउड पर चलाया जाता है।
• इसमें एक प्रॉम्प्ट (prompt), रिपॉजिटरी (repository), और आवश्यक कनेक्टर्स का एक बंडल होता है।
• यह ट्रिगर पर चलता है: क्रॉन शेड्यूल (cron schedule), API एंडपॉइंट पर HTTP पोस्ट, या GitHub इवेंट (जैसे नया पुल रिक्वेस्ट)।
• यह Anthropix द्वारा प्रबंधित बुनियादी ढांचे (infrastructure) पर चलता है, इसलिए आपको कोई सर्वर होस्ट करने की आवश्यकता नहीं होती।
• उपयोग: दोहराए जाने वाले कार्यों (repeat work) के लिए डिफ़ॉल्ट विकल्प।
• सीमाएँ: यह एक रिसर्च प्रीव्यू है; व्यवहार और सीमाएँ बदल सकती हैं। यह अधिकतम प्रति घंटे चलता है।

• हेडलेस मोड (Headless Mode):
• जब कार्य को आपके अपने स्क्रिप्ट या एप्लिकेशन के भीतर पूर्ण नियंत्रण की आवश्यकता होती है, तो इसका उपयोग किया जाता है।
• --P फ्लैग का उपयोग क्लाउड कोड को एक वन-शॉट कमांड के रूप में पाइप करने के लिए किया जाता है।
• यह मानक इनपुट (standard in) और मानक आउटपुट (standard out) को पढ़ता है, जिससे यह किसी अन्य शेल टूल की तरह पाइप किया जा सकता है।
• --bear का उपयोग हुक्स, स्किल्स, प्लगइन्स आदि की ऑटो-डिस्कवरी को रोकता है, जिससे स्टार्टअप तेज़ होता है।
• उपयोग: जब कार्य को आपके स्थानीय पाइपलाइन की आवश्यकता होती है।

• एजेंट SDK (Agent SDK):
• यह एक लाइब्रेरी प्रदान करता है जो क्लाउड कोड को आपके स्वयं के TypeScript या Python एप्लिकेशन में एम्बेड करती है।
• यह आपके कोड को क्वेरी फ़ंक्शन और स्कीमा के साथ मूल कार्यक्षमता प्रदान करता है।
• उपयोग: जब कार्य आपके स्वयं के उत्पाद (product) के भीतर होना चाहिए।

• संरचित आउटपुट और स्कीमा (Structured Output & Schema):
• आप आउटपुट फॉर्मेट को JSON के रूप में सेट कर सकते हैं और एक JSON स्कीमा के साथ क्लाउड को आउटपुट संरचना को उस स्कीमा से मेल खाने के लिए बाध्य कर सकते हैं।
• स्कीमा मैचिंग ऑब्जेक्ट को JSON रिस्पॉन्स के संरचित आउटपुट फ़ील्ड में लैंड किया जाता है, जिसे jq कमांड से निकाला जा सकता है।

• बहु-चरणीय स्वचालन (Multi-step Automation):
• आप JSON आउटपुट से सत्र आईडी (session ID) कैप्चर करके कार्य को बाद में फिर से शुरू कर सकते हैं, जिससे पूरा संदर्भ (full context) बना रहता है।

संक्षेप में चुनाव:

• रूटीन: दोहराए जाने वाले कार्य (Repeat work) → Anthropix इंफ्रास्ट्रक्चर पर चलता है।
• हेडलेस मोड: जब कार्य को आपकी पाइपलाइन की आवश्यकता हो → डेटा को स्क्रिप्ट के माध्यम से पाइप करने के लिए।
• एजेंट SDK: जब कार्य आपके स्वयं के उत्पाद के भीतर हो → आपके कोड के अंदर क्लाउड कोड एम्बेड करने के लिए।

Takeaways

• रूटीन (Routines) स्वचालित, दोहराए जाने वाले कार्यों के लिए हैं जो Anthropix इंफ्रास्ट्रक्चर पर ट्रिगर के आधार पर चलते हैं।
• हेडलेस मोड (Headless Mode) का उपयोग क्लाउड कोड को बाहरी स्क्रिप्ट या पाइपलाइन में मानक इनपुट/आउटपुट के माध्यम से एकीकृत करने के लिए किया जाता है।
• एजेंट SDK (Agent SDK) क्लाउड कोड की कार्यक्षमता को सीधे कस्टम एप्लीकेशन (जैसे TypeScript या Python) के भीतर एम्बेड करने की अनुमति देता है।
• संरचित आउटपुट और स्कीमा (Structured Output & Schema) यह सुनिश्चित करते हैं कि क्लाउड का आउटपुट एक विशिष्ट JSON संरचना का पालन करे।
• बहु-चरणीय स्वचालन (Multi-step Automation) सत्र आईडी का उपयोग करके कार्यों के बीच संदर्भ (context) को बनाए रखने में मदद करता है।