उपकरण सूची
मोड़ के दौरान एजेंट कॉल कर सकता है उपकरण. AiHummer में एक बिल्ट-इन टूल रनटाइम होता है: कुछ टूल डिफ़ॉल्ट रूप से चालू रहते हैं, अन्य केवल तब सक्रिय होते हैं जब आप आवश्यक कॉन्फ़िगरेशन प्रदान करते हैं। टूल्स SSRF-गार्डेड और जहाँ प्रासंगिक हो सैंडबॉक्स्ड होते हैं, और जोखिम भरे टूल्स को मानव अनुमोदन गेट के पीछे रखा जा सकता है।
डिफ़ॉल्ट रूप से सक्षम
ये उपकरण बिना किसी सेटअप के काम करते हैं (कुछ का निर्भरता एक कॉन्फ़िगर किया हुआ मॉडल या ज्ञान आधार पर है)।
| उपकरण | यह क्या करता है | सक्षम कैसे करें |
|---|---|---|
web_fetch |
किसी URL की सामग्री प्राप्त करें। SSRF-सुरक्षित। | डिफ़ॉल्ट रूप से चालू |
http_request |
एक आउटबाउंड HTTP अनुरोध करें। SSRF-रक्षित। | डिफ़ॉल्ट रूप से चालू |
web_search |
बिल्ट-इन SearXNG के माध्यम से वेब पर खोजें। | डिफ़ॉल्ट रूप से चालू (इंस्टॉलर के साथ बंडल); --no-search से बंद करें |
browser / computer |
क्रोम डेवलपर टूल्स प्रोटोकॉल के माध्यम से असली ब्राउज़र चलाएँ। | डिफ़ॉल्ट रूप से चालू (इंस्टॉलर के साथ बंडल); --no-browser से बंद करें |
memory_store |
दीर्घकालिक मेमोरी (आइंस्टीन) में कोई तथ्य संग्रहीत करें। कैप्चर मोड auto (डिफ़ॉल्ट) में तथ्य तुरंत खोजा जा सकता है; review/off में यह अनुमोदन की प्रतीक्षा करने वाला उम्मीदवार बन जाता है। परिणाम में searchable_now फ़ील्ड होता है। |
डिफ़ॉल्ट रूप से चालू |
memory_search |
दीर्घकालिक मेमोरी (आइंस्टीन) में खोजें। | डिफ़ॉल्ट रूप से चालू |
doc_generate |
दस्तावेज़ बनाएँ (CSV / TSV / XLSX)। | डिफ़ॉल्ट रूप से चालू |
image_generate / edit_image |
छवियाँ उत्पन्न करें या संपादित करें। | डिफ़ॉल्ट रूप से चालू |
github_get_file |
GitHub रिपॉज़िटरी से एक फ़ाइल प्राप्त करें। | डिफ़ॉल्ट रूप से चालू |
generate_pairing_code |
एक डिवाइस पेयरिंग कोड जारी करें। | डिफ़ॉल्ट रूप से चालू |
search_knowledge |
ज्ञान आधार (RAG) में खोज करें और उत्तरों को संदर्भों के साथ सिद्ध करें। | एक ज्ञान आधार के साथ कॉन्फ़िगर किया गया |
deep_research |
बहु-चरणीय शोध संचालित करें और एक उद्धृत रिपोर्ट तैयार करें। | डिफ़ॉल्ट रूप से चालू |
docs_search |
एक खोजें इस दस्तावेज़ की ऑफ़लाइन प्रति (रिलीज़ में docs.aihummer.ru का स्नैपशॉट भेजा जाता है, share/docs, ru/en) — एजेंट इंटरनेट के बिना उत्पाद संबंधित सवालों का उत्तर दे सकता है। |
डॉक्स स्नैपशॉट मौजूद होने के साथ (मानक इंस्टॉल) |
docs_read |
पूरा प्रलेखन पृष्ठ पढ़ें जो इस माध्यम से पाया गया docs_search. |
डॉक्स स्नैपशॉट मौजूद होने के साथ (मानक इंस्टॉल) |
filesystem_read |
सर्वर की डिस्क पर कोई फ़ाइल पढ़ता है या डायरेक्ट्री की सूची दिखाता है। | हमेशा चालू। AIHUMMER_FS_ROOT इसे चालू नहीं करता, केवल सैंडबॉक्स को सीमित करता है: जब तक मान खाली है, सैंडबॉक्स की जड़ पूरा सर्वर (/) है। |
[!DANGER] क्या होगा: एजेंट हर वह फ़ाइल पढ़ लेगा जिसे गेटवे सेवा का उपयोगकर्ता पढ़ सकता है — इसमें डेटाबेस कनेक्शन विवरण वाली फ़ाइल और वह कुंजी भी शामिल है जिससे गुप्त-भंडार एन्क्रिप्ट किया गया है। किस स्थिति में: जब तक सेटिंग
AIHUMMER_FS_ROOTखाली है। अपने सर्वर पर इंस्टॉल करने के तुरंत बाद यही डिफ़ॉल्ट स्थिति होती है। कैसे ठीक करें: प्रबंधन → सेटिंग्स खोलें,AIHUMMER_FS_ROOTखोजें, वह डायरेक्ट्री दें जिसकी एजेंट को वास्तव में ज़रूरत है (उदाहरण के लिए/srv/agent-files) और सहेजें। मान डेटाबेस में रहता है — इस कुंजी के लिएgateway.envकी पंक्ति अनदेखी कर दी जाती है। इसके अलावाfilesystem_readकोAIHUMMER_APPROVAL_TOOLSमें डालें ताकि हर कॉल आपकी स्वीकृति की प्रतीक्षा करे।AiHummer के प्रबंधित क्लाउड में यह उपकरण एजेंट को दिया ही नहीं जाता — जड़ को केवल अपनी इंस्टॉलेशन पर सीमित करना होता है।
कॉन्फ़िगरेशन पर सक्षम करें
ये उपकरण बंद रहते हैं जब तक कि आप उन्हें उस संसाधन की ओर इंगित न करें जिसकी उन्हें आवश्यकता है। सभी सक्षम करने वाले नॉब्स (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) हैं सेटिंग्स-कैटलॉग कुंजियाँ: उन्हें वेब एडमिन UI में सेट करें (प्रबंधन → सेटिंग्स, यह खोज है) या साथ में aihummer settings set <KEY> <VALUE>. उन्हें डालना gateway.env है कोई प्रभाव नहीं — इन कुंजियों के लिए पर्यावरण की अनदेखी की जाती है।
| उपकरण | यह क्या करता है | सक्षम कैसे करें |
|---|---|---|
db_query |
सिर्फ पढ़ने वाले SQL क्वेरी चलाएँ। | AIHUMMER_DB_QUERY_DSN |
mail |
ईमेल भेजें और पढ़ें। | SMTP / IMAP प्रमाण-पत्र |
tts |
भाषण संश्लेषित करें (टेक्स्ट-टू-स्पीच)। | AIHUMMER_TTS_URL (TTS साइडकार) |
code_exec |
सैंडबॉक्स में कोड निष्पादित करें। | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execहै साझा होस्ट पर डिफ़ॉल्ट रूप से बंद. इसे केवल एक में सक्षम करें ऐसा वातावरण जिसे आप नियंत्रित और भरोसा करते हैं, क्योंकि यह मॉडल-लेखक कोड चलाता है। यहां तक कि सैंडबॉक्स किए गए, इसे एक विशेषाधिकार प्राप्त क्षमता के रूप में मानें।
एकीकरण उपकरण
जब मिलान कनेक्शन कॉन्फ़िगर किया जाता है, एजेंट को डोमेन टूल्स भी मिलते हैं:
| उपकरण | यह क्या करता है | सक्षम कैसे करें |
|---|---|---|
| Bitrix24 सीआरएम / कार्य / कैलेंडर उपकरण | Bitrix24 CRM रिकॉर्ड, कार्य और कैलेंडर पढ़ें और उन पर कार्रवाई करें। | Bitrix24 कनेक्शन कॉन्फ़िगर किया गया |
| 1C (बिट.फाइनेंस OData) | БИТ.ФИНАНС OData इंटरफ़ेस पर 1C अकाउंटिंग डेटा को क्वेरी करें। | 1C OData कनेक्शन कॉन्फ़िगर किया गया |
अनुमोदन द्वार
किसी भी उपकरण को पीछे रखा जा सकता है मानव-इन-द-लूप अनुमोदन द्वार. टूल के नाम सूचीबद्ध करें AIHUMMER_APPROVAL_TOOLS सेटिंग (वेब एडमिन UI: प्रबंधन → सेटिंग्स); ऐसे टूल को चलाने से पहले, एक ऑपरेटर को कॉल को मंजूरी देनी चाहिए। अस्वीकार की गई कॉल नहीं संपन्न किया गया।
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_execएयर-गैप्ड मोड
सेट करें AIHUMMER_AIRGAPPED सेटिंग करने के लिए 1 मॉडल-नियंत्रित सार्वजनिक निकास को ब्लॉक करने के लिए। इस मोड में एजेंट टूल्स के माध्यम से खुले इंटरनेट तक नहीं पहुँच सकता, जो संप्रभु या पृथक तैनाती के लिए उपयुक्त है।
aihummer settings set AIHUMMER_AIRGAPPED 1[!NOTE] बिल्ट-इन कैटलॉग के अलावा, AiHummer किसी भी OpenAPI 3.x से टूल्स सिंथेसाइज़ कर सकता है किसी भी MCP सर्वर के टूल्स को बिना किसी इंटीग्रेशन कोड के स्पेक और एक्सपोज़ करें। देखें दस्तावेज़ों का मार्केटप्लेस और प्लगइन्स अनुभाग।
अगला कहाँ
- यहाँ संदर्भित चर पूरी तरह से: पर्यावरण चर.
- चल रही इंस्टेंस प्रबंधित करें: CLI संदर्भ.