Aide
Vue d'ensemble
Ce qu'est Hive, et la décision d'architecture la plus importante.
Aiqbee Hive est un graphe de connaissances auto-hébergé, conçu pour être lu et écrit par des agents IA. Il s’exécute dans un conteneur unique adossé à PostgreSQL et s’expose de deux manières :
- MCP (Model Context Protocol) — 34 outils qu’un LLM peut appeler directement. C’est l’interface principale, celle à privilégier pour créer un agent ou un assistant.
- REST (
/api/v1) — une petite API de gestion pour le provisionnement et l’automatisation : créer des brains, les lister, modifier des paramètres. Non destinée au trafic des agents.
Le vocabulaire
| Terme | De quoi il s'agit |
|---|---|
| Brain | Un graphe de connaissances. L’accès est accordé par brain, et une connexion MCP est limitée à un seul. |
| Neurone | Une unité de connaissance — un titre plus un contenu, éventuellement daté. Vectorisée à l'écriture, elle est donc consultable sémantiquement. |
| Type de neurone | Une catégorie (Décision, Compte rendu de réunion, Norme). Les types peuvent avoir leurs propres règles d’accès dans la sécurité avancée. |
| Synapse | Un lien décrit entre deux neurones. La description compte — c’est elle qui permet à un agent d’expliquer pourquoi deux éléments sont liés. |
| Compte de service | Une identité non humaine avec ses propres identifiants client. Ce sous quoi votre intégration doit s’authentifier. |
Comment un brain prend forme
Les types de neurone constituent le schéma, et ils sont propres à chaque Brain. Avant d'écrire, un agent doit appeler aiqbee_get_neuron_types et utiliser un véritable identifiant de type — ils ne se devinent pas, et un identifiant erroné est rejeté. Des types peuvent être créés à la volée avec aiqbee_add_neuron_type, mais un Brain avec quarante types quasi identiques est pire qu'un Brain avec huit bons types ; préférez donc réutiliser l'existant.
Pour aller plus loin
- Modèle d’intégration — à lire avant d’écrire du code.
- Connexion via MCP — configuration d’un compte de service et un appel fonctionnel.
- Référence des outils — les 34 outils.
- Export & import OKF — déplacez un brain sous forme de bundle markdown portable.