Concepts
Les trois noms
Section intitulée « Les trois noms »Acteur. Une définition de produit pour un agent IA : un dépôt, une
image de conteneur et un config.json. L’acteur est ce que le marketplace
liste ; il ne s’exécute pas tout seul. L’acteur est la classe.
Kompanion. L’instance en cours d’exécution d’un acteur pour un compte — une ligne de base de données plus un pod dans l’espace de noms de ce compte. Le kompanion est l’instance.
Kreator. Un créateur qui publie des acteurs sur le marketplace. C’est vous. (Le hub de l’application pour les kreators est le « Creator Hub » — ce nom de produit reste tel quel.)
Une règle simple : vous construisez un acteur ; un client exécute un kompanion ; la personne qui l’a construit est un kreator.
kaboum vs Kaoohi
Section intitulée « kaboum vs Kaoohi »Ce sont les deux moitiés d’un même pipeline, et la différence compte :
- kaboum est le template Copier qui produit les acteurs. Il génère un microservice complet FastAPI + LangChain : persistance PostgreSQL, cache Redis, sondes de santé, métriques, réglages, métadonnées marketplace. Ce n’est pas une application exécutable — vous le rendez dans un nouveau dépôt et vous l’étendez là.
- Kaoohi est la plateforme qui exécute et vend les acteurs. Elle tire
votre image publiée, lit le
config.jsoncuit dedans, liste l’acteur dans le marketplace et déploie des kompanions par compte.
Vous travaillez dans le produit de kaboum ; vos clients travaillent dans Kaoohi.
Le marketplace
Section intitulée « Le marketplace »Le marketplace est l’endroit où les acteurs sont listés et déployés. En
tant que kreator, vous enregistrez un acteur depuis son image de
conteneur : Kaoohi tire l’image, extrait et valide le config.json, et le
mène jusqu’à la revue — soumission, approbation, puis l’acteur passe en
ligne. Les clients déploient ensuite leurs propres kompanions depuis la
fiche.
La tarification se règle à l’enregistrement : un modèle tarifaire — free,
one_time ou subscription — et un prix. Un quota gratuit ou un essai
peut se poser par-dessus un modèle payant.
Le mesh est le moyen pour les kompanions d’un même compte de se joindre.
- Un groupe est un ensemble de kompanions d’un même compte qui peuvent communiquer à travers le mesh. Les groupes de comptes différents ne peuvent pas se voir.
- Le résolveur de mesh (mesh resolver) dit à chaque kompanion qui sont ses pairs : quel rôle vit à quel endpoint.
- Chaque kompanion joue un rôle de mesh — par exemple un acteur « calendrier » et un acteur « courrier » dans le même groupe, appelant les outils de l’un et de l’autre.
- Une suite est une famille d’acteurs construits pour coopérer dans un même domaine.
Un acteur adhère au mesh au moment de la génération (l’option de template
fleet_mesh) ; rien dans la participation au mesh n’est accidentel.
Un bundle est un regroupement vendable d’acteurs, avec le rôle de mesh et la dépendance de chaque membre enregistrés. Les bundles ne portent aucune topologie d’exécution en eux-mêmes — c’est le mesh qui s’en charge — ; ils sont une unité commerciale : plusieurs acteurs, achetés ensemble, câblés pour coopérer.
Connecteurs
Section intitulée « Connecteurs »Les connecteurs sont les services externes auxquels un acteur parle — WhatsApp, n8n, et d’autres. Les acteurs déclarent quels connecteurs ils exigent ou prennent en charge en option, et la plateforme provisionne les bons identifiants par kompanion. Dans le kreator-sandbox, les connecteurs tournent en mode mock pour que vous puissiez exercer des flux sans vrais comptes.
MCP (Model Context Protocol) apparaît dans deux directions :
- Votre acteur consomme des outils MCP. Définissez la variable
d’environnement
MCP_SERVERS_JSONavec un objet JSON de serveurs, et l’acteur charge leurs outils au démarrage et les fusionne avec les siens — sans changement de code. - Votre kompanion est un outil MCP. Chaque acteur peut s’exposer sur
l’edge d’API externe (
https://<platform>/api/v1/k/<ref>/…) en REST et MCP, pour que les utilisateurs finaux le pilotent depuis leurs propres agents IA.
Pour aller plus loin
Section intitulée « Pour aller plus loin »Ce guide enseigne le chemin. Les documents de référence font foi dans les dépôts :
- documentation de référence kaboum — architecture, API, configuration, guide d’extension : github.com/allcare/kaboum/tree/main/documentation
- glossaire kaoohi (normatif pour chaque terme ci-dessus) :
documentation/00-overview/glossary.mddans le dépôt kaoohi - contrat d’acteur kaoohi (ce que la plateforme exige de chaque acteur) :
documentation/30-actor-platform/actor-contract.mddans le dépôt kaoohi
Ensuite : ](fr/paths/).