Agent SDK

Agent SDK आज से उपलब्ध है। इसकी मदद से आप किसी एजेंट को कोड के एक फ़ोल्डर के रूप में परिभाषित कर सकते हैं, evals से उसका परीक्षण कर सकते हैं, और उसे Cursor या अपनी अवसंरचना पर डिप्लॉय कर सकते हैं।

npx @cursor/agent-sdk init ./my-bot चलाएँ, फिर बॉट को playground के साथ स्थानीय रूप से शुरू करने के लिए agent-sdk dev चलाएँ। सुरक्षा समीक्षक, owners-policy अनुमोदक, PR ऑटोफिक्सर, या Linear या Jira के लिए प्राथमिकता निर्धारण बॉट जैसे टेम्पलेट से शुरुआत करने के लिए --template पास करें।

जहाँ भी ज़रूरत हो, वहाँ एजेंट डिप्लॉय करें

जब आप किसी एजेंट को इस्तेमाल में लाने के लिए तैयार हों, तो प्रोजेक्ट डायरेक्टरी से agent-sdk deploy चलाकर उसे Cursor पर डिप्लॉय कर सकते हैं। यह कमांड एजेंट को बिल्ड करती है, उसे एक URL देती है और उसे हमारी अवसंरचना पर शुरू कर देती है। आप डैशबोर्ड से सीक्रेट्स और इंटीग्रेशन प्रबंधित कर सकते हैं, और साथ ही स्थानीय रूप से उपलब्ध वही लॉग्स, evals और playground इस्तेमाल करते रह सकते हैं।

कोड के रूप में एजेंट

हर एजेंट एक प्रोजेक्ट होता है। instructions.md इसका प्रॉम्प्ट है। tools/ में मौजूद हर फ़ाइल एक टाइप की गई कार्रवाई है, जिसे मॉडल कॉल कर सकता है। skills/ में वे प्रक्रियाएँ रहती हैं जिन्हें मॉडल ज़रूरत पड़ने पर लोड करता है, mcp-connections/ MCP सर्वर से टूल जोड़ता है, और channels/ यह तय करता है कि बॉट किन जगहों पर संदेश प्राप्त करता है और उनका जवाब देता है। agent-sdk validate प्रोजेक्ट की जाँच करता है, और agent-sdk info प्रिंट करता है कि क्या-क्या खोजा गया।

चैनल

एजेंट्स GitHub, GitLab और Bitbucket से आने वाले पुल रिक्वेस्ट, टिप्पणी और CI इवेंट्स पर; Slack में उल्लेख और DMs पर; किसी भी प्रदाता से आने वाले वेबहुक्स पर; और cron समय-सारणी के अनुसार सक्रिय होते हैं। GitHub इवेंट्स आपके Cursor खाते के ज़रिए प्राप्त किए जाते हैं, इसलिए किसी सार्वजनिक वेबहुक URL की ज़रूरत नहीं पड़ती। Slack के लिए बिना किसी अतिरिक्त सेटअप के बेहतरीन समर्थन उपलब्ध है।

हर बातचीत का अपना अलग सत्र होता है, जिसमें हर संदेश और टूल कॉल का पूरा रिकॉर्ड रहता है। किसी पुल रिक्वेस्ट या Slack थ्रेड पर आने वाले अनुवर्ती प्रश्नों पर वही सत्र फिर से शुरू होता है।

Evals

eval बॉट को एक तय संदेश भेजता है और जाँचता है कि बॉट ने क्या किया: कौन-से टूल चले, किस इनपुट के साथ चले, और जवाब का स्वरूप कैसा है। agent-sdk eval को स्थानीय रूप से या CI में चलाएँ।

agent-sdk github replay <pr-url> किसी वास्तविक पुल रिक्वेस्ट को साइन किए गए वेबहुक पेलोड में बदलकर बॉट को भेजता है, ताकि GitHub से संचालित बॉट्स का परीक्षण किसी पुश का इंतज़ार किए बिना किया जा सके। पेलोड को eval फ़िक्स्चर के रूप में सहेजने के लिए --dry-run --fixtures-dir fixtures/ जोड़ें।

शुरू करें

Agent SDK आज से सामान्य रूप से उपलब्ध है। दस्तावेज़ पढ़ें और शुरू करें।

