उपकरण
उपकरण एजेंट दुनिया पर कैसे कार्य करता है — एक पृष्ठ लाना, खोज करना, मेल भेजना, किसी डेटाबेस से पूछताछ करना, एक दस्तावेज़ तैयार करना। AiHummer एक समृद्ध पैकेज के साथ आता है बिल्ट-इन कैटलॉग और एक टूल रनटाइम जो उपकरणों को सक्षम बनाता है जब उन्हें कॉन्फ़िगर किया जाता है, उन्हें बिना पुनःआरंभ किए रीलोड करता है, जोखिम भरे उपकरणों को मानव अनुमोदन के पीछे रखता है, और एयर-गैप मोड में पूरी तरह से एग्रीस को लॉक कर सकता है।
यह पृष्ठ बताता है कि रनटाइम कैसे व्यवहार करता है और निर्मित फंक्शंस की सूची देता है। पूर्ण संदर्भ के लिए, देखें उपकरण सूची.
टूल रनटाइम कैसे व्यवहार करता है
- कॉन्फ़िग पर सक्षम करें। एक उपकरण तभी उपलब्ध होता है जब इसकी पूर्वापेक्षा पूरी होती है कॉन्फ़िगरेशन मौजूद है — आमतौर पर एक वातावरण चर जो की यह दिखाता है इसकी आवश्यकता वाली सेवा। कोई कॉन्फ़िग, कोई टूल नहीं।
- हॉट रीलोड। उपकरण सक्रियण लागू होता है गर्म, बिना पुनः आरंभ किए गेटवे, ताकि आप रनटाइम पर क्षमताओं को चालू और बंद कर सकें।
- स्वीकृति द्वार। जोखिम भरे उपकरण मानव-इन-द-लूप के पीछे रखा जा सकता है
मंजूरी द्वार के माध्यम से
AIHUMMER_APPROVAL_TOOLS. एक अस्वीकृत कॉल है नहीं संपन्न किया गया। - एयर-गैप्ड मोड। सेटिंग
AIHUMMER_AIRGAPPED=1मॉडल-नियंत्रित ब्लॉक सार्वजनिक निकासी, संप्रभु या अलग-थलग तैनाती के लिए।
[!WARNING]
code_execहै डिफ़ॉल्ट रूप से बंद साझा होस्ट पर। इसे केवल वहां सक्षम करें जहां सैंडबॉक्स और होस्ट मॉडल-लेखित कोड चलाने के लिए स्वीकार्य हैं, और विचार करें इसे मंजूरी गेट के पीछे रखना।
बिल्ट-इन टूल्स
| उपकरण | यह क्या करता है | सक्रिय करें |
|---|---|---|
web_fetch |
एक URL प्राप्त करें (SSRF-रक्षित) | डिफ़ॉल्ट रूप से चालू |
http_request |
एक HTTP अनुरोध करें (SSRF-से सुरक्षित) | डिफ़ॉल्ट रूप से चालू |
web_search |
बिल्ट-इन SearXNG के माध्यम से वेब खोज | डिफ़ॉल्ट रूप से चालू; इंस्टॉलर फ़्लैग --no-search से बंद करें |
browser |
सीडीपी के माध्यम से असली ब्राउज़र चलाएँ | डिफ़ॉल्ट रूप से चालू; इंस्टॉलर फ़्लैग --no-browser से बंद करें |
computer |
सीडीपी पर कंप्यूटर का उपयोग | डिफ़ॉल्ट रूप से चालू; इंस्टॉलर फ़्लैग --no-browser से बंद करें |
memory_store |
दीर्घकालिक मेमोरी में कोई तथ्य संग्रहीत करें; कैप्चर मोड auto (डिफ़ॉल्ट) में यह तुरंत खोजा जा सकता है, review/off में यह अनुमोदन की प्रतीक्षा करने वाला उम्मीदवार बन जाता है |
डिफ़ॉल्ट रूप से चालू |
memory_search |
दीर्घकालिक मेमोरी में खोजें | डिफ़ॉल्ट रूप से चालू |
filesystem_read |
सर्वर की डिस्क पर फ़ाइल पढ़ना या डायरेक्ट्री की सूची देखना | डिफ़ॉल्ट रूप से चालू; AIHUMMER_FS_ROOT सैंडबॉक्स को सीमित करता है, खाली = पूरा सर्वर |
db_query |
केवल-पढ़ने वाले डेटाबेस क्वेरी | AIHUMMER_DB_QUERY_DSN |
mail |
मेल भेजें/प्राप्त करें (SMTP/IMAP) | मेल क्रेडेंशियल्स (वॉल्ट) |
code_exec |
सैंडबॉक्स में कोड चलाएँ (साझा होस्ट पर डिफ़ॉल्ट रूप से बंद) | AIHUMMER_CODE_EXEC |
doc_generate |
CSV / TSV / XLSX या HTML दस्तावेज़ बनाएँ। | डिफ़ॉल्ट रूप से चालू |
tts |
पाठ से वाणी | टीटीएस साइडकार |
image_generate / edit_image |
उत्पन्न करें और छवियों को संपादित करें | कॉन्फ़िगर किया हुआ इमेज बैकएंड |
github_get_file |
GitHub से एक फ़ाइल प्राप्त करें | डिफ़ॉल्ट रूप से चालू |
generate_pairing_code |
डिवाइस पेयरिंग कोड जारी करें | डिफ़ॉल्ट रूप से चालू |
search_knowledge / deep_research |
ज्ञान पुनर्प्राप्ति और बहु-चरण अनुसंधान | ज्ञान आधार |
| बिट्रिक्स24 सीआरएम / कार्य / कैलेंडर | Bitrix24 CRM, कार्य और कैलेंडर क्रियाएँ | Bitrix24 प्लगइन |
| 1C (बिट.फाइनेंस OData) | OData के माध्यम से 1C БИТ.ФИНАНС तक पहुँच | 1C OData कॉन्फ़िग |
[!NOTE]
web_fetchऔरhttp_requestहैं SSRF-सुरक्षित — वे … करने के लिए अनुरोध अस्वीकार करते हैं आंतरिक पते और अन्य असुरक्षित लक्ष्यों, ताकि एक मॉडल उनका उपयोग न कर सके अपने निजी नेटवर्क तक पहुँचें।
स्थायी ब्राउज़र प्रोफ़ाइल
डिफ़ॉल्ट रूप से computer हर अनुरोध पर साफ़ ब्राउज़र खोलता है। संस्करण 1.3 से
उपकरण स्पष्ट रूप से सौंपी गई व्यक्तिगत प्रोफ़ाइल (cookie और साइट सत्र) को
अनुरोधों के बीच बनाए रख सकता है — उदाहरण के लिए, ताकि कर्मचारी हर बार दोबारा
लॉगिन किए बिना अपने खाते चला सके। प्रोफ़ाइल कभी भी मॉडल के तर्कों के नाम या पथ
से नहीं चुनी जाती — केवल ऑपरेटर की स्पष्ट बाइंडिंग से:
AIHUMMER_BROWSER_PROFILE_SOCKET— इंस्टॉल की गई ब्राउज़र सेवा के निजीmanaged-profiles.sockसॉकेट का निरपेक्ष पथ; खाली (डिफ़ॉल्ट) — स्थायी प्रोफ़ाइल बंद।AIHUMMER_BROWSER_PROFILE_BINDINGS— बाइंडिंग का JSON ऐरे:profile_id,tenant_id,user_id,agent_idsऔरconversation_ids(64 तक प्रोफ़ाइल, हर एक का एक स्वामी)।
प्रोफ़ाइल केवल तब खुलती है जब वर्तमान उपयोगकर्ता उसका स्वामी हो और एजेंट व
संवाद बाइंडिंग में सूचीबद्ध हों; संवाद निजी होना चाहिए, बिना अन्य मानव
प्रतिभागियों के। स्वामी और अधिकार हर कार्रवाई पर जाँचे जाते हैं, केवल पहली बार
खोलने पर नहीं। जब स्थायी प्रोफ़ाइल चालू हों, computer की कार्रवाइयाँ केवल
उपयुक्त बाइंडिंग के साथ चलती हैं। ब्राउज़र की स्पष्ट नेटवर्क नीति आवश्यक है —
सेट किया गया AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true या false) या
AIHUMMER_BROWSER_ALLOWED_HOSTNAMES सूची; बाहरी ब्राउज़र की cookie आयात नहीं
होतीं। दोनों सेटिंग ख़तरनाक मानी जाती हैं: प्रबंधित क्लाउड और डेमो इंस्टेंस
पर वे लॉक हैं।
साझा कौशल
ए कौशल एक पुन: प्रयोज्य निर्देश (एक प्रॉम्प्ट अंश) है जिसे एजेंटों से जोड़ा जा सकता है। लाइब्रेरी एडमिन यूआई पर रहती है साझा कौशल पृष्ठ: एक बनाने के लिए, एक नाम और पाठ काफी हैं — पहचानकर्ता (स्लग) स्वचालित रूप से उत्पन्न होता है। विक्रेता द्वारा बॉक्स से बाहर भेजे जाने वाले कौशलों में एक शामिल होता है “बॉक्स से बाहर” बिल्ला; उन्हें अक्षम किया जा सकता है लेकिन सूची में बने रहते हैं। संलग्न कौशल एजेंट के सिस्टम प्रॉम्प्ट के स्थिर उपसर्ग में प्रस्तुत किए जाते हैं।
उपकरण सक्षम करना
अधिकांश उपकरण तब चालू होते हैं जब आप उनका कॉन्फ़िगरेशन प्रदान करते हैं। सामान्य स्विच:
AIHUMMER_FS_ROOT=/srv/agent-files # filesystem_read सैंडबॉक्स को सीमित करता है (खाली = पूरा सर्वर)
AIHUMMER_DB_QUERY_DSN=postgres://... # db_query (read-only)
AIHUMMER_CODE_EXEC=1 # code_exec (sandboxed)
AIHUMMER_APPROVAL_TOOLS=mail,code_exec # require approval for these tools
AIHUMMER_AIRGAPPED=1 # block model-controlled public egress
[!TIP] उपयोग करें
AIHUMMER_APPROVAL_TOOLSकिसी भी चीज़ के साथ एक साइड के लिए अनुमोदन की आवश्यकता होना प्रभाव — मेल भेजना, कोड चलाना — जबकि केवल-पढ़ने वाले उपकरणों को बिना रोकटोक छोड़ना।
अगला कहाँ
- पूर्ण प्र उपकरण संदर्भ में देखें उपकरण सूची.
- उन टूल्स को कॉल करने वाले लूप को समझें संगठन और उप-एजेंट.
- अपने दस्तावेज़ों में उत्तरों को आधार उपकरण से जोड़ें ज्ञान / RAG.
HTML दस्तावेज़
एजेंट doc_generate और format: "html" से अधिकतम 4 MiB का UTF-8 HTML अटैचमेंट बनाता है। CSS और JavaScript सुरक्षित रहते हैं। संगत और अपडेट किया गया ऐप स्रोत व अखंडता जाँचने के बाद सहेजी गई फ़ाइल को अलग पूर्वावलोकन में खोलता है। ऐप के प्रवेश विवरण साझा नहीं किए जाते; फ़ाइल, स्रोत या लॉगिन सत्र बदलने पर पूर्वावलोकन अमान्य हो जाता है।