CLI

Failproof AI Observability को टर्मिनल या स्क्रिप्ट से पूरी तरह चलाएँ: कोई डैशबोर्ड राउंड-ट्रिप नहीं। agenteye CLI आपके डेटा (सेशन, इवेंट लॉग, मूल्यांकन) को क्वेरी करता है और आपके संगठन (API कुंजियाँ, उपयोगकर्ता, सेटिंग्स, अलर्ट, घटनाएँ, सहेजी गई क्वेरी) का प्रबंधन करता है, इसलिए जब आप किसी जाँच को स्वचालित करना चाहते हैं, CI में Observability को जोड़ना चाहते हैं, या कोई कोडिंग एजेंट प्रोडक्शन का निरीक्षण करे, तो इसका उपयोग करें। प्रत्येक कमांड --json फ़्लैग को सपोर्ट करता है, इसलिए यह प्रॉम्प्ट पर आपके लिए समान रूप से अच्छी तरह काम करता है या कोई कोडिंग एजेंट (Claude Code, Cursor) शेल आउट करके परिणाम पार्स कर सकता है। एक ही बाइनरी के साथ आप कर सकते हैं:

अपना डेटा पढ़ें: sessions, events, evals, errors (समय, एजेंट, env, स्कोर के अनुसार फ़िल्टर करें)।
अपने संगठन को प्रबंधित करें: keys, users, settings, alerts, incidents।
विश्लेषण चलाएँ: सहेजी गई SQL और एडहॉक क्वेरी रनर (query)।
AI सहायक से पूछें: वही केवल-पढ़ने वाले विश्लेषक जो आप डैशबोर्ड में चैट करते हैं (agent)।

नोट: यह agenteye CLI है, कलेक्टर डेमॉन (agenteye-collector) से एक अलग टूल है। CLI आपके डैशबोर्ड से बात करता है; कलेक्टर घटनाओं को सर्वर में भेजता है।

त्वरित शुरुआत

शून्य से लेकर पहला परिणाम चार पंक्तियों में। CLI को अपने डैशबोर्ड पर इंगित करें, साइन इन करें, पुष्टि करें कि आप कौन हैं, फिर पिछले दिन के रन खींचें:

pipx install agenteye
agenteye --base-url https://agenteye.example.com login --email you@example.com   # emailed 6-digit code
agenteye whoami                                                                  # confirm user + active org
agenteye --json sessions --since 24h                                             # one row per agent run, last 24h

वह अंतिम कमांड सबसे हाल के सेशन (नवीनतम पहले, डिफ़ॉल्ट रूप से 50 पर सीमित) का JSON ऑब्जेक्ट प्रिंट करता है। इसे jq में पाइप करें इसे स्लाइस करने के लिए, या --json ड्रॉप करें एक बॉक्सवाला, रंगीन तालिका के लिए। प्रत्येक पंक्ति रन की स्थिति ले जाती है और, यदि कोई मूल्यांकनकर्ता इसे स्कोर करता है, तो इसके मीट्रिक स्कोर (यहाँ संक्षिप्त):

{
  "sessions": [
    {
      "session_id": "run-8f2a",
      "agent_id": "checkout-bot",
      "environment": "prod",
      "status": "error",
      "scores": { "helpfulness": 0.42, "tool_efficiency": 0.55 },
      "event_count": 37,
      "started_at": "2026-07-16T09:14:02Z",
      "last_event_at": "2026-07-16T09:14:48Z"
    }
  ],
  "next_cursor": null
}

इस पृष्ठ के बाकी हिस्से प्रत्येक टुकड़े की व्याख्या करते हैं: अलगाव में स्थापित करना, साइन इन करना, कॉन्फ़िगरेशन, वैश्विक कन्वेंशन जो प्रत्येक कमांड साझा करता है, और पूर्ण कमांड संदर्भ।

स्थापना

CLI एक सार्वजनिक PyPI पैकेज है जिसका नाम agenteye है। इसे एक अलग वातावरण में स्थापित करें ताकि इसके पास हमेशा अपनी खुद की निर्भरताएँ हों:

pipx install agenteye
# या
uv tool install agenteye

