Herramientas para desarrolladores
Usa una única clave de API con la API de Ciele, la CLI o el servidor MCP.
Ciele ofrece tres interfaces para la administración programática. Cada interfaz utiliza las mismas operaciones y comprobaciones de roles que la consola de administración.
Para encontrar la operación que hay detrás de un control de la consola, abre el Developer Panel en esa página.
Para explorar la interfaz, abre la biblioteca de componentes pública. Cada página trata de un componente y de sus estados o variantes. La Blocks section contiene funcionalidades completas, como tablas, conversaciones y editores. Ambas secciones incluyen las pestañas Preview, Usage y Code. Puedes buscar en cada sección y cambiar su tema o paleta. Las vistas previas utilizan contenido de ejemplo. La pestaña Code muestra los archivos fuente de la compilación actual.
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.
Modelo de conexión común
Las tres interfaces requieren una clave de API de organización. El Role asignado controla las operaciones que la clave puede utilizar.
El servicio alojado utiliza https://ciele.app de forma predeterminada. Una
instalación autoalojada utiliza su propio origen público.
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.
Dominios disponibles
La API reference enumera todas las operaciones de /api/v1
disponibles por dominio.
La API no expone todas las funciones de la consola. Por ejemplo, la subida de avatares y la creación de mejoras siguen siendo exclusivas de la consola.