एजेंट्स और व्यक्तित्व

एक एजेंट AiHummer किसी बातचीत के सामने जो इकाई रखता है वह है। प्रत्येक एजेंट की अपनी पर्सोना, अपना मॉडल, एक संरचित प्रॉम्प्ट और कौशलों का एक सेट होता है, और इसमें किए गए हर बदलाव का संस्करण होता है। एजेंट्स को वेब एडमिन UI और एडमिन API के माध्यम से प्रबंधित किया जाता है। /v1/admin/agents/*.

यह पृष्ठ बताता है कि एक एजेंट किस चीज़ से बना है, संरचित “G3” प्रॉम्प्ट कैसे तैयार किया जाता है, और एक एजेंट अपने प्रोफाइल को सुरक्षित रूप से कैसे संपादित कर सकता है।

एजेंट रजिस्ट्री

रजिस्ट्री एजेंट्स का एक पूर्ण CRUD कैटलॉग है। प्रत्येक एजेंट के लिए आप एक पहचान, एक व्यक्तित्व, जिस मॉडल पर यह चलता है और वह कौशल जो यह उपयोग कर सकता है, को परिभाषित करते हैं। क्योंकि गेटवे मल्टीटेनेंट है, एजेंट्स एक वर्कस्पेस के अंदर रहते हैं और किसी अन्य टेनेंट डेटा की तरह अलग होते हैं।

पात्र — एजेंट की आवाज़ और व्यवहार, एक अस्तबल में बदल दिया गया, सिस्टम प्रॉम्प्ट की कैश-अनुकूल परत।
प्रति-एजेंट मॉडल — प्रत्येक एजेंट अपना खुद का मॉडल और प्रदाता पिन कर सकता है, इसलिए एक सस्ता एजेंट और एक प्रमुख एजेंट एक ही कार्यक्षेत्र में सह-अस्तित्व में रह सकते हैं।
कौशल — प्रति-एजेंट और साझा कौशल एक “कौशल” ब्लॉक को इस में बदल देते हैं प्रॉम्प्ट; वे क्षमताओं का वर्णन करते हैं, वज़न का नहीं।

[!NOTE] प्रति-एजेंट मॉडल रूटिंग से स्वतंत्र होता है। मॉडल-स्तरीय रूटिंग (सरल / मानक / जटिल) एक टर्न के लिए एक मॉडल वर्ग चुनता है, जबकि प्रति-एजेंट मॉडल एजेंट का अपना डिफ़ॉल्ट है। देखें राउटिंग.

संस्करण, रोलबैक और क्लोन

एजेंट में हर महत्वपूर्ण बदलाव को इस रूप में दर्ज किया जाता है संस्करणयह एजेंट कॉन्फ़िगरेशन को ऑडिट करने योग्य और पलटे जाने योग्य बनाता है: आप देख सकते हैं कि क्या बदला, वापस रोल करें एक पुराने संस्करण पर, या क्लोन एक एजेंट इसे नए एजेंट के लिए प्रारंभिक बिंदु के रूप में उपयोग कर सकता है। संस्करण और प्रोफाइल संसाधन इसके अंतर्गत रहते हैं /v1/admin/agents/* (प्रोफ़ाइल, अनुभाग, कौशल, संस्करण)।

[!TIP] किसी बड़े पर्सोना या प्रॉम्प्ट पुनर्लेखन से पहले एक काम करने वाले एजेंट की क्लोन बनाएं। यदि नया यदि दिशा काम नहीं करती है, तो मूल अभी भी एक रोलबैक दूर है।

संरचित “G3” प्रॉम्प्ट

एकल मुक्त-पाठ सिस्टम प्रॉम्प्ट के बजाय, AiHummer का उपयोग करता है संरचित एजेंट प्रोफ़ाइल (आंतरिक रूप से “G3”). पहचान है क्षेत्रों में विघटित प्रॉस में दफन होने के बजाय, और प्रॉम्प्ट का बाकी हिस्सा नामित चीज़ों से बना है खंड प्लस एक ऑनबोर्डिंग ब्लॉक। ऑर्केस्ट्रेटर इन्हें लेयर्ड सिस्टम प्रॉम्प्ट में रेंडर करता है, स्थिर भागों (पहचान, व्यक्तित्व, अनुभागों) को कैश करने योग्य प्रीफिक्स में रखता है और अस्थिर डेटा को अंत में जोड़ता है।

संरचना प्रोफ़ाइल को फील्ड द्वारा फील्ड संपादित करना आसान बनाती है, संस्करणों के बीच अंतर निकालना आसान बनाती है, और इसे प्रदर्शित करना पूर्वानुमेय बनाती है — कोई छिपा हुआ प्रॉम्प्ट सूप नहीं है।

G3 profile
├── identity fields   (decomposed: name, role, ...)
├── sections          (named, ordered prompt blocks)
└── onboarding        (first-run guidance)

मंजूरी के गेट के पीछे स्व-संपादन

एक एजेंट को अनुमति दी जा सकती है अपनी प्रोफ़ाइल संपादित करें स्वयं-संपादन उपकरणों का उपयोग करना — उदाहरण के लिए किसी अनुभाग को परिष्कृत करने या उसके ऑनबोर्डिंग को अपडेट करने के लिए। यह जानबूझकर सुरक्षित रखा गया है:

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

[!WARNING] स्वयं-संपादन शक्तिशाली है। इसे अनुमोदन गेट के पीछे रखें ताकि कोई एजेंट इसे न कर सके। चुपचाप अपनी पहचान को दोबारा लिखता है। प्रस्तावित स्व-संपादन की समीक्षा उसी तरह करें जैसे आप किसी भी विशेषाधिकार प्राप्त परिवर्तन की समीक्षा करें।

मेल पासवर्ड्स वॉल्ट में जाते हैं

यदि किसी एजेंट का कॉन्फ़िगरेशन मेल क्रेडेंशियल्स शामिल करता है (के लिए mail उपकरण), पासवर्ड में लिखा जाता है एन्क्रिप्टेड क्रेडेंशियल वॉल्टये प्रोफ़ाइल में संग्रहीत नहीं होते हैं और न ही प्रॉम्प्ट में प्रदर्शित होते हैं। रहस्य कभी भी मॉडल संदर्भ में नहीं जाते हैं।

निष्पादन नीति: संदर्भ, सत्र और चाइल्ड एजेंट

संस्करण 1.3 से एजेंट के पास निष्पादन नीति है — एडमिन API में runtime_policy फ़ील्ड (बनाने और अद्यतन करने पर /v1/admin/agents)। यह "version": 1 वाला सख़्ती से जाँचा जाने वाला JSON ऑब्जेक्ट है: खाली {} डिफ़ॉल्ट लौटाता है, अद्यतन में फ़ील्ड छोड़ने से पिछली नीति बनी रहती है, और अज्ञात फ़ील्ड व अनुमत सीमाओं से बाहर के मान अस्वीकार होते हैं। नीति उपकरण नहीं देती और अधिकार नहीं बढ़ाती — वह केवल बजट और समय-सीमाएँ तय करती है। एजेंट का क्लोन और उसे बारी सौंपना इसे विरासत में पाते हैं।

context — इतिहास बजट: max_tokens, reserve_tokens और history_share तय करते हैं कि अनुरोध में कितना इतिहास जाता है; max_history_messages संदेश विंडो को, bootstrap_max_chars प्रोफ़ाइल ब्लॉक के आकार को सीमित करता है। जब संदर्भ स्पष्ट रूप से दिया गया हो, पुराने संदेश वर्तमान अनुरोध बनने से पहले बैचों में सारांश में संपीड़ित होते हैं।
- pruning — पुराने उपकरण परिणामों की सफ़ाई: आयु से (ttl_seconds), हाल के जवाबों की सुरक्षा के साथ (keep_last_assistants), हल्की छँटाई (soft_trim_ratio, head_chars, tail_chars) और hard_clear_ratio पार होने पर placeholder पाठ से पूर्ण प्रतिस्थापन। उपयोगकर्ता का पाठ, छवियाँ और डेटाबेस का पूरा इतिहास अछूते रहते हैं।
- memory_flush — संपीड़न से पहले बिना उपकरणों वाला एजेंट लक्ष्यों, निर्णयों और अधूरे कामों पर छोटा नोट लिखता है (soft_threshold_tokens); उसी संवाद के अंतिम तीन नोट असत्यापित संदर्भ के रूप में संदर्भ में मिलाए जाते हैं।
session — संवाद का जीवनचक्र: idle_reset_minutes विराम के बाद नया संदर्भ शुरू करता है (कच्चा इतिहास सुरक्षित रहता है), index_prune_after_days और index_max_entries पुराने संवादों को हटाए बिना डिफ़ॉल्ट सूची से निकालते हैं। scope = per-peer (सभी चैनलों में सत्यापित उपयोगकर्ता के लिए एक संवाद) या per-channel-peer (हर चैनल के लिए अलग संवाद)।
children — चाइल्ड एजेंट: max_depth (4 तक), max_concurrent (प्रति रन ट्री 8 तक), max_per_parent (5 तक), timeout_seconds (48 घंटे तक, पर पैरेंट से अधिक नहीं) और archive_after_minutes — पूरे हो चुके रन डिफ़ॉल्ट सूची से कब हटते हैं। ये मान इस एजेंट के लिए वैश्विक AIHUMMER_SUBAGENT_MAX_DEPTH और AIHUMMER_SUBAGENT_TIMEOUT_SEC को ओवरराइड करते हैं।
max_iterations (1–256) — कई प्रत्यायोजनों वाले जाँचे गए परिदृश्यों के लिए फ़ंक्शन-कॉल चक्र की चरण सीमा।
app — केवल AiHummer ऐप के लिए: reasoning_effort, service_tier और छोटे जवाब का मोड direct_completion (auto या always, max_tokens 4096 तक और timeout_ms 60 000 तक)।
interaction — सत्रों के साथ काम की स्पष्ट अनुमतियाँ: user_ids, session_agent_ids, spawn_agent_ids, दृश्यता session_visibility (self, agent या granted), session_send, चाइल्ड कॉल के लिए उपकरण प्रतिबंध (child_tool_deny, child_leaf_tool_deny) और elevated_telegram_user_ids — user_ids का उपसमुच्चय जिसे स्पष्ट रूप से उन्नत code_exec निष्पादन माँगने की अनुमति है (अनुमोदन दरकिनार नहीं होते)। वाइल्डकार्ड और पूरे टेनेंट के लिए अनुमतियाँ नहीं हैं।

एडमिन एपीआई

एजेंट और उनके संरचित प्रोफाइल प्रशासन API के तहत प्रबंधित किए जाते हैं, जो OIDC-गेटेड और ऑडिटेड हैं:

संसाधन	उद्देश्य
`/v1/admin/agents`	एजेंट्स को सूचीबद्ध करें, बनाएं, अपडेट करें, हटाएं (CRUD)
`/v1/admin/agents/.../profile`	संरचित G3 प्रोफ़ाइल (पहचान फ़ील्ड)
`/v1/admin/agents/.../sections`	नामित संकेत अनुभाग
`/v1/admin/agents/.../skills`	प्रति-एजेंट कौशल
`/v1/admin/agents/.../versions`	संस्करण इतिहास, रोलबैक और क्लोन

अगला कहाँ

समझें कि एजेंट कैसे एक टर्न चलाते हैं और सहायक को स्पॉन करते हैं संगठन और उप-एजेंट.
देखें कि एक आने वाला संदेश कैसे किसी विशिष्ट एजेंट तक पहुँचता है राउटिंग.
अपने एजेंट्स को दीर्घकालिक स्मृति दें स्मृति (आइंस्टीन).