AiHummer
Français▾
ConnexionCompte
v1.6.x▾
{ }Swagger

Catalogue d'outils

v1.6.x · mis à jour 2026-11-15

Lors d’un tour, l’agent peut appeler outils. AiHummer expédie un runtime d’outils intégré : certains outils sont activés par défaut, d’autres ne s’activent que lorsque vous fournissez la configuration requise. Les outils sont protégés contre le SSRF et isolés dans des sandbox lorsque cela est pertinent, et les outils risqués peuvent être placés derrière une validation humaine.

Activé par défaut

Ces outils fonctionnent immédiatement (certains dépendent d’un modèle ou d’une base de connaissances configurés).

Outil Ce que cela fait Comment activer
web_fetch Récupérer le contenu d’une URL. Protégé contre le SSRF. Activé par défaut
http_request Faire une requête HTTP sortante. Protégé contre le SSRF. Activé par défaut
web_search Chercher sur le web via le SearXNG intégré. Activé par défaut (fourni avec l’installateur) ; se désactive avec --no-search
browser / computer Pilotez un véritable navigateur via le protocole Chrome DevTools. Activé par défaut (fourni avec l’installateur) ; se désactive avec --no-browser
memory_store Enregistrer un fait dans la mémoire à long terme (Einstein). Avec le mode de capture auto (par défaut), le fait est immédiatement consultable ; avec review/off, il devient un candidat en attente d’approbation. Le résultat porte un champ searchable_now. Activé par défaut
memory_search Rechercher dans la mémoire à long terme (Einstein). Activé par défaut
doc_generate Créer un document CSV / TSV / XLSX ou HTML. Activé par défaut
image_generate / edit_image Générer ou modifier des images. Nécessite un service d’images configuré ; la retouche exige aussi que ce service prenne cette opération en charge.
github_get_file Récupérer un seul fichier depuis un dépôt GitHub. Activé par défaut
generate_pairing_code Émettre un code d’appairage de l’appareil. Activé par défaut
search_knowledge Recherchez dans la base de connaissances (RAG) et fondez les réponses sur des citations. Avec une base de connaissances configurée
deep_research Effectuez des recherches en plusieurs étapes et produisez un rapport cité. Activé par défaut
docs_search Rechercher un copie hors ligne de cette documentation (un instantané docs.aihummer.ru est inclus dans la version, share/docs, ru/en) — l’agent peut répondre aux questions sur les produits sans Internet. Avec l’instantané des documents présent (installation standard)
docs_read Lire une page de documentation complète trouvée via docs_search. Avec l’instantané des documents présent (installation standard)
filesystem_read Lit un fichier ou liste un répertoire sur le disque du serveur. Par défaut, le dossier de travail propre à l’agent ; l’accès à l’hôte exige un choix explicite du confinement de cet agent par le propriétaire. Indisponible dans le cloud géré et la démonstration.

[!NOTE] AIHUMMER_FS_ROOT restreint davantage la racine autorisée ; une valeur vide ne donne pas accès à tout le serveur. Les paramètres de l’installation, ses identifiants de base de données et clés de chiffrement, ainsi que les environnements des processus, ne sont pas lisibles. L’approbation n’élargit pas le périmètre de fichiers autorisé.

Activer dans la configuration

Ces outils restent éteints jusqu’à ce que vous les dirigiez vers la ressource dont ils ont besoin. Tous les boutons d’activation (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) sont Catalogue des paramètres clés : configurez-les dans l’interface d’administration web (Gestion → Paramètres, il a recherche) ou avec aihummer settings set <KEY> <VALUE>. Les mettre dedans gateway.env a aucun effet — l’environnement est ignoré pour ces clés.

Outil Ce que cela fait Comment activer
db_query Exécuter des requêtes SQL en lecture seule. AIHUMMER_DB_QUERY_DSN
mail Envoyer et lire des e-mails. Identifiants SMTP / IMAP
tts Synthétiser la parole (texte en parole). AIHUMMER_TTS_URL (TTS côté client)
code_exec Exécuter du code dans un bac à sable. AIHUMMER_CODE_EXEC

[!DANGER] code_exec est désactivé par défaut. Activez-le uniquement dans un environnement que vous contrôlez et auquel vous faites confiance : il exécute du code rédigé par le modèle et reste une capacité privilégiée, même dans un bac à sable.

Outils d’intégration

Lorsque la connexion correspondante est configurée, l’agent obtient également des outils de domaine :

Outil Ce que cela fait Comment activer
Outils CRM / tâches / calendrier Bitrix24 Lire et agir sur les enregistrements, les tâches et le calendrier du CRM Bitrix24. Connexion Bitrix24 configurée
1C (BIT.FINANCE OData) Interroger les données comptables 1C via l’interface OData БИТ.ФИНАНС. Connexion OData 1C configurée

Portail d’approbation

Tout outil peut être placé derrière un porte d’approbation avec intervention humaine. Listez les noms des outils dans le AIHUMMER_APPROVAL_TOOLS paramètre (interface administrateur web : Gestion → Paramètres) ; avant qu’un tel outil ne fonctionne, un opérateur doit approuver l’appel. Un appel rejeté est pas exécuté.

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

Mode isolé

Définir le AIHUMMER_AIRGAPPED réglage sur 1 bloquer la sortie publique contrôlée par le modèle. Dans ce mode, l’agent ne peut pas accéder à Internet ouvert via des outils, ce qui est approprié pour des déploiements souverains ou isolés.

aihummer settings set AIHUMMER_AIRGAPPED 1

[!NOTE] Au-delà du catalogue intégré, AiHummer peut synthétiser des outils à partir de n’importe quel OpenAPI 3.x spécifier et exposer les outils de n’importe quel serveur MCP sans code d’intégration. Voir le Section Marketplace & Plugins de la documentation.

Où aller ensuite

Documents HTML

Avec doc_generate et format: "html", l’agent crée une pièce jointe HTML de 4 Mio maximum en UTF-8, avec CSS et JavaScript. Une application compatible à jour ouvre le fichier enregistré dans un aperçu isolé après vérification de sa source et de son intégrité. Les identifiants de l’application ne sont pas transmis ; changer le fichier, la source ou la session connectée invalide l’aperçu.