इसके लिए Python 3.10+ की आवश्यकता है। स्थापित कमांड है agenteye:

agenteye --version
agenteye --help

नोट: Failproof AI Observability Python SDK भी agenteye वितरण नाम का उपयोग करता है। pipx या uv tool के साथ CLI को स्थापित करना (साझा virtualenv में pip install के बजाय) दोनों को टकराने से रोकता है। एक सादा pip install agenteye तभी ठीक है यदि SDK उसी वातावरण में स्थापित नहीं है।

प्रमाणीकरण

CLI डैशबोर्ड के साथ एक ईमेल किए गए एकबारी कोड के साथ प्रमाणित करता है:

agenteye login --email you@example.com
# A 6-digit code is emailed to you; paste it at the prompt.

सेशन टोकन ~/.agenteye/cli.json में संग्रहीत है (केवल आपके द्वारा पठनीय, मोड 0600) और डिफ़ॉल्ट रूप से 24 घंटे के लिए वैध है। जब यह समाप्त हो जाए, agenteye login को फिर से चलाएँ।

agenteye whoami     # show the current user, active org, and permissions
agenteye logout     # revoke the session and clear the stored token

whoami कभी भी लापता या समाप्त सेशन पर त्रुटि नहीं करता; बजाय इसके logged_in: false की रिपोर्ट करता है, इसलिए एक स्क्रिप्ट या एजेंट सुरक्षित रूप से प्रमाणन स्थिति की जाँच कर सकता है (यदि कोई आधार URL सेट नहीं है या डैशबोर्ड अप्राप्य है तो यह अभी भी गैर-शून्य बाहर निकल सकता है)। आवश्यकताएँ: आपके ईमेल को डैशबोर्ड में साइन इन करने की अनुमति दी जानी चाहिए (अपने Failproof AI Observability व्यवस्थापक से पूछें), और डैशबोर्ड को इसके आधार URL पर पहुँचने योग्य होना चाहिए (देखें कॉन्फ़िगरेशन)। यदि आप कोड का अनुरोध करते हैं और कोई भी नहीं आता है, तो आपका ईमेल शायद अभी तक डैशबोर्ड पहुँच के लिए सक्षम नहीं है।

अपने संगठन को चुनना (मल्टी-टेनेंट)

यदि आपका खाता एक से अधिक संगठनों से संबंधित है, तो लॉगिन के समय सक्रिय चुनें; यह सहेजा जाता है और हर बाद की कमांड के लिए उपयोग किया जाता है:

agenteye login --org acme           # authenticate and set the active tenant in one step
agenteye orgs list                  # the orgs you can access (the active one is marked)
agenteye orgs switch globex         # change the saved default
agenteye --org globex sessions      # override for a single command

यदि आप ठीक एक संगठन से संबंधित हैं तो यह स्वचालित रूप से चुना जाता है और आप --org को पूरी तरह अनदेखा कर सकते हैं। यदि आप कई से संबंधित हैं और एक नहीं चुनते हैं, तो CLI उन्हें सूचीबद्ध करता है और आपको --org <slug> के साथ फिर से चलाने के लिए कहता है। सक्रिय संगठन हर अनुरोध पर डैशबोर्ड को भेजा जाता है, और आपकी अनुमतियाँ प्रति संगठन हल की जाती हैं; agenteye whoami सक्रिय संगठन, इसमें आपकी अनुमतियाँ, और आपकी सभी सदस्यताएँ दिखाता है।

कॉन्फ़िगरेशन

सेटिंग	फ़्लैग	पर्यावरण चर	डिफ़ॉल्ट
डैशबोर्ड आधार URL	`--base-url`	`AGENTEYE_DASHBOARD_URL`	आवश्यक (कोई डिफ़ॉल्ट नहीं)
सक्रिय संगठन/टेनेंट	`--org`	`AGENTEYE_ORG`	लॉगिन के समय चुना गया; `~/.agenteye/cli.json` में सहेजा गया
सेशन टोकन	`--token`	`AGENTEYE_CLI_TOKEN`	`~/.agenteye/cli.json` से
JSON आउटपुट	`--json`	`AGENTEYE_CLI_JSON`	बंद
TLS सत्यापन छोड़ें	`--insecure` / `--secure`	`AGENTEYE_INSECURE`	बंद (लॉगिन पर सहेजा गया)
अनुरोध टाइमआउट (सेकंड)	`--timeout`	(कोई नहीं)	30
उपयोग टेलीमेट्री अक्षम करें	(कोई नहीं)	`AGENTEYE_ANALYTICS_DISABLED` (या `DO_NOT_TRACK`)	टेलीमेट्री वर्तमान में अक्षम है; कुछ भी नहीं भेजा जाता है

