Ailu depuis vos outils

L'API

Chaque requête porte un jeton — Authorization: Bearer, avec votre jeton de session ou une clé d'API — et peut nommer l'organisation visée — x-tenant-id — quand on en a plusieurs. Le rôle et l'appartenance se lisent toujours côté serveur : l'en-tête n'accorde rien.

Les clés d'API

Une clé lance et lit les runs de l'organisation depuis la CI, un script ou n8n, sans la session d'une personne. Un propriétaire la crée avec un nom, une durée en mois et ses portées — lancer un run, lire les runs —, puis la copie : elle ne s'affiche qu'une fois, Ailu n'en garde qu'une empreinte. Elle se révoque à tout moment.

1. Elle n'approuve jamais une porte et ne touche ni aux membres, ni aux clés, ni aux politiques.
2. Un run lancé avec une clé passe les mêmes portes, politiques et plafonds qu'un run lancé par une personne ; le journal le signe au nom de la clé, et la personne qui l'a créée compte comme celle qui a lancé le run.
3. Par clé : 60 requêtes par minute sur l'offre Gratuit, et partout tant que l'équipe Ailu n'a pas activé les limites par offre. Avec elles : 300 sur Équipe, 600 sur Régulé, 1 200 sur Entreprise. Pendant la bêta, une organisation Gratuit est traitée comme Équipe : 300 par clé, une fois les limites par offre activées.
4. POST /runs : 20 démarrages par minute, comptés par clé avec les limites par offre, par adresse IP sinon. Avec elles, l'organisation a aussi un plafond de démarrages par minute selon son offre.
5. Au-delà d'une limite, l'API répond 429. Un graphe inconnu, ou d'une autre organisation, répond 404.

Les webhooks

Ailu prévient vos outils quand un run se termine ou attend, quand une approbation est demandée ou rendue, quand une délégation est refusée ou qu'un incident s'ouvre. Un propriétaire ajoute l'URL et choisit les événements.

1. Chaque envoi ne porte que des identifiants, un statut et des liens — jamais le contenu d'un run. Le secret de signature ne s'affiche qu'une fois.
2. L'en-tête Ailu-Signature vaut t=<unix>,v1=<hex HMAC-SHA256(secret, "<t>.<corps brut>")>. Acceptez l'envoi si un v1 correspond et si t a moins de 300 secondes d'écart avec votre horloge.
3. Pendant une rotation du secret, l'en-tête porte un v1 par secret : un seul doit correspondre.
4. Huit tentatives par envoi ; après 20 envois échoués d'affilée, le webhook est désactivé et les propriétaires sont prévenus par e-mail.

Le serveur MCP

Le serveur MCP d'Ailu tourne en local, sur votre machine, lancé par votre éditeur. Certains outils appellent le plan de contrôle avec le jeton et l'organisation que vous lui donnez. Les autres s'exécutent sur place, sans lui.

1. Connaissance, avec votre rôle : search_brain, get_context, brain_*, index_local. Ce qu'index_local indexe reste en attente jusqu'à sa revue dans la connaissance gouvernée.
2. Compétences, avec votre rôle : list_skills, get_skill. Ils lisent les compétences de votre organisation.
3. Modules, sur place : list_modules, get_module, plan_module_workflow, run_module_workflow. Ils lisent le catalogue livré avec le serveur, pas votre organisation.
4. Agents et graphes, sur place : list_agents, run_agent, run_graph, approve_and_resume, validate_graph, compile_graph_yaml. run_agent et run_graph n'exécutent que les agents et graphes d'exemple du serveur, jamais les graphes de votre organisation.

Les SDK du moteur

@ailu-ai/graph-sdk (TypeScript, npm) et adriane-ai (Python, PyPI) construisent, valident et exécutent des graphes dans votre propre processus, avec le même runtime que le plan de contrôle.

Pas encore

BientôtUn point d'accès MCP hébergé, avec OAuth.

BientôtLa référence complète de l'API, générée depuis son document OpenAPI.