Strumenti per sviluppatori
Usa un'unica API key con l'API di Ciele, la CLI o il server MCP.
Ciele offre tre interfacce per l'amministrazione programmatica. Ogni interfaccia utilizza le stesse operazioni e gli stessi controlli dei ruoli della console di amministrazione.
Per scoprire l'operazione che si cela dietro un controllo della console, apri il Developer Panel su quella pagina.
Per esplorare l'interfaccia, apri la component library pubblica. Ogni pagina tratta un componente e i suoi stati o varianti. La Blocks section contiene funzionalità complete, come tabelle, conversazioni ed editor. Entrambe le sezioni includono le schede Preview, Usage e Code. Puoi effettuare ricerche in ogni sezione e modificarne il tema o la tavolozza. Le anteprime utilizzano contenuti di esempio. La scheda Code mostra i file sorgente della build corrente.
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.
Modello di connessione comune
Tutte e tre le interfacce richiedono una chiave API dell'organizzazione. Il Role assegnato controlla le operazioni che la chiave può utilizzare.
Il servizio ospitato utilizza https://ciele.app per impostazione predefinita.
Un'installazione self-hosted utilizza il proprio public origin.
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.
Domini disponibili
La API reference elenca tutte le operazioni /api/v1
disponibili per dominio.
L'API non espone tutte le funzioni della console. Ad esempio, il caricamento dell'avatar e la creazione di Improvement rimangono disponibili solo nella console.