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 आज से सामान्य रूप से उपलब्ध है। दस्तावेज़ पढ़ें और शुरू करें।