Katalog narzędzi
Podczas tury agent może zadzwonić narzędzia. AiHummer dostarcza wbudowane środowisko uruchomieniowe dla narzędzi: niektóre narzędzia są włączone domyślnie, inne aktywują się tylko wtedy, gdy podasz wymaganą konfigurację. Narzędzia mają ochronę przed SSRF i są piaskownicowane tam, gdzie ma to znaczenie, a ryzykowne narzędzia mogą być umieszczone za bramką wymagającą zatwierdzenia przez człowieka.
Włączone domyślnie
Te narzędzia działają od razu po wyjęciu z pudełka (niektóre zależą od skonfigurowanego modelu lub bazy wiedzy).
| Narzędzie | Co to robi | Jak włączyć |
|---|---|---|
web_fetch |
Pobierz zawartość adresu URL. Chronione przed SSRF. | Włączony domyślnie |
http_request |
Wykonaj wychodzące żądanie HTTP. Chronione przed SSRF. | Włączony domyślnie |
web_search |
Przeszukaj sieć przez wbudowany SearXNG. | Włączony domyślnie (dostarczany z instalatorem); wyłączysz flagą --no-search |
browser / computer |
Steruj prawdziwą przeglądarką za pomocą protokołu Chrome DevTools. | Włączony domyślnie (dostarczany z instalatorem); wyłączysz flagą --no-browser |
memory_store |
Zapisz fakt w pamięci długoterminowej (Einstein). W trybie zbierania auto (domyślnym) fakt jest przeszukiwalny natychmiast; przy review/off staje się kandydatem oczekującym na zatwierdzenie. Wynik zawiera pole searchable_now. |
Włączony domyślnie |
memory_search |
Przeszukuj pamięć długoterminową (Einstein). | Włączony domyślnie |
doc_generate |
Tworzenie dokumentów CSV / TSV / XLSX lub HTML. | Włączony domyślnie |
image_generate / edit_image |
Twórz lub edytuj obrazy. | Wymaga skonfigurowanej usługi obrazów; edycja wymaga również obsługi tej operacji przez tę usługę. |
github_get_file |
Pobierz pojedynczy plik z repozytorium GitHub. | Włączony domyślnie |
generate_pairing_code |
Wydaj kod parowania urządzenia. | Włączony domyślnie |
search_knowledge |
Przeszukaj bazę wiedzy (RAG) i uzasadnij odpowiedzi cytowaniami. | Z skonfigurowaną bazą wiedzy |
deep_research |
Przeprowadź wieloetapowe badania i przygotuj raport z cytowaniami. | Włączony domyślnie |
docs_search |
Szukaj offline’owa kopia tej dokumentacji (zrzut docs.aihummer.ru jest dostarczany w wydaniu, share/docs, ru/en) — agent może odpowiadać na pytania dotyczące produktów bez internetu. |
Z obecnością zrzutu dokumentów (standardowa instalacja) |
docs_read |
Przeczytaj pełną stronę dokumentacji dostępną przez docs_search. |
Z obecnością zrzutu dokumentów (standardowa instalacja) |
filesystem_read |
Czyta plik lub wypisuje zawartość katalogu na dysku serwera. | Domyślnie własny katalog roboczy agenta; dostęp do hosta wymaga jawnego wyboru izolacji tego agenta przez właściciela. Niedostępne w zarządzanej chmurze i demonstracji. |
[!NOTE]
AIHUMMER_FS_ROOTdodatkowo zawęża dozwolony katalog główny; pusta wartość nie daje dostępu do całego serwera. Ustawienia instalacji, jej dane dostępowe do bazy i klucze szyfrowania oraz środowiska procesów nie są odczytywalne. Zatwierdzenie nie rozszerza dozwolonego zakresu plików.
Włącz w konfiguracji
Te narzędzia pozostają wyłączone, dopóki nie skierujesz ich na zasób, którego potrzebują. Wszystkie pokrętła włączające (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) są Ustawienia-katalog klucze: ustaw je w interfejsie administracyjnym sieciowym (Zarządzanie → Ustawienia, ma wyszukiwanie) lub z aihummer settings set <KEY> <VALUE>. Wkładając je gateway.env ma brak efektu — środowisko jest ignorowane dla tych kluczy.
| Narzędzie | Co to robi | Jak włączyć |
|---|---|---|
db_query |
Uruchamiaj zapytania SQL tylko do odczytu. | AIHUMMER_DB_QUERY_DSN |
mail |
Wysyłaj i czytaj e-maile. | Dane uwierzytelniające SMTP / IMAP |
tts |
Syntezuj mowę (tekst na mowę). | AIHUMMER_TTS_URL (pliki pomocnicze TTS) |
code_exec |
Wykonaj kod w piaskownicy. | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execjest domyślnie wyłączone. Włączaj je tylko w kontrolowanym i zaufanym środowisku: wykonuje kod napisany przez model i pozostaje uprzywilejowaną funkcją nawet w piaskownicy.
Narzędzia integracyjne
Gdy zostanie skonfigurowane dopasowane połączenie, agent otrzymuje również narzędzia domeny:
| Narzędzie | Co to robi | Jak włączyć |
|---|---|---|
| Narzędzia Bitrix24 CRM / zadania / kalendarz | Czytaj i działaj na rekordach CRM, zadaniach i kalendarzu Bitrix24. | Połączenie Bitrix24 skonfigurowane |
| 1C (BIT.FINANS OData) | Zapytanie danych księgowych 1C przez interfejs OData БИТ.ФИНАНС. | Połączenie 1C OData skonfigurowane |
Brama zatwierdzenia
Każde narzędzie można umieścić za bramka zatwierdzająca z udziałem człowieka. Wymień nazwy narzędzi w AIHUMMER_APPROVAL_TOOLS ustawienie (interfejs administracyjny sieci: Zarządzanie → Ustawienia); przed uruchomieniem takiego narzędzia operator musi zatwierdzić wywołanie. Odrzucone wywołanie jest nie wykonano.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Tryb odseparowany od sieci
Ustaw AIHUMMER_AIRGAPPED ustawienie na 1 blokować modelowo kontrolowany publiczny dostęp wychodzący. W tym trybie agent nie może uzyskać dostępu do otwartego internetu przez narzędzia, co jest odpowiednie dla suwerennych lub izolowanych wdrożeń.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE] Poza wbudowanym katalogiem, AiHummer może tworzyć narzędzia z dowolnego OpenAPI 3.x specyfikacja i ujawnienie narzędzi dowolnego serwera MCP bez kodu integracyjnego. Zobacz Sekcja Marketplace i wtyczek w dokumentacji.
Dokąd dalej
- Zmienne tutaj wymienione w pełni: Zmienne środowiskowe.
- Zarządzaj działającą instancją: Odwołanie CLI.
Dokumenty HTML
Agent używa doc_generate z format: "html", aby utworzyć załącznik HTML do 4 MiB w UTF-8. CSS i JavaScript są zachowane. Zgodna, zaktualizowana aplikacja otwiera zapisany plik w odizolowanym podglądzie po sprawdzeniu źródła i integralności. Dane logowania aplikacji nie są przekazywane; zmiana pliku, źródła lub sesji unieważnia podgląd.