Entwickler-Tools
Verwenden Sie einen einzigen API-Schlüssel für die Ciele API, die CLI oder den MCP-Server.
Ciele stellt drei Schnittstellen für die programmatische Administration bereit. Jede Schnittstelle verwendet dieselben Operationen und Rollenprüfungen wie die Administrator-Konsole.
Um die Operation hinter einem Steuerelement der Konsole zu ermitteln, öffnen Sie auf der entsprechenden Seite das Developer Panel.
Um die Schnittstelle zu erkunden, öffnen Sie die öffentliche component library. Jede Seite behandelt eine Komponente sowie deren Zustände oder Varianten. Der Blocks section enthält vollständige Features wie Tabellen, Konversationen und Editoren. Beide Bereiche enthalten die Registerkarten Preview, Usage und Code. Sie können in jedem Abschnitt suchen und dessen Theme oder Palette ändern. Vorschauen verwenden Beispielinhalte. Die Registerkarte Code zeigt die Quelldateien des aktuellen Builds an.
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.
Gemeinsames Verbindungsmodell
Alle drei Schnittstellen erfordern einen Organization API Key. Die zugewiesene Role steuert die Operationen, die der Schlüssel verwenden kann.
Der gehostete Dienst verwendet standardmäßig https://ciele.app. Eine selbst
gehostete Installation verwendet ihren eigenen öffentlichen Ursprung.
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.
Verfügbare Domains
Die API-Referenz listet alle verfügbaren /api/v1-Operationen
nach Domäne auf.
Die API stellt nicht alle Funktionen der Konsole bereit. Beispielsweise sind das Hochladen von Avataren und das Erstellen von Verbesserungen weiterhin nur in der Konsole möglich.