क्लाउड एजेंट कैनवस और परिवेश में सुधार

क्लाउड एजेंट से कैनवस

क्लाउड एजेंट अब अपने काम के दौरान इंटरैक्टिव कैनवस बिल्ड कर सकते हैं। तैयार कैनवस का लिंक भेजकर उसे अपनी टीम के साथ साझा करें।

कैनवस साझा करने के बारे में और जानें।

Environments API

Environments API अब बीटा में उपलब्ध है। इसकी मदद से आप उन क्लाउड परिवेशों को प्रोग्रामेटिक रूप से बना और प्रबंधित कर सकते हैं, जिनमें आपके एजेंट चलते हैं।

बड़े और तेज़ परिवेश

क्लाउड एजेंट परिवेश अब अधिकतम 300 रिपॉज़िटरी का समर्थन करते हैं। साथ ही, बड़े परिवेश अब 5 गुना तेज़ी से लोड होते हैं।

Origin App मार्केटप्लेस

Origin अब परिनियोजन, CI, कोड समीक्षा, सुरक्षा, निगरानी और प्रोजेक्ट प्रबंधन के लिए 20 से ज़्यादा ऐप्स के साथ एकीकृत होता है। ये ऐप्स Cloudflare, Linear, Sentry और Socket Security जैसे पार्टनर उपलब्ध कराते हैं।

आज से मार्केटप्लेस सार्वजनिक सबमिशन के लिए भी खुला है, यानी डेवलपर टूल बनाने वाली कोई भी टीम Origin के लिए अपना ऐप प्रकाशित कर सकती है।

आपके स्टैक के लिए ऐप

मार्केटप्लेस में अब इन श्रेणियों के ऐप शामिल हैं:

Origin App मार्केटप्लेस, जिसमें परिनियोजन, CI, कोड समीक्षा, सुरक्षा, निगरानी और प्रोजेक्ट प्रबंधन से जुड़े ऐप सूचीबद्ध हैं

मार्केटप्लेस पर प्रकाशित करें

ऐप सबमिट करने के लिए:

  1. अपने namespace में एक ऐप बनाएँ। जब तक आप इसे बिल्ड कर रहे हैं, यह आपके namespace तक ही निजी रहता है।
  2. Origin API का उपयोग करके बिल्ड करें। ऐप्स app JWT और इंस्टॉलेशन एक्सेस टोकन के ज़रिए प्रमाणित होते हैं, वेबहुक इवेंट्स प्राप्त करते हैं, और check runs, पुल रिक्वेस्ट टिप्पणियाँ और समीक्षाएँ वापस लिखते हैं।
  3. ऐप को सार्वजनिक करें, फिर ऐप के पेज से slug, सुझाए गए टैग और एक डेमो वीडियो के साथ उसे सबमिट करें। वीडियो में इंस्टॉल और अनइंस्टॉल की प्रक्रिया के साथ-साथ आपके उत्पाद के मुख्य फ़्लो भी दिखने चाहिए।
  4. हम सबमिशन की समीक्षा करते हैं और स्वीकृति मिलने के बाद ऐप को सूचीबद्ध कर देते हैं।
Origin App मार्केटप्लेस पर ऐप सबमिट करना

शुरू करें

Origin App मार्केटप्लेस में मौजूद ऐप्स आज ही आज़माएँ।

Origin ऐप बिल्ड करना चाहते हैं? प्रकाशन गाइड और Origin API संदर्भ से शुरू करें।

Origin Apps प्लगइन लाइव Origin API दस्तावेज़ के आधार पर आपके प्रश्नों के उत्तर भी दे सकता है। साथ ही, यह आपके पहले से चल रहे ऐप को Origin पर पोर्ट करने की योजना भी बना सकता है।

लोकल एजेंट के लिए रिमोट कंट्रोल

अब आप Cursor iOS ऐप से अपने कंप्यूटर पर चल रहे लोकल एजेंट देख सकते हैं और उन्हें जवाब भी दे सकते हैं।

शुरू करें

रिमोट कंट्रोल Enterprise संगठनों को छोड़कर बाकी सभी के लिए डिफ़ॉल्ट रूप से चालू है।

