Sign inGet Started

एजेंटों के लिए CLI

bird CLI एक ही बाइनरी है, जिसे एजेंट द्वारा चलाए जाने के लिए बनाया गया है। आउटपुट डिफ़ॉल्ट रूप से JSON होता है, त्रुटियाँ stderr पर जाती हैं और एग्ज़िट कोड विफलता की श्रेणी बताते हैं।

सेटअप करें

सबसे तेज़ तरीका है अपना कोडिंग एजेंट सेट अप करना: एक प्रॉम्प्ट पेस्ट करें और आपका एजेंट आपके लिए CLI और Bird की स्किल्स इंस्टॉल कर देता है। इसे मैन्युअल रूप से इंस्टॉल करने के लिए:

कोड उदाहरण
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth login

bird auth login ब्राउज़र में OAuth फ़्लो चलाता है और आपके वर्कस्पेस व उसके क्षेत्र से जुड़ा एक ग्रांट सहेजता है, इसलिए आपको API कुंजी या होस्ट कॉन्फ़िगर नहीं करना पड़ता। bird auth status हमेशा 0 के साथ बाहर निकलता है और टोकन काम करने पर valid: true रिपोर्ट करता है। bird whoami साइन-इन किए गए उपयोगकर्ता (ID, ईमेल और नाम) को लौटाता है। एजेंट इसी पहचान से काम करता है, और MCP whoami टूल भी यही पहचान लौटाता है।

अनुबंध

  • JSON stdout पर जाता है; त्रुटियाँ और डायग्नोस्टिक्स stderr पर जाते हैं; दोनों कभी मिलते नहीं।
  • एग्ज़िट कोड: छह अर्थपूर्ण कोड, जो उपयोग, नहीं मिला, ऑथ, टकराव, अस्थायी विफलताओं और एक सामान्य फ़ॉलबैक को कवर करते हैं। पूरी तालिका CLI में देखें।
  • बदलाव करने वाले कमांड इनपुट फ़्लैग से, --body-file - (stdin) के ज़रिए JSON बॉडी से, या दोनों से लेते हैं; दोनों होने पर फ़्लैग को प्राथमिकता मिलती है।
  • --example एक मान्य अनुरोध बॉडी प्रिंट करता है, --dry-run अनुरोध भेजे बिना उसका पूर्वावलोकन दिखाता है, और --idempotency-key फिर से प्रयास को सुरक्षित बनाता है।

अगले चरण

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।