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 CSV-, TSV-, XLSX- tai HTML-asiakirja. | Oletuksena päällä |
image_generate / edit_image |
Luo tai muokkaa kuvia. | Edellyttää määritettyä kuvapalvelua; muokkaus vaatii lisäksi kyseisen palvelun tuen kuvien muokkaukselle. |
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ä. | Oletuksena agentin oma työkansio; pääsy isäntäkoneeseen edellyttää omistajan nimenomaista tämän agentin eristystilan valintaa. Ei käytettävissä hallitussa pilvessä eikä esittelyssä. |
[!NOTE]
AIHUMMER_FS_ROOTrajaa sallittua juurta edelleen; tyhjä arvo ei anna pääsyä koko palvelimeen. Asennuksen asetuksia, sen tietokannan tunnuksia ja salausavaimia sekä prosessien ympäristöjä ei voi lukea. Hyväksyntä ei laajenna sallittua tiedostoaluetta.
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ä. Ota se käyttöön vain hallitsemassasi ja luotetussa ympäristössä: se suorittaa mallin kirjoittamaa koodia ja on etuoikeutettu toiminto myös hiekkalaatikossa.
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_exec
Ilmaraototila
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.
HTML-asiakirjat
Agentti luo doc_generate-työkalulla ja asetuksella format: "html" enintään 4 MiB:n UTF-8 HTML-liitteen. CSS ja JavaScript säilyvät. Yhteensopiva päivitetty sovellus avaa tallennetun tiedoston eristetyssä esikatselussa tarkistettuaan lähteen ja eheyden. Sovelluksen tunnuksia ei välitetä; tiedoston, lähteen tai kirjautuneen istunnon vaihtuminen mitätöi esikatselun.