Werkzeugkatalog

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

aihummer settings set AIHUMMER_AIRGAPPED 1

Während einer Drehung kann der Agent anrufen **Werkzeuge**. AiHummer liefert eine eingebaute Tool-Laufzeitumgebung: Einige Werkzeuge sind standardmäßig aktiviert, andere werden nur aktiviert, wenn Sie die erforderliche Konfiguration bereitstellen. Werkzeuge sind dort, wo relevant, gegen SSRF abgesichert und in einer Sandbox ausgeführt, und riskante Werkzeuge können hinter einer menschlichen Freigabeschranke platziert werden. ## Standardmäßig aktiviert Diese Werkzeuge funktionieren sofort einsatzbereit (einige hängen von einem konfigurierten Modell oder einer Wissensbasis ab). | Werkzeug | Was es tut | Wie man aktiviert | |---|---|---| | `web_fetch` | Holen Sie die Inhalte einer URL. SSRF-geschützt. | Standardmäßig eingeschaltet | | `http_request` | Mache eine ausgehende HTTP-Anfrage. SSRF-geschützt. | Standardmäßig eingeschaltet | | `web_search` | Durchsuche das Web über das eingebaute SearXNG. | Standardmäßig eingeschaltet (mit dem Installer gebündelt); mit `--no-search` abschaltbar | | `browser` / `computer` | Steuern Sie einen echten Browser über das Chrome DevTools-Protokoll. | Standardmäßig eingeschaltet (mit dem Installer gebündelt); mit `--no-browser` abschaltbar | | `memory_store` | Einen Fakt im Langzeitgedächtnis speichern (Einstein). Im Erfassungsmodus `auto` (Standard) ist der Fakt sofort auffindbar; bei `review`/`off` wird er zum Kandidaten, der auf Freigabe wartet. Das Ergebnis trägt ein Feld `searchable_now`. | Standardmäßig eingeschaltet | | `memory_search` | Das Langzeitgedächtnis durchsuchen (Einstein). | Standardmäßig eingeschaltet | | `doc_generate` | Dokumente erstellen (CSV / TSV / XLSX). | Standardmäßig eingeschaltet | | `image_generate` / `edit_image` | Bilder erstellen oder bearbeiten. | Standardmäßig eingeschaltet | | `github_get_file` | Eine einzelne Datei aus einem GitHub-Repository abrufen. | Standardmäßig eingeschaltet | | `generate_pairing_code` | Einen Geräte-Kopplungscode ausgeben. | Standardmäßig eingeschaltet | | `search_knowledge` | Durchsuchen Sie die Wissensdatenbank (RAG) und untermauern Sie Antworten mit Zitaten. | Mit einer konfigurierten Wissensdatenbank | | `deep_research` | Führen Sie mehrstufige Recherchen durch und erstellen Sie einen zitierten Bericht. | Standardmäßig eingeschaltet | | `docs_search` | Suche ein **Offline-Kopie dieser Dokumentation** (Ein docs.aihummer.ru-Snapshot wird in der Version geliefert, `share/docs`, ru/en) — der Agent kann Produktfragen ohne Internet beantworten. | Mit dem vorhandenen Docs-Snapshot (Standardinstallation) | | `docs_read` | Lesen Sie eine vollständige Dokumentationsseite, die über gefunden wurde `docs_search`. | Mit dem vorhandenen Docs-Snapshot (Standardinstallation) | | `filesystem_read` | Liest eine Datei oder listet ein Verzeichnis auf der Festplatte des Servers. | **Immer eingeschaltet.** `AIHUMMER_FS_ROOT` schaltet das Werkzeug nicht ein, sondern **verengt** nur die Sandbox: solange der Wert leer ist, ist die Sandbox-Wurzel der gesamte Server (`/`). | > [!DANGER] > **Was passiert:** Der Agent liest jede Datei, die der Dienstbenutzer des > Gateways lesen darf — einschließlich der Datei mit den Zugangsdaten zur > Datenbank und des Schlüssels, der den Geheimnisspeicher verschlüsselt. > **Unter welcher Bedingung:** solange die Einstellung `AIHUMMER_FS_ROOT` leer > ist. Das ist der Zustand direkt nach einer Installation auf eigenem Server. > **Wie man es behebt:** Öffnen Sie **Verwaltung → Einstellungen**, suchen Sie > `AIHUMMER_FS_ROOT`, tragen Sie das Verzeichnis ein, das der Agent wirklich > braucht (zum Beispiel `/srv/agent-files`), und speichern Sie. Der Wert liegt > in der Datenbank — eine Zeile in `gateway.env` wird für diesen Schlüssel > ignoriert. Tragen Sie zusätzlich `filesystem_read` in > `AIHUMMER_APPROVAL_TOOLS` ein, damit jeder Aufruf auf Ihre Freigabe wartet. > > In der verwalteten AiHummer-Cloud erhält der Agent dieses Werkzeug gar nicht — > die Wurzel muss nur bei eigener Installation verengt werden. ## Auf Konfiguration aktivieren Diese Werkzeuge bleiben ausgeschaltet, bis Sie sie auf die Ressource richten, die sie benötigen. Alle Aktivierungsknöpfe (`AIHUMMER_DB_QUERY_DSN`, `AIHUMMER_CODE_EXEC`, …) sind **Einstellungen-Katalog** Schlüssel: Legen Sie sie in der Web-Admin-Oberfläche fest (**Management → Einstellungen**, es hat Suche) oder mit `aihummer settings set <KEY> <VALUE>`. Sie hineingeben `gateway.env` hat **keine Wirkung** — die Umgebung wird für diese Schlüssel ignoriert. | Werkzeug | Was es tut | Wie man aktiviert | |---|---|---| | `db_query` | Führen Sie schreibgeschützte SQL-Abfragen aus. | `AIHUMMER_DB_QUERY_DSN` | | `mail` | E-Mails senden und lesen. | SMTP / IMAP-Zugangsdaten | | `tts` | Sprache synthetisieren (Text-zu-Sprache). | `AIHUMMER_TTS_URL` (TTS-Beifahrer) | | `code_exec` | Führen Sie Code in einer Sandbox aus. | `AIHUMMER_CODE_EXEC` | > [!DANGER] > `code_exec` ist **standardmäßig auf gemeinsam genutzten Hosts deaktiviert**. Aktivieren Sie es nur in einem > Umgebung, die Sie kontrollieren und der Sie vertrauen, weil sie vom Modell erstellten Code ausführt. Sogar > in einer Sandbox ausgeführt, behandle es als eine privilegierte Fähigkeit. ## Integrationswerkzeuge Wenn die passende Verbindung konfiguriert ist, erhält der Agent auch Domain-Tools: | Werkzeug | Was es tut | Wie man aktiviert | |---|---|---| | Bitrix24 CRM / Aufgaben- / Kalender-Tools | Lesen und bearbeiten Sie Bitrix24 CRM-Datensätze, Aufgaben und Kalender. | Bitrix24-Verbindung konfiguriert | | 1C (BIT.FINANZ OData) | Abfrage von 1C-Buchhaltungsdaten über die OData-Schnittstelle БИТ.ФИНАНС. | 1C OData-Verbindung konfiguriert | ## Genehmigungstor Jedes Werkzeug kann hinter einem platziert werden **Mensch-im-Loop-Freigabetor**. Listen Sie die Werkzeugnamen in der `AIHUMMER_APPROVAL_TOOLS` Einstellung (Web-Admin-Benutzeroberfläche: Verwaltung → Einstellungen); bevor ein solches Tool ausgeführt wird, muss ein Betreiber den Aufruf genehmigen. Ein abgelehnter Aufruf ist **nicht** ausgeführt. ```bash aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec ``` ## Luftdicht getrennter Modus Einstellen des `AIHUMMER_AIRGAPPED` Einstellung zu `1` um den modellgesteuerten öffentlichen Ausgang zu blockieren. In diesem Modus kann der Agent nicht über Werkzeuge auf das offene Internet zugreifen, was für souveräne oder isolierte Einsatzszenarien geeignet ist. ```bash aihummer settings set AIHUMMER_AIRGAPPED 1 ``` > [!NOTE] > Über den eingebauten Katalog hinaus kann AiHummer Werkzeuge aus jeder OpenAPI 3.x synthetisieren > Spezifizieren und offenlegen Sie die Werkzeuge eines beliebigen MCP-Servers ohne Integrationscode. Siehe die > Marketplace- & Plugins-Bereich der Dokumentation. ## Wohin als Nächstes - Die hier vollständig referenzierten Variablen: [Umgebungsvariablen](/de/v1.0/reference/env-vars). - Verwalten Sie die laufende Instanz: [CLI-Referenz](/de/v1.0/reference/cli).