संकल्प क्रम है फ़्लैग → पर्यावरण चर → कॉन्फ़िग फ़ाइल। कोई डिफ़ॉल्ट नहीं है; आपको CLI को अपने डैशबोर्ड पर इंगित करना चाहिए, या तो प्रति-कमांड (--base-url https://agenteye.example.com) या एक बार पर्यावरण के माध्यम से (यह आपके पहले login के बाद भी सहेजा जाता है):

export AGENTEYE_DASHBOARD_URL=https://agenteye.example.com

कॉन्फ़िगरेशन निर्देशिका AGENTEYE_HOME को सम्मानित करती है (SDK और कलेक्टर द्वारा उपयोग की जाने वाली एक ही परंपरा); यदि सेट है, तो cli.json $AGENTEYE_HOME/cli.json में रहता है।

स्व-हस्ताक्षरित या आंतरिक TLS

यदि आपका डैशबोर्ड स्व-हस्ताक्षरित या आंतरिक प्रमाणपत्र के साथ HTTPS पर परोसा जाता है (उदाहरण के लिए, एक कच्चा लोड-बैलेंसर होस्टनाम), तो TLS सत्यापन CERTIFICATE_VERIFY_FAILED त्रुटि के साथ इसे अस्वीकार कर देता है। प्रमाणपत्र सत्यापन छोड़ने के लिए --insecure पास करें:

agenteye --base-url https://agenteye.internal --insecure login

--insecure लॉगिन के समय cli.json में सहेजा जाता है, इसलिए बाद की कमांड स्वचालित रूप से सत्यापन छोड़ देते हैं; आपको फ़्लैग को दोहराना नहीं होगा। एकबारी सत्यापित कॉल के लिए, या अपने अगले लॉगिन पर सत्यापन को वापस बंद करने के लिए --secure पास करें। CLI जब भी कोई कमांड डैशबोर्ड से संपर्क करता है तो stderr को एक चेतावनी प्रिंट करता है जबकि सत्यापन अक्षम है। सत्यापन छोड़ना मैन-इन-द-मिडल हमलों से सुरक्षा को हटाता है; अपने डैशबोर्ड के लिए नेटवर्क पथ पर भरोसा करने से पहले सुनिश्चित करें कि आप उस पर भरोसा करते हैं (VPN, निजी सबनेट, आदि)।

टेलीमेट्री और गोपनीयता

नोट: शिप किया गया CLI आज कोई उपयोग टेलीमेट्री नहीं भेजता। एक मास्टर किल स्विच चालू है, इसलिए आपके पर्यावरण के बावजूद कुछ भी प्रेषित नहीं होता है। नीचे दिया गया अनुभाग यदि और जब टेलीमेट्री कभी सक्षम हो तो ऑप्ट-आउट क्षमता का वर्णन करता है।

यहाँ तक कि सक्षम होने पर, टेलीमेट्री केवल अनाम उपयोग विश्लेषण होगा, कभी आपके एजेंट, सेशन, या घटना डेटा नहीं:

कोई भी एजेंट, सेशन, या घटना डेटा कभी भी आपके बुनियादी ढाँचे से बाहर नहीं जाता। केवल CLI उपयोग की रिपोर्ट की जाएगी: कमांड और सबकमांड का नाम (जैसे keys create), आपके द्वारा उपयोग किए गए फ़्लैग के नाम (कभी उनके मान नहीं), सफलता/निकास स्थिति, और अवधि, साथ ही उत्परिवर्तन के लिए प्रति-क्रिया घटना (जैसे api_key_created, query_run) केवल स्थिर नाम/enums और मोटा गणना ले जाना। आपके डैशबोर्ड URL, सेशन टोकन, ईमेल, org slug, संसाधन ids, SQL, कुंजी रहस्य, और क्वेरी फ़िल्टर कभी नहीं भेजे जाएँगे। संचालकों की पहचान केवल एक अपारदर्शी आंतरिक id द्वारा की जाएगी, कभी ईमेल द्वारा नहीं।
AGENTEYE_ANALYTICS_DISABLED=1 CLI के पर्यावरण में सेट करके पहले से ऑप्ट आउट करें (CLI क्रॉस-टूल DO_NOT_TRACK=1 परंपरा को भी सम्मानित करता है)। यह प्रभाव तब लेता है जब टेलीमेट्री कभी चालू हो जाता है, इसलिए गोपनीयता-सचेत वातावरण स्थायी रूप से ऑप्ट आउट रह सकता है।
यदि टेलीमेट्री सक्षम थे, तो CLI सीधे PostHog (https://us.i.posthog.com) को भेजेगा; एक मशीन जिसमें वह होस्ट अवरुद्ध है, चुप्पी से कुछ भी नहीं भेजेगी और CLI प्रभावित नहीं होगी।

वैश्विक विकल्प और कन्वेंशन

इसे एक बार पढ़ें; यह हर कमांड पर लागू होता है।

वैश्विक विकल्प कमांड से पहले जाते हैं। agenteye --json sessions सही है; agenteye sessions --json एक उपयोग त्रुटि है। विश्वव्यापी विकल्प --json, --base-url, --org, --token, --insecure/--secure, --timeout, --quiet, और --no-color हैं।
--json stdout को शुद्ध JSON प्रिंट करता है, और कुछ नहीं। मानव स्थिति पंक्तियाँ, चेतावनियाँ, और त्रुटियाँ stderr में जाती हैं, इसलिए --json stdout कैप्चर तब भी स्वच्छ रहता है जब एक स्थिति पंक्ति दिखाई दे। --json के बिना आप मानव आँखों के लिए एक बॉक्सवाला, रंगीन दृश्य प्राप्त करते हैं।
--help के साथ खोजें। प्रत्येक कमांड और सबकमांड में --help (और -h उपनाम) है: agenteye -h, agenteye sessions -h, agenteye keys create -h। शीर्ष-स्तरीय सहायता निकास कोड और वैश्विक विकल्प भी सूचीबद्ध करती है। कोई वैश्विक मशीन-पठनीय सतह डंप नहीं है; प्रति-कमांड --help का उपयोग करें, साथ ही डोमेन-विशिष्ट agenteye query schema और agenteye settings schema उन दो रजिस्ट्रियों के लिए।
पुष्टियाँ स्क्रिप्ट और एजेंटों के लिए स्वचालित रूप से छोड़ दी जाती हैं। बनाएँ/अपडेट/हटाएँ कमांड एक इंटरैक्टिव टर्मिनल में “क्या आप सुनिश्चित हैं?” प्रॉम्प्ट करते हैं, लेकिन --json के तहत या जब भी stdin कोई TTY नहीं है (एक TTY एक इंटरैक्टिव टर्मिनल सत्र है; एक पाइप या CI रनर नहीं) तो स्वचालित रूप से उस प्रॉम्प्ट को छोड़ दें, इसलिए स्क्रिप्ट और एजेंट कभी भी हैंग नहीं करते। --yes/-y पास करके इसे स्पष्ट रूप से छोड़ दें। क्योंकि एक एजेंट के लिए प्रॉम्प्ट फायर नहीं होगा, एक एजेंट को विनाशकारी कार्यों की मानव द्वारा पहले पुष्टि करनी चाहिए।
पृष्ठांकन: परिणाम सबसे नए-पहले और कर्सर-पृष्ठांकित हैं (प्रत्येक पृष्ठ एक टोकन देता है जो आप अगला लाने के लिए उपयोग करते हैं)। --limit N (उपनाम -n) पंक्तियों को कैप करता है और डिफ़ॉल्ट रूप से 50; --all स्वचालित-पृष्ठांकन (200-पंक्ति चंक में) --limit तक, इसलिए एक बंधे हुए --all अभी भी 50 पर रुकते हैं। एक पूर्ण स्वीप के लिए एक उच्च स्पष्ट कैप पास करें: --all --limit 1000। --page-size N प्रति-अनुरोध चंक नियंत्रित करता है (अधिकतम 200); --cursor <id> पूर्व पृष्ठ के next_cursor से फिर से शुरू करता है।
समय फ़िल्टर: --since एक सापेक्ष विंडो लेता है: 15m, 1h, 6h, 24h, 7d, या all (डैशबोर्ड की पूर्वनिर्धारितें)। एक लंबी या कस्टम रेंज के लिए (कहें पिछले 30 दिन), --from/--to का उपयोग करें: स्पष्ट ISO-8601 UTC टाइमस्टैम्प T और एक टाइमजोन के साथ (जैसे 2026-06-01T00:00:00Z) जो --since को ओवरराइड करते हैं। एक स्पेस-अलग या टाइमजोन-रहित मान एक उपयोग त्रुटि है।
--fields a,b,c (events, sessions, evals, errors पर) आउटपुट को उन कुंजियों तक सीमित करता है, तालिका और --json दोनों के लिए। अज्ञात नाम मान्य सूची के साथ अस्वीकार किए जाते हैं, क्षेत्र नामों की खोज करने का एक सस्ता तरीका।
--file payload.json (या --file - stdin को पढ़ने के लिए) एक पूर्ण JSON अनुरोध बॉडी प्रदान करता है जहाँ एक संसाधन में एक जटिल आकार है (alerts create/update, settings set, और users create/update पर)। सहेजी गई-क्वेरी SQL --sql @file.sql का उपयोग करता है।
मल्टी-मान फ़िल्टर अल्पविराम-अलग हैं → एक सेट के रूप में मेल खाए (एक फ़िल्टर के भीतर संघ, फ़िल्टर भर में AND): --event-type tool_use,tool_result। क्लिक विकल्प variadic नहीं हैं, इसलिए --add a b टूट जाता है। --add a,b का उपयोग करें, फ़्लैग दोहराएँ (--add a --add b), या उद्धृत करें (--add "a b")।

कमांड संदर्भ

आप इन 5 कमांडों का सबसे अधिक उपयोग करेंगे

अधिकांश दिन-प्रतिदिन का काम कुछ पढ़ने की कमांड के माध्यम से चलता है। यहाँ शुरू करें, फिर नीचे पूर्ण सतह तक पहुँचें जब आपको इसकी आवश्यकता हो:

कमांड	यह क्या करता है	इसे आज़माएँ
`sessions`	एक एजेंट रन प्रति पंक्ति: समय, env, एजेंट, स्थिति, नवीनतम स्कोर।	`agenteye --json sessions --since 24h --status error`
`events`	एक रन (अधिक पेलोड के लिए `--full` जोड़ें) के अंदर कच्चा प्रति-कदम पथ।	`agenteye --json events --session-id run-001 --all`
`evals`	मूल्यांकन परिणाम और स्कोर; `--aggregate` उन्हें रोल करता है।	`agenteye --json evals --aggregate --since 7d --env prod`
`errors`	बस त्रुटि वाली घटनाएँ; `--aggregate` प्रकार के अनुसार गणना के लिए।	`agenteye --json errors --since 24h --aggregate`
`list`	मान्य फ़िल्टर मान (एजेंट, envs, मॉडल, …) की खोज करें।	`agenteye list agents`

CLI जो कुछ भी कर सकता है

पूरी सतह का अनुसरण करता है। CLI में 18 शीर्ष-स्तरीय कमांड हैं। सभी पढ़ने की कमांड --json और ऊपर वैश्विक विकल्पों को स्वीकार करते हैं; किसी भी एक के लिए विस्तृत फ़्लैग सूची और JSON आकार के लिए agenteye <command> -h (या <command> <subcommand> -h) चलाएँ।

agenteye login --email you@example.com [--org acme]   # emailed one-time code; saves the session
agenteye logout                                       # clear the saved session on this machine
agenteye whoami                                       # current user, active org, permissions
agenteye version                                      # print the CLI version (same as --version)
agenteye help                                         # top-level help (same as --help)

orgs सक्रिय टेनेंट का निरीक्षण और स्विच करता है:

agenteye orgs list        # your orgs + your role in each (active one marked)
agenteye orgs switch acme # change the saved active org (omit the slug to pick from a list on a TTY)
agenteye orgs current     # identity card for the active org
agenteye orgs perms       # your permissions in the active org, grouped by resource

अवलोकन करें (केवल-पढ़ने योग्य): `events` · `sessions` · `evals` · `errors` · `list`

इनमें से कोई भी पुष्टि की आवश्यकता नहीं है। साझा फ़िल्टर: --session-id, --agent-id, --env (नहीं --environment), और समय रेंज (--since / --from / --to)।

# events (alias: the raw per-step trail), newest first
agenteye --json events --session-id run-001 --event-type tool_use,tool_result --all --limit 1000
agenteye --json events --since 1h --search timeout --all | jq '.events[].payload'

# sessions: one row per agent run (time/env/agent/session/status; no score filtering)
agenteye --json sessions --since 24h --status error
agenteye --json sessions --agent-id checkout-bot --env prod --all --limit 1000

# evals: evaluation results + scores; --score filters by metric, --aggregate rolls up
agenteye --json evals --score helpfulness:0.5..0.8 --score tool_efficiency:..0.3
agenteye --json evals --aggregate --since 7d --env prod        # status mix + per-key score stats

# errors: errored events; --aggregate for counts/sessions/agents/last-seen
agenteye --json errors --since 24h --aggregate
agenteye --json errors --since 24h --error-type timeout --all --limit 1000

# list: discover valid filter values before you filter
agenteye list envs        # also: agents event_types score_filters models hooks tools error_types

--score KEY:MIN..MAX (evals पर, sessions नहीं) दोहराया जाता है और AND-संयुक्त है; या तो बाउंड वैकल्पिक है (..0.5 का अर्थ ≤ 0.5, 0.9.. का अर्थ ≥ 0.9)। प्रति अनुरोध 20 स्कोर फ़िल्टर तक। evals --scores-full मानव तालिका केवल के लिए एक डिस्प्ले फ़्लैग है; यह पहले कुछ के बजाय हर स्कोर जोड़ी और +N गणना दिखाता है। --json के तहत इसका कोई प्रभाव नहीं है, जो हमेशा पूर्ण स्कोर ऑब्जेक्ट लौटाता है। एक सेशन अंत तक पढ़ने के लिए, घटना पथ को इसके मूल्यांकन के साथ संयोजित करें:

agenteye --json events --session-id run-001 --all --limit 1000 | jq '.events[] | {ts, event_type}'
agenteye --json evals  --session-id run-001                       # its scores + status

प्रबंधन करें (अनुमति-गेटेड): `keys` · `users` · `settings` · `alerts` · `incidents`

keys: API कुंजियाँ। रहस्य स्थानीय रूप से उत्पन्न होता है, सर्वर को भेजा जाता है (जो केवल एक हैश संग्रहीत करता है), और एक बार बनाएँ/पुनर्जन्म पर दिखाया जाता है; इसे तब कैप्चर करें। --json के साथ यह केवल key फ़ील्ड में दिखाई देता है। नाम द्वारा संदर्भित।

agenteye keys list                                   # active keys first, then revoked
agenteye keys show ci-bot
agenteye keys create ci-bot --add events:read.add    # scope to what you need; prints the secret ONCE
agenteye keys create ops --permission-set standard --remove queries:run   # seed a preset, then trim
agenteye keys update ci-bot --add evaluations:read --yes
agenteye keys regenerate ci-bot --yes                # rotate the secret (the old one stops working)
agenteye keys disable ci-bot --yes                   # revoke

अनुमतियाँ (permission-set ∪ --add) − --remove के रूप में काम करती हैं। टोकन slug:action (जैसे events:read) या एक संसाधन पर कई को विस्तारित करने के लिए slug:action.action (जैसे events:read.add → events:read, events:add)। पूर्वनिर्धारितें: read-only, standard, admin। मानव-केवल अनुमतियाँ (keys:update) किसी कुंजी को दी नहीं जा सकतीं। users: org सदस्य, ईमेल द्वारा संदर्भित (एक UUID id भी स्वीकार किया जाता है)।

agenteye users list [--active-only]
agenteye users show dev@corp.com
agenteye users create dev@corp.com --permission-set standard
agenteye users update dev@corp.com --add alerts:write --remove queries:delete   # predicts + confirms
agenteye users disable dev@corp.com --yes            # has protected/self guards
agenteye users enable dev@corp.com

settings: एक निश्चित रजिस्ट्री (आप मौजूदा कुंजियों को पढ़ते और बदलते हैं; आप नई नहीं बना सकते)।

agenteye settings list                               # key · value · type · updated (secrets masked)
agenteye settings schema                             # what each key accepts (type · range · description)
agenteye settings set session_ttl_secs --value 86400 --yes

alerts: अलर्ट परिभाषा, नाम द्वारा संदर्भित। create एक स्थितीय NAME साथ फ़्लैग या --file के माध्यम से एक पूर्ण JSON बॉडी लेता है।

agenteye alerts list
agenteye alerts show high-errors
agenteye alerts create high-errors --file alert.json          # NAME is required (positional)
agenteye alerts update high-errors --severity critical --yes
agenteye alerts test high-errors --yes                        # fire a test notification
agenteye alerts delete high-errors --yes

incidents: अलर्ट घटनाएँ, id द्वारा संदर्भित (संक्षिप्त ids स्वीकार किए जाते हैं)। show पूर्ण गतिविधि लॉग प्रिंट करता है; कार्य करने से पहले इसे पढ़ें।

agenteye incidents list --state firing                # also: acknowledged, resolved
agenteye incidents count
agenteye incidents show <id>
agenteye incidents ack <id>
agenteye incidents assign <id> you@corp.com           # assignee must be an operator
agenteye incidents resolve <id> --yes
agenteye incidents open --alert-id <id> --severity critical    # open one manually against an alert
agenteye incidents comment-add <id> "root cause: upstream 5xx"
agenteye incidents comment-list <id> ; agenteye incidents comment-delete <id> <comment-id>
agenteye incidents subscribe <id> ; agenteye incidents unsubscribe <id> ; agenteye incidents subscribers <id>

विश्लेषण और सहायक: `query` · `agent`

query: अपने विश्लेषण स्टोर के विरुद्ध सहेजी गई SQL साथ एडहॉक रनर। सहेजी गई क्वेरी नाम द्वारा संदर्भित हैं; SQL सर्वर-साइड (SELECT/WITH केवल, विवरण टाइमआउट, पंक्ति कैप) सत्यापित है।

agenteye query schema [TABLE]                         # column layout of the analytics views
agenteye query run --sql "select count(*) from analytics.events"
agenteye query run errs --arg prod --limit 100        # run a saved query + a positional $1
agenteye query list ; agenteye query show errs
agenteye query create errs --sql @errs.sql --description "errored events (24h)"
agenteye query update errs --sql @errs.sql --yes ; agenteye query delete errs --yes

agent: बिल्ट-इन AI सहायक से बात करता है (वही केवल-पढ़ने वाले विश्लेषक जिससे आप डैशबोर्ड में चैट कर सकते हैं)। चैट एक छोटे chat-id द्वारा संदर्भित होते हैं (उपसर्ग-हल)।

agenteye agent health                                 # is the AI assistant configured/reachable
agenteye agent models                                 # models you can pass to --model (default marked)
agenteye agent ask "which agents errored most in the last day?"    # starts a chat; prints its short id
agenteye agent ask --chat <short-id> "and which tools did they call?"   # continue that chat
agenteye agent chats ; agenteye agent show <short-id>
agenteye agent rename <short-id> --title "error triage" ; agenteye agent delete <short-id>

निकास कोड

कोड	अर्थ
0	सफलता
1	अप्रत्याशित त्रुटि (जैसे डैशबोर्ड ने 5xx लौटाया)
2	उपयोग त्रुटि (अमान्य तर्क, अज्ञात कमांड/फ़्लैग, नाम टकराव)
3	डैशबोर्ड तक नहीं पहुँच सकता
4	लॉगिन में नहीं हैं या सेशन समाप्त हुआ; `agenteye login` चलाएँ
5	प्रमाणित, लेकिन आपके खाते में आवश्यक अनुमति नहीं है (संदेश इसका नाम देता है)
6	अनुरोधित संसाधन नहीं मिला (जैसे अज्ञात सेशन या घटना id)

ये CLI को स्क्रिप्ट के लिए सुरक्षित बनाते हैं: एक कोडिंग एजेंट एक 4 पर शाखा बना सकता है आपको फिर से प्रमाणित करने का संकेत देने के लिए, या एक 5 लापता अनुमति की सतह के लिए। CLI रेसिपी देखें एजेंट के लिए निकास-कोड-संभालने के पैटर्न और JSON आउटपुट आकार के लिए।

अगले कदम

एजेंट के लिए CLI रेसिपी: कॉपी-पेस्ट क्वेरी पैटर्न, jq एक-लाइनर, --fields प्रक्षेपण, निकास-कोड संभालना, और JSON आउटपुट आकार, कोडिंग एजेंट के लिए लिखा हुआ CLI चला रहे हैं।
CLI एजेंट कौशल: इस CLI को स्थापन योग्य Claude Code / Codex कौशल के रूप में पैकेज करें ताकि एक कोडिंग एजेंट सादे-अंग्रेजी अनुरोध से Failproof AI Observability चला सके।
API कुंजियाँ: keys create --add … के पीछे अनुमति मॉडल।
AI सहायक: सहायक को सक्षम करना जिससे agent ask बात करता है।

Overview

Features

SDK and CLI

Administration

त्वरित शुरुआत

स्थापना

प्रमाणीकरण

अपने संगठन को चुनना (मल्टी-टेनेंट)

कॉन्फ़िगरेशन

स्व-हस्ताक्षरित या आंतरिक TLS

टेलीमेट्री और गोपनीयता

वैश्विक विकल्प और कन्वेंशन

कमांड संदर्भ

आप इन 5 कमांडों का सबसे अधिक उपयोग करेंगे

CLI जो कुछ भी कर सकता है

अवलोकन करें (केवल-पढ़ने योग्य): `events` · `sessions` · `evals` · `errors` · `list`

प्रबंधन करें (अनुमति-गेटेड): `keys` · `users` · `settings` · `alerts` · `incidents`

विश्लेषण और सहायक: `query` · `agent`

निकास कोड

अगले कदम

​त्वरित शुरुआत

​स्थापना

​प्रमाणीकरण

​अपने संगठन को चुनना (मल्टी-टेनेंट)

​कॉन्फ़िगरेशन

​स्व-हस्ताक्षरित या आंतरिक TLS

​टेलीमेट्री और गोपनीयता

​वैश्विक विकल्प और कन्वेंशन

​कमांड संदर्भ

​आप इन 5 कमांडों का सबसे अधिक उपयोग करेंगे

​CLI जो कुछ भी कर सकता है

​पहचान: login · logout · whoami · orgs · version · help

​अवलोकन करें (केवल-पढ़ने योग्य): events · sessions · evals · errors · list

​प्रबंधन करें (अनुमति-गेटेड): keys · users · settings · alerts · incidents

​विश्लेषण और सहायक: query · agent

​निकास कोड

​अगले कदम

त्वरित शुरुआत

स्थापना

प्रमाणीकरण

अपने संगठन को चुनना (मल्टी-टेनेंट)

कॉन्फ़िगरेशन

स्व-हस्ताक्षरित या आंतरिक TLS

टेलीमेट्री और गोपनीयता

वैश्विक विकल्प और कन्वेंशन

कमांड संदर्भ

आप इन 5 कमांडों का सबसे अधिक उपयोग करेंगे

CLI जो कुछ भी कर सकता है

पहचान: `login` · `logout` · `whoami` · `orgs` · `version` · `help`

अवलोकन करें (केवल-पढ़ने योग्य): `events` · `sessions` · `evals` · `errors` · `list`

प्रबंधन करें (अनुमति-गेटेड): `keys` · `users` · `settings` · `alerts` · `incidents`

विश्लेषण और सहायक: `query` · `agent`

निकास कोड

अगले कदम