---
title: "Automatisierung"
description: "Führen Sie die CLI in CI mit einem API-Schlüssel aus und lassen Sie einen Agent sie sicher steuern."
canonical: "https://atelier201.com/docs/de/cli/automation"
updated: "2026-11-06"
---

# Automatisierung

## In CI

Verwenden Sie einen API-Schlüssel statt einer OAuth-Anmeldung: Der Schlüssel gehört
zum Workspace und läuft nicht ab, wenn jemand das Unternehmen verlässt.

```bash
export ATELIER201_API_KEY="atelier201_live_..."
atelier201 site push --build --wait
```

Legen Sie nur die erforderlichen Berechtigungen fest. Ein Job, der Builds erstellt
und Vorschauen bereitstellt, benötigt `sites:write`. Lassen Sie `sites:publish` weg,
damit der Job nicht ändern kann, was Besucher sehen. So kann ein offengelegtes
Protokoll nichts online stellen.

In einem Skript benötigt `publish` die Option `--yes`, und `sites delete` benötigt
`--confirm <slug>`. Ohne diese Optionen wird der Befehl mit Exit-Code `2` beendet,
nimmt keine Änderungen vor und gibt den genauen Befehl zum erneuten Ausführen aus.

## Mit einem Agent

```bash
atelier201 help --json
```

`help --json` gibt den vollständigen Befehlsbaum, die Exit-Codes, die Richtlinie für
Wiederholungsversuche und den Fehlerumschlag als maschinenlesbares Dokument aus.
Liest ein Agent die Ausgabe zuerst, muss er nicht mehr über Optionen spekulieren.

Verwenden Sie `atelier201 help files read --json`, um nur einen Befehl zu prüfen,
oder `atelier201 help --operation readSiteFile --json`, um die vollständigen
REST-Schemas und die CLI/MCP-Zuordnung anzuzeigen. Die Ermittlung funktioniert
offline und ohne Zugangsdaten. Der integrierte Vertrag beschreibt die installierte
CLI-Version; OpenAPI und die MCP-Ressource beschreiben die bereitgestellte API.
Siehe [Abdeckung der Operationen](/docs/api/surfaces).

> **Warning: Veröffentlichung dem Inhaber überlassen**
>
> Ein Agent sollte einen Entwurf erstellen, eine Vorschau teilen und nachfragen.
> Geben Sie ihm `sites:write`, aber nicht `sites:publish`. So kann er die ganze
> Arbeit erledigen, während der Inhaber entscheidet, wann die Website live geht.

## Wiederholungsversuche

Die CLI wiederholt jeden Befehl bei `429`. Bei Lesevorgängen (`GET`, `HEAD` und
`OPTIONS`) wiederholt sie auch bei `408` und `5xx`. Schlägt ein Schreibvorgang mit
`5xx` fehl, wird der Fehler gemeldet, aber der Vorgang nicht wiederholt, da er
möglicherweise bereits ausgeführt wurde. Lesen Sie die Website erneut aus, bevor Sie
es selbst noch einmal versuchen. Ein `Idempotency-Key`-Header aktiviert keine
automatischen Wiederholungsversuche für Schreibvorgänge. Überschreitet
`Retry-After` 60 Sekunden, gibt die CLI den Fehler samt Angaben zur Behebung zurück,
anstatt vorzeitig erneut zu versuchen oder unbegrenzt zu warten. Netzwerkfehler und
Zeitüberschreitungen führen nicht zu Wiederholungsversuchen. Deaktivieren Sie diese
mit `--no-retry`.