Outils pour développeurs
Utilisez une seule clé API avec l’API Ciele, la CLI ou le serveur MCP.
Ciele propose trois interfaces pour l’administration par programmation. Chaque interface utilise les mêmes opérations et les mêmes vérifications de rôles que l’administrator console.
Pour identifier l’opération associée à un contrôle de la console, ouvrez le Developer Panel sur cette page.
Pour explorer l’interface, ouvrez la bibliothèque de composants publique. Chaque page traite d’un composant et de ses états ou variantes. La section Blocks contient des fonctionnalités complètes, telles que des tableaux, des conversations et des éditeurs. Les deux sections comportent les onglets Preview, Usage et Code. Vous pouvez effectuer une recherche dans chaque section et modifier son thème ou sa palette. Les aperçus utilisent du contenu d’exemple. L’onglet Code affiche les fichiers source de la build actuelle.
Developer Panel
Read the snippet for the console page you have open.
API
Call the versioned HTTP API and read its OpenAPI contract.
CLI
Manage an Organization from a terminal or a CI job.
MCP server
Give supported AI clients controlled access to Ciele operations.
AI clients
Configure supported clients and use copyable prompts.
Modèle de connexion commun
Les trois interfaces nécessitent une clé API d’organisation. Le Role attribué détermine les opérations que la clé peut utiliser.
Le service hébergé utilise https://ciele.app par défaut. Une installation
auto-hébergée utilise sa propre origine publique.
Use the minimum Role
Create a Viewer key for read operations. Create a higher-role key only when the client must change data or publish an Assistant. A Viewer key is not a read-only agent: it can also curate the Inbox (pin, leave feedback, delete a conversation). For a key that only reads, create a custom Role in Settings > Roles without the Triage conversations and Delete conversations capabilities, and give that Role to the key.
Domaines disponibles
La API reference répertorie toutes les opérations /api/v1
disponibles, par domaine.
L’API n’expose pas toutes les fonctions de la console. Par exemple, le téléchargement d’avatar et la création d’Improvement restent réservés à la console.