Catalogue d'outils
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_ROOTrestreint 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_execest 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
- Les variables référencées ici en entier : Variables d’environnement.
- Gérer l’instance en cours d’exécution : Référence CLI.
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.