Գործիքներ

SEARXNG_URL=http://localhost:8888          # web_search
CLOAKBROWSER_CDP_URL=http://localhost:9222 # browser + computer
AIHUMMER_FS_ROOT=/srv/agent-files          # filesystem_read (sandboxed root)
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

**Գործիքները** այն են, ինչով գործակալը գործում է աշխարհի վրա — բերելով էջ, որոնելով, ուղարկելով փոստ, հարցում կատարելով տվյալների բազայում, գեներացնելով փաստաթուղթ: AiHummer-ը մատակարարում է հարուստ **ներկառուցված կատալոգ** և **Tool Runtime**, որը միացնում է գործիքները, երբ դրանք կազմաձևված են, վերաբեռնում դրանք առանց վերագործարկման, ռիսկայինները դնում մարդկային հաստատման հետևում և կարող է ամբողջությամբ կողպել ելքը օդով մեկուսացված ռեժիմում: Այս էջը նկարագրում է, թե ինչպես է վարվում runtime-ը և թվարկում ներկառուցվածները: Ամբողջական տեղեկանքի համար տես [գործիքների կատալոգ](/hy/v1.0/reference/tools-catalog): ## Ինչպես է վարվում Tool Runtime-ը - **Միացում-ըստ-կազմաձևման:** Գործիքը հասանելի է դառնում միայն այն ժամանակ, երբ առկա է իր նախապայման կազմաձևումը — սովորաբար շրջակա միջավայրի փոփոխական, որը ցույց է տալիս դեպի այն ծառայությունը, որ նրան անհրաժեշտ է: Չկա կազմաձևում, չկա գործիք: - **Տաք վերաբեռնում:** Գործիքի միացումը կիրառվում է **տաք**, առանց gateway-ը վերագործարկելու, այնպես որ դուք կարող եք միացնել և անջատել հնարավորությունները աշխատանքի ընթացքում: - **Հաստատման դարպաս:** Ռիսկային գործիքները կարող են դրվել մարդը-ցիկլում հաստատման դարպասի հետևում `AIHUMMER_APPROVAL_TOOLS`-ի միջոցով: Մերժված կանչը **չի** կատարվում: - **Օդով մեկուսացված ռեժիմ:** `AIHUMMER_AIRGAPPED=1` սահմանելը արգելափակում է մոդելի կողմից վերահսկվող հանրային ելքը՝ ինքնիշխան կամ մեկուսացված տեղակայումների համար: > [!WARNING] > `code_exec`-ը **լռելյայն անջատված է** համատեղ հոսթերի վրա: Միացրեք այն միայն այնտեղ, որտեղ > ավազարկղն ու հոսթը ընդունելի են մոդելի հեղինակած կոդ գործարկելու համար, և դիտարկեք > այն հաստատման դարպասի հետևում դնելը: ## Ներկառուցված գործիքներ | Գործիք | Ինչ է անում | Միացրեք սրանով | |---|---|---| | `web_fetch` | Բերել URL (SSRF-պաշտպանված) | լռելյայն միացված | | `http_request` | Կատարել HTTP հարցում (SSRF-պաշտպանված) | լռելյայն միացված | | `web_search` | Վեբ որոնում SearXNG-ի միջոցով | `SEARXNG_URL` | | `browser` | Ղեկավարել իրական բրաուզեր CDP-ի վրա | `CLOAKBROWSER_CDP_URL` | | `computer` | Համակարգչի օգտագործում CDP-ի վրա | `CLOAKBROWSER_CDP_URL` | | `filesystem_read` | Կարդալ ֆայլեր ավազարկղ արմատում | `AIHUMMER_FS_ROOT` | | `db_query` | Միայն-կարդալու տվյալների բազայի հարցում | `AIHUMMER_DB_QUERY_DSN` | | `mail` | Ուղարկել/ստանալ փոստ (SMTP/IMAP) | փոստի հավատարմագրեր (պահոց) | | `code_exec` | Գործարկել կոդ ավազարկղում (լռելյայն անջատված համատեղ հոսթերի վրա) | `AIHUMMER_CODE_EXEC` | | `doc_generate` | Գեներացնել CSV/TSV/XLSX փաստաթղթեր | լռելյայն միացված | | `tts` | Տեքստ-խոսք | TTS sidecar | | `image_generate` / `edit_image` | Գեներացնել և խմբագրել պատկերներ | կազմաձևված պատկերի backend | | `github_get_file` | Բերել ֆայլ GitHub-ից | լռելյայն միացված | | `generate_pairing_code` | Թողարկել սարքի զուգակցման կոդ | լռելյայն միացված | | `search_knowledge` / `deep_research` | Գիտելիքի վերցում և բազմափուլ հետազոտություն | գիտելիքի բազա | | Bitrix24 CRM / առաջադրանք / օրացույց | Bitrix24 CRM, առաջադրանքի և օրացույցի գործողություններ | Bitrix24 plugin | | 1C (БИТ.ФИНАНС OData) | 1C БИТ.ФИНАНС մուտք OData-ի վրա | 1C OData կազմաձևում | > [!NOTE] > `web_fetch`-ը և `http_request`-ը **SSRF-պաշտպանված** են — դրանք մերժում են հարցումներ դեպի > ներքին հասցեներ և այլ անապահով թիրախներ, այնպես որ մոդելը չի կարող դրանք օգտագործել՝ ձեր > մասնավոր ցանց հասնելու համար: ## Ընդհանուր հմտություններ **Հմտությունը** վերաօգտագործելի հրահանգ է (պրոմպտի հատված), որը կարելի է միացնել գործակալներին: Գրադարանն ապրում է ադմին UI-ի **«Ընդհանուր հմտություններ»** էջում. ստեղծելիս բավական են անունը և տեքստը — նույնացուցիչը (slug) դուրս է բերվում ավտոմատ: Վենդորի կողմից «տուփից դուրս» մատակարարվող հմտությունները նշված են **«Տուփից դուրս»** կրծքանշանով; դրանք կարելի է անջատել, բայց դրանք մնում են ցանկում: Միացված հմտությունները ռենդերվում են գործակալի համակարգային պրոմպտի կայուն նախածանցի մեջ: ## Գործիքների միացում Գործիքների մեծ մասը միանում է, երբ դուք տրամադրում եք դրանց կազմաձևումը: Ընդհանուր անջատիչներ. ```bash SEARXNG_URL=http://localhost:8888 # web_search CLOAKBROWSER_CDP_URL=http://localhost:9222 # browser + computer AIHUMMER_FS_ROOT=/srv/agent-files # filesystem_read (sandboxed root) 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`՝ հաստատում պահանջելու համար ցանկացած կողմնակի էֆեկտ ունեցողի համար — > փոստ ուղարկելը, կոդ գործարկելը — մինչդեռ միայն-կարդալու գործիքները թողնելով չդարպասավորված: ## Ո՞ւր հաջորդիվ - Տեսեք յուրաքանչյուր գործիքի ամբողջական տեղեկանքը [գործիքների կատալոգ](/hy/v1.0/reference/tools-catalog) բաժնում: - Հասկացեք այս գործիքները կանչող ցիկլը [Օրկեստրավորում և ենթագործակալներ](/hy/v1.0/concepts/orchestration-subagents) բաժնում: - Հիմնավորեք գործիքի պատասխանները ձեր փաստաթղթերում [Գիտելիք / RAG](/hy/v1.0/concepts/knowledge-rag) բաժնի հետ: