Työkalut

AIHUMMER_FS_ROOT=/srv/agent-files          # KAVENTAA filesystem_read-hiekkalaatikkoa (tyhjä = koko palvelin)
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

**Työkalut** ovat tapoja, joilla agentti toimii maailmassa — hakemalla sivun, etsimällä, lähettämällä sähköpostia, kyselyllä tietokantaa, luomalla asiakirjan. AiHummer toimitetaan rikkaana **sisäänrakennettu luettelo** ja a **Työkalun suoritusympäristö** joka mahdollistaa työkalut, kun ne on määritetty, lataa ne uudelleen ilman uudelleenkäynnistystä, asettaa riskialttiit työkalut ihmisen hyväksynnän taakse ja voi lukita ulosmenon kokonaan eristettyyn tilaan. Tämä sivu käsittelee, miten suoritusympäristö käyttäytyy, ja listaa sisäänrakennetut toiminnot. Täydellisen viitteen löydät osoitteesta [työkaluluettelo](/fi/v1.0/reference/tools-catalog). ## Kuinka työkalun suoritusaika käyttäytyy - **Ota käyttöön-asetuksessa.** Työkalu tulee saataville vain, kun sen edellytys konfiguraatio on läsnä — yleensä ympäristömuuttuja, joka osoittaa palvelua, jota se tarvitsee. Ei asetuksia, ei työkaluja. - **Kuuma uudelleenlataus.** Työkalun käyttöönotto koskee **kuuma**, ilman uudelleenkäynnistystä portti, jotta voit kytkeä ominaisuuksia päälle ja pois päältä suoritusajan aikana. - **Hyväksyntäportti.** Riskialttiit työkalut voidaan sijoittaa ihmisen ohjaukseen hyväksyntäportin kautta `AIHUMMER_APPROVAL_TOOLS`. Hylätty puhelu on **ei** toteutettu. - **Ilmakäytetty tila.** Asetus `AIHUMMER_AIRGAPPED=1` lohkoja malliohjatusti julkinen poistuminen, suvereenille tai eristetyille käyttöönotolle. > [!WARNING] > `code_exec` on **pois päältä oletuksena** jaettuja isäntiä. Ota se käyttöön vain siellä, missä > hiekkalaatikko ja isäntä ovat hyväksyttäviä mallin laatiman koodin suorittamiseen, ja harkitse > laittamalla sen hyväksymisportin taakse. ## Sisäänrakennetut työkalut | Työkalu | Mitä se tekee | Ota käyttöön | |---|---|---| | `web_fetch` | Hae URL-osoite (SSRF-suojattu) | oletuksena päällä | | `http_request` | Tee HTTP-pyyntö (SSRF-suojattu) | oletuksena päällä | | `web_search` | Verkkohaku sisäänrakennetun SearXNG:n kautta | oletuksena päällä; poista käytöstä asentajan lipulla `--no-search` | | `browser` | Aja todellinen selain CDP:n kautta | oletuksena päällä; poista käytöstä asentajan lipulla `--no-browser` | | `computer` | Tietokoneen käyttö CDP:n kautta | oletuksena päällä; poista käytöstä asentajan lipulla `--no-browser` | | `memory_store` | Tallenna tosiasia pitkäaikaiseen muistiin; keräystilassa `auto` (oletus) se on heti haettavissa, tiloissa `review`/`off` siitä tulee hyväksyntää odottava ehdokas | oletuksena päällä | | `memory_search` | Hae pitkäaikaisesta muistista | oletuksena päällä | | `filesystem_read` | Tiedoston lukeminen tai hakemiston listaus palvelimen levyltä | päällä oletuksena; `AIHUMMER_FS_ROOT` **kaventaa** hiekkalaatikkoa, tyhjä = koko palvelin | | `db_query` | Vain luku -tietokantakysely | `AIHUMMER_DB_QUERY_DSN` | | `mail` | Lähetä/ vastaanota sähköpostia (SMTP/IMAP) | sähköpostin tunnistetiedot (holvi) | | `code_exec` | Suorita koodi hiekkalaatikossa (pois päältä oletuksena jaetuilla palvelimilla) | `AIHUMMER_CODE_EXEC` | | `doc_generate` | Luo CSV/TSV/XLSX-dokumentteja | oletuksena päällä | | `tts` | Tekstistä puheeksi | TTS-sivuvaunu | | `image_generate` / `edit_image` | Luo ja muokkaa kuvia | konfiguroitu kuvatausta | | `github_get_file` | Hae tiedosto GitHubista | oletuksena päällä | | `generate_pairing_code` | Anna laitteen parikoodin | oletuksena päällä | | `search_knowledge` / `deep_research` | Tiedonhaku ja monivaiheinen tutkimus | tietopohja | | Bitrix24 CRM / tehtävä / kalenteri | Bitrix24 CRM:n tehtävä- ja kalenteritoiminnot | Bitrix24-laajennus | | 1C (BIT.FINANSSI OData) | 1C BIT.FINANSSI käyttö ODatan kautta | 1C OData -asetukset | > [!NOTE] > `web_fetch` ja `http_request` ovat **SSRF:n valvoma** — he kieltäytyvät pyynnöistä > sisäisiä osoitteita ja muita vaarallisia kohteita, joten malli ei voi käyttää niitä > saada yhteys yksityiseen verkkoosi. ## Jaetut taidot A **taito** on uudelleenkäytettävä ohje (kehotteen osa), joka voidaan liittää agenteille. Kirjasto sijaitsee ylläpitäjän käyttöliittymässä **Jaetut taidot** sivu: luodaksesi yhden, nimi ja teksti riittävät — tunniste (slug) johdetaan automaattisesti. Toimittajan valmiiksi mukana tulevat taidot sisältävät **Laatikosta ulos** merkki; ne voidaan poistaa käytöstä, mutta ne pysyvät listattuna. Liitetyt taidot siirretään agentin järjestelmäkehotteen vakaaseen etuliitteeseen. ## Välineiden ottaminen käyttöön Useimmat työkalut kytkeytyvät päälle, kun annat niiden asetukset. Yleisiä kytkimiä: ```bash AIHUMMER_FS_ROOT=/srv/agent-files # KAVENTAA filesystem_read-hiekkalaatikkoa (tyhjä = koko palvelin) 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] > Käyttää `AIHUMMER_APPROVAL_TOOLS` vaatia hyväksyntää kaikelle, jolla on sivu > vaikutus — postin lähettäminen, koodin suorittaminen — samalla kun kirjoitussuojatut työkalut pysyvät vapaasti saatavilla. ## Minne seuraavaksi - Katso täydellinen työkalukohtainen viite kohteessa [työkaluluettelo](/fi/v1.0/reference/tools-catalog). - Ymmärrä silmukka, joka kutsuu näitä työkaluja sisään [Orkestrointi ja aliedustajat](/fi/v1.0/concepts/orchestration-subagents). - Perusta työkalun vastaukset asiakirjoihisi [Tieto / RAG](/fi/v1.0/concepts/knowledge-rag).