Cursor iOS ऐप डाउनलोड करें और साइन इन करें। आपके खाते से जुड़े कंप्यूटर ऐप में स्वचालित रूप से दिखाई देंगे। ऐप में अपने कंप्यूटर पर टैप करें, फिर Cursor डेस्कटॉप ऐप में पेयरिंग अनुरोध स्वीकृत करें। इसके बाद आपके लोकल एजेंट एक सूची में दिखाई देंगे। किसी एजेंट पर टैप करके देखें कि वह क्या कर रहा है, या उसे संदेश भेजें।

Cursor iOS ऐप में लोकल एजेंट के लिए रिमोट कंट्रोल

एजेंट्स आपके कंप्यूटर पर ही चलते रहते हैं

रिमोट कंट्रोल आपके एजेंट को कहीं और नहीं ले जाता। वे आपके कंप्यूटर पर ही चलते रहते हैं, और ऐप बस उनसे कनेक्ट होता है। रिमोट कंट्रोल काम करे, इसके लिए आपके कंप्यूटर का चालू और ऑनलाइन रहना आवश्यक है।

अपने कंप्यूटर को स्लीप मोड में जाने से रोकें

जब आप कंप्यूटर से दूर हों, तब उसे स्लीप मोड में जाने से रोकने के लिए Cursor की डेस्कटॉप सेटिंग्स में रिमोट कंट्रोल के अंतर्गत "Keep this computer awake" चालू करें। ध्यान रखें कि आपका कंप्यूटर चार्जर से जुड़ा हो और उसका लिड खुला हो।

एंटरप्राइज़ टीमों के लिए

Enterprise संगठनों को छोड़कर, रिमोट कंट्रोल डिफ़ॉल्ट रूप से चालू रहता है। एंटरप्राइज़ एडमिन इसे Org settings > Security and identity > रिमोट कंट्रोल में जाकर चालू कर सकते हैं।

रिमोट कंट्रोल के काम करने के लिए क्लाउड एजेंट ज़रूरी नहीं हैं।

रिमोट कंट्रोल अब Cursor iOS app में उपलब्ध है।

Rollouts और सुरक्षा समीक्षा

आज हम कोड शिप करने के आख़िरी पड़ाव के लिए दो Cursor बॉट लॉन्च कर रहे हैं। Rollouts डिप्लॉय होते हर परिवर्तन पर नज़र रखता है और हर परिवेश में उसके स्वास्थ्य की रिपोर्ट देता है। सुरक्षा समीक्षा हर पुल रिक्वेस्ट में ऐसे बग्स की रिपोर्ट करती है जिनका एक्सप्लॉइट किया जा सकता है।

दोनों आज से टीम और Enterprise प्लान पर उपलब्ध हैं।

Rollouts

Rollouts हर पुल रिक्वेस्ट के साथ एक मॉनिटर संलग्न करता है और परिवर्तन के डिप्लॉय होते समय उस पर नज़र रखता है। यह हर परिवेश के लिए परिवर्तन के स्वास्थ्य की रिपोर्ट देता है: सत्यापित रूप से स्वस्थ, रिग्रेशन का पता चला, या अनिर्णायक। यह Firetiger Change Monitors का Cursor संस्करण है, जिसे Bot Development Kit की मदद से नए सिरे से बनाया गया है।

इसे डैशबोर्ड से सक्षम करें और अपना सोर्स कंट्रोल, डिप्लॉय सिस्टम और टेलीमेट्री प्रदाता कनेक्ट करें। अगली पुल रिक्वेस्ट से Rollouts निगरानी शुरू कर देगा।

निगरानी योजनाएँ

जब कोई पुल रिक्वेस्ट खुलता है, तो Rollouts डिफ और उससे प्रभावित सिस्टम को पढ़ता है, फिर PR टिप्पणी के रूप में एक निगरानी योजना लिखता है। इस योजना में पहचाने गए जोखिम, परिवर्तन से अपेक्षित प्रभाव, वे संकेत जिनकी वह जाँच करेगा, और इंस्ट्रुमेंटेशन की वे कमियाँ शामिल होती हैं जिनकी वजह से परिवर्तन को सत्यापित करना मुश्किल हो सकता है। PR में योजना संपादित करें, Rollouts आपके संस्करण का ही उपयोग करेगा।

डिप्लॉय ट्रैकिंग

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

रिग्रेशन

जब Rollouts किसी रिग्रेशन का पता लगाता है, तो वह उस परिवर्तन की पहचान करता है जिस पर उसे संदेह है और उसके लेखक को सूचित करता है। कॉन्फ़िगरेशन के आधार पर, यह समीक्षा के लिए एक revert PR भी खोल सकता है या समस्या ठीक करने के लिए यह जानकारी किसी क्लाउड एजेंट को सौंप सकता है। फ़िलहाल Rollouts अपने आप न तो मर्ज करता है और न ही रोल बैक करता है।

इंटीग्रेशन

Rollouts सोर्स कंट्रोल के लिए Origin या GitHub से, डिप्लॉय इवेंट्स के लिए आपके कंटीन्यूअस डिलीवरी सिस्टम से, और संकेतों के लिए Datadog व अन्य टेलीमेट्री प्रदाताओं से कनेक्ट होता है। फ़ीचर फ़्लैग इंटीग्रेशन जल्द आ रहा है।

सुरक्षा समीक्षा

सुरक्षा समीक्षा आज से उपलब्ध है। यह हर पुल रिक्वेस्ट को कोडबेस के संदर्भ में पढ़ती है और एक समीक्षा टिप्पणी पोस्ट करती है, जिसमें ऐसे बग्स की रिपोर्ट होती है जिनका एक्सप्लॉइट किया जा सकता है। स्टाइल और गुणवत्ता की समीक्षा पहले की तरह Bugbot ही करेगा।

पुल रिक्वेस्ट पर सुरक्षा समीक्षा की टिप्पणी, जिसमें ऐसे बग की रिपोर्ट है जिसका एक्सप्लॉइट किया जा सकता है, साथ ही उसकी गंभीरता और सुझाया गया समाधान भी दिया गया है

आप जिन रिपॉज़िटरी की समीक्षा करवाना चाहते हैं, उनके लिए इसे डैशबोर्ड से सक्षम करें। ड्राफ़्ट PRs की समीक्षा नहीं की जाती।

यह क्या रिपोर्ट करता है

सुरक्षा समीक्षा SQL, कमांड और टेम्पलेट इंटरफ़ेस में इंजेक्शन की जाँच करती है। साथ ही यह प्रमाणीकरण और प्राधिकरण बायपास का भी पता लगाती है, जिसमें वे जाँचें भी शामिल हैं जो किसी रीफ़ैक्टर के बाद चलना बंद हो गई हों। यह स्रोत कोड में कमिट किए गए सीक्रेट्स और क्रेडेंशियल्स, SSRF और असत्यापित रीडायरेक्ट, असुरक्षित डीसीरियलाइज़ेशन, और ऐसे निर्भरता परिवर्तनों को भी फ़्लैग करती है जिनसे ज्ञात कमज़ोरियाँ आ जाती हैं। यह ट्रेस करती है कि उपयोगकर्ता इनपुट कहाँ से आता है और किन-किन चरणों से होकर गुज़रता है।

निष्कर्ष

हर निष्कर्ष में उसकी गंभीरता, हमले का पाथ और उसे ठीक करने का एक सुझाया गया तरीका शामिल होता है। अगर आप किसी निष्कर्ष को कारण बताकर खारिज कर देते हैं, तो सुरक्षा समीक्षा उस PR पर उसे दोबारा नहीं उठाएगी।

टीम नियम

अपने कोडबेस के लिए नियम जोड़ें, जैसे कि बाहरी कॉल किस क्लाइंट से होकर जानी चाहिए या किन टेबल्स को किसी अनुरोध हैंडलर से कभी क्वेरी नहीं किया जाना चाहिए। सुरक्षा समीक्षा इन नियमों को हर PR पर लागू करती है।

शुरू करें

Rollouts और सुरक्षा समीक्षक आज से टीम और Enterprise प्लान पर उपलब्ध हैं। स्वचालन टैब से इनमें से किसी भी बॉट को सक्षम करें।

अगले 10 दिनों तक हम उपयोग क्रेडिट्स दे रहे हैं, ताकि टीमें वास्तविक परिवर्तनों पर Rollouts आज़मा सकें। टीम ग्राहकों को लगभग 50 और एंटरप्राइज़ ग्राहकों को लगभग 500 परिवर्तनों के लिए क्रेडिट्स मिलेंगे।