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 individuare l'operazione associata a un controllo della console, apri il Developer Panel su quella pagina.
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).
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 un Improvement rimangono disponibili solo nella console.