Työkaluluettelo
Vuoron aikana agentti voi soittaa työkalut. AiHummerilla on sisäänrakennettu työkalujen suoritusympäristö: jotkut työkalut ovat oletuksena päällä, toiset aktivoituvat vain, kun annat tarvittavan konfiguraation. Työkalut ovat SSRF-suojattuja ja hiekkalaatikossa, kun se on asianmukaista, ja riskialttiit työkalut voidaan laittaa ihmisen hyväksynnän taakse.
Oletuksena käytössä
Nämä työkalut toimivat heti käyttövalmiina (osa riippuu konfiguroidusta mallista tai tietopohjasta).
| Työkalu | Mitä se tekee | Kuinka ottaa käyttöön |
|---|---|---|
web_fetch |
Hae URL-osoitteen sisältö. SSRF-suojattu. | Oletuksena päällä |
http_request |
Tee ulospäin menevä HTTP-pyyntö. SSRF-suojattu. | Oletuksena päällä |
web_search |
Etsi verkosta sisäänrakennetun SearXNG:n kautta. | Oletuksena päällä (toimitetaan asennusohjelman mukana); poista käytöstä lipulla --no-search |
browser / computer |
Ohjaa oikeaa selainta Chrome DevTools -protokollan kautta. | Oletuksena päällä (toimitetaan asennusohjelman mukana); poista käytöstä lipulla --no-browser |
memory_store |
Tallenna tosiasia pitkäaikaiseen muistiin (Einstein). Keräystilassa auto (oletus) tosiasia on heti haettavissa; tiloissa review/off siitä tulee hyväksyntää odottava ehdokas. Tulos sisältää searchable_now kentän. |
Oletuksena päällä |
memory_search |
Hae pitkäaikaisesta muistista (Einstein). | Oletuksena päällä |
doc_generate |
Luo asiakirjoja (CSV / TSV / XLSX). | Oletuksena päällä |
image_generate / edit_image |
Luo tai muokkaa kuvia. | Oletuksena päällä |
github_get_file |
Hae yksittäinen tiedosto GitHub-varastosta. | Oletuksena päällä |
generate_pairing_code |
Luo laitteen parikoodin. | Oletuksena päällä |
search_knowledge |
Hae tietopohjasta (RAG) ja perustele vastaukset viitteillä. | Kun tietopohja on määritetty |
deep_research |
Suorita monivaiheinen tutkimus ja laadi viittein varustettu raportti. | Oletuksena päällä |
docs_search |
Etsi tämän dokumentaation offline-versio (docs.aihummer.ru:n tilannekuva sisältyy julkaisuun, share/docs, ru/en) — agentti voi vastata tuotekysymyksiin ilman internetiä. |
Kun asiakirjojen otos on läsnä (standardi asennus) |
docs_read |
Lue täydellinen dokumentaatiotaulu löytyi kautta docs_search. |
Kun asiakirjojen otos on läsnä (standardi asennus) |
filesystem_read |
Lukee tiedoston tai listaa hakemiston palvelimen levyltä. | Aina päällä. AIHUMMER_FS_ROOT ei kytke sitä päälle vaan ainoastaan kaventaa hiekkalaatikkoa: niin kauan kuin arvo on tyhjä, juurena on koko palvelin (/). |
[!DANGER] Mitä tapahtuu: agentti lukee minkä tahansa tiedoston, jonka yhdyskäytävän palvelukäyttäjä saa lukea — mukaan lukien tiedoston, jossa ovat tietokannan yhteystiedot, ja avaimen, joka salaa salaisuusvarastoa. Millä ehdolla: niin kauan kuin asetus
AIHUMMER_FS_ROOTon tyhjä. Tämä on oletustila heti omalle palvelimelle tehdyn asennuksen jälkeen. Miten korjataan: avaa Hallinta → Asetukset, etsiAIHUMMER_FS_ROOT, osoita se hakemistoon, jota agentti oikeasti tarvitsee (esimerkiksi/srv/agent-files), ja tallenna. Arvo säilytetään tietokannassa — rivi tiedostossagateway.envohitetaan tämän avaimen kohdalla. Lisää lisäksifilesystem_readlistaanAIHUMMER_APPROVAL_TOOLS, jolloin jokainen kutsu odottaa hyväksyntääsi.AiHummerin hallitussa pilvessä työkalua ei anneta agentille lainkaan — juuri pitää kaventaa vain omassa asennuksessa.
Ota käyttöön asetuksissa
Nämä työkalut pysyvät pois päältä, kunnes osoitat ne tarvitsemalleen resurssille. Kaikki käyttöönoton säädöt (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) ovat Asetukset-luettelo avaimet: määritä ne verkkohallintakäyttöliittymässä (Hallinta → Asetukset, sillä on haku) tai kanssa aihummer settings set <KEY> <VALUE>. Laittamalla ne sisään gateway.env on ei vaikutusta — ympäristö jätetään huomiotta näille avaimille.
| Työkalu | Mitä se tekee | Kuinka ottaa käyttöön |
|---|---|---|
db_query |
Suorita vain luku - SQL-kyselyitä. | AIHUMMER_DB_QUERY_DSN |
mail |
Lähetä ja lue sähköpostia. | SMTP / IMAP-tunnistetiedot |
tts |
Synteesi puhe (tekstistä puheeksi). | AIHUMMER_TTS_URL (TTS-apuliite) |
code_exec |
Suorita koodi hiekkalaatikossa. | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execon oletuksena pois käytöstä jaetuilla palvelimilla. Ota se käyttöön vain ympäristö, jota hallitset ja johon luotat, koska se suorittaa mallin kirjoittamaa koodia. Jopa eristetty, käsittele sitä etuoikeutettuna kykynä.
Integraatiotyökalut
Kun vastaava yhteys on määritetty, agentti saa myös verkkotunnustyökalut:
| Työkalu | Mitä se tekee | Kuinka ottaa käyttöön |
|---|---|---|
| Bitrix24 CRM / tehtävä / kalenterityökalut | Lue ja toimi Bitrix24 CRM -tietueiden, tehtävien ja kalenterin perusteella. | Bitrix24-yhteys määritetty |
| 1C (BIT.FINANSSI OData) | Kysy 1C:n kirjanpitotietoja БИТ.ФИНАНС OData -rajapinnan kautta. | 1C OData-yhteys määritetty |
Hyväksyntäportti
Mikä tahansa työkalu voidaan laittaa taakse ihmisen-välissä hyväksyntäportti. Listaa työkalujen nimet kohdassa AIHUMMER_APPROVAL_TOOLS asetukset (verkkohallinnan käyttöliittymä: Hallinta → Asetukset); ennen kuin tällainen työkalu suoritetaan, operaattorin on hyväksyttävä kutsu. Hylätty kutsu on ei toteutettu.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_execIlmaraototila
Aseta AIHUMMER_AIRGAPPED asetus 1 estää mallin hallitseman julkisen ulospääsyn. Tässä tilassa agentti ei voi päästä avoimeen internetiin työkalujen kautta, mikä on sopivaa suvereenille tai eristetyille käyttöönotolle.
aihummer settings set AIHUMMER_AIRGAPPED 1[!NOTE] Rakennetun sisäisen luettelon lisäksi AiHummer voi syntetisoida työkaluja mistä tahansa OpenAPI 3.x:stä määrittele ja paljasta minkä tahansa MCP-palvelimen työkalut ilman integraatiokoodia. Katso Markkinapaikka- ja lisäosat-osio dokumentaatiossa.
Minne seuraavaksi
- Tässä viitatut muuttujat kokonaan: Ympäristömuuttujat.
- Hallinnoi käynnissä olevaa instanssia: CLI-viite.