Caldera-Dokumentation
Caldera zeigt einem Workspace, was seine autonomen Agents tun, und lässt Admins sie steuern. Ein Agent ist jedes Programm, das selbstständig arbeitet, zum Beispiel eines, das ein Aufgaben-Board liest, Karten mit Claude Code bearbeitet und das Ergebnis zurückschreibt. Caldera zeigt je Agent Zustand, Gesundheit, Kontingent-Anzeigen, Läufe mit Kosten und Panels, die der Agent selbst deklariert. Admins können pausieren, fortsetzen, einen Lauf jetzt anfordern, eine Einstellung innerhalb der eigenen Grenzen des Agents ändern und ein Log anfordern.
Zuerst lesen
Ein Agent hängt nie von Caldera ab. Caldera liegt nicht im Steuerpfad eines Agents. Ist Caldera nicht erreichbar, langsam oder antwortet unsinnig, arbeitet jeder Agent weiter. Jede Pause lässt sich weiterhin auf dem Rechner des Agents setzen und aufheben. Es fehlt nur die Anzeige. Alles auf diesen Seiten folgt aus dieser Regel. Siehe Konzepte und Begriffe.
Caldera verbindet sich nie mit einem Agent. Der Agent ruft nach außen, über HTTPS, in festem Abstand. Befehle kommen in der Antwort auf eine Meldung zurück. Auf dem Rechner des Agents lauscht nichts.
Diese Dokumentation richtet sich an Personen, die Agents mit Caldera verbinden
und betreiben. Die App liegt unter https://app.calderaapp.io. Ein Workspace
muss für Caldera freigeschaltet sein, bevor seine Agents melden können. Ohne
Freischaltung antwortet Caldera mit 403.
Wo anfangen
| Ziel | Lesen |
|---|---|
| Die Teile und Begriffe verstehen | Konzepte und Begriffe |
| Einen Agent mit Caldera verbinden und einen der zwei Wege wählen | Einen Agent verbinden |
| Einen eigenen Reporter schreiben | Das Agent-Protokoll |
| Einen Agent unter der Runtime betreiben | Die Runtime caldera.pyz |
| Einen Agent so verpacken, dass ein Befehl ihn einrichtet | Blueprints und Das Manifest |
| Einen Agent anbinden, der eigene Prozesse behält | Adapter-Modus und sein Vertrag |
| Aktualisieren, festhalten, zurückrollen, pausieren, Token erneuern oder ein Problem beheben | Agents betreiben |
| Wissen, was die Zeile zum Claude-Konto auf der Seite eines Agents bedeutet | Der Hinweis auf das Claude-Konto |
Die zwei Wege, einen Agent zu verbinden
- Ein eigener Reporter. Wenige Zeilen in einer beliebigen Sprache, die den Zustand des Agents per POST an Caldera senden. Der Agent läuft genau wie vorher.
- Ein Blueprint unter der Runtime. Ein vorbereitetes, versioniertes Paket, das
ein Befehl,
caldera init, auf einem Rechner einrichtet. Die Runtimecaldera.pyzführt den Agent dann aus, meldet für ihn, spielt Updates mit einer Gesundheitsprüfung ein und rollt von selbst zurück, wenn eine neue Version schlechter ist.
Ein dritter Modus, der Adapter, ist die Runtime für einen Agent, der eigene Prozesse behält: Die Runtime startet und stoppt nichts und ruft einen Befehl auf, den der Agent bereitstellt.
Maschinenlesbare Schemas
Die JSON-Schemas für das Manifest und die Adapter-Antworten liegen neben den Seiten:
caldera.agent.schema.json, das Manifestadapter-status.schema.jsonadapter-settings-get.schema.jsonadapter-log-list.schema.jsonadapter-answer.schema.json
Caldera hat keine öffentliche REST-API für Skripte: Die Routen, die die App benutzt, brauchen eine angemeldete Sitzung. Das Agent-Protokoll ist die API, die ein Agent spricht.