---
title: "Automazione"
description: "Esegui la CLI nella CI con una chiave API e consenti a un agente di usarla in sicurezza."
canonical: "https://atelier201.com/docs/it/cli/automation"
updated: "2026-11-06"
---

# Automazione

## Nella CI

Usa una chiave API, non un accesso OAuth: la chiave appartiene all'area di lavoro e non scade quando una persona se ne va.

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

Imposta gli ambiti più limitati necessari per il job. Un job che crea un build e un'anteprima ha bisogno di `sites:write`. Escludi `sites:publish` e il job non potrà modificare ciò che vedono i visitatori, così un log divulgato non potrà mettere nulla online.

In uno script, `publish` richiede `--yes` e `sites delete` richiede `--confirm <slug>`.
Senza questi parametri, il comando termina con `2`, non modifica nulla e stampa il comando esatto da rieseguire.

## Con un agente

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

`help --json` stampa in un unico documento leggibile dalle macchine l'intero albero dei comandi, i codici di uscita, i criteri per riprovare e la struttura degli errori. Se lo legge prima, l'agente evita di procedere a tentativi con i flag.

Usa `atelier201 help files read --json` per consultare un singolo comando oppure
`atelier201 help --operation readSiteFile --json` per vedere gli schemi REST completi e la corrispondenza CLI/MCP. La consultazione funziona anche offline, senza credenziali. Il contratto incluso descrive la versione installata della CLI; le risorse OpenAPI e MCP in tempo reale descrivono l'API distribuita. Consulta [la copertura delle operazioni](/docs/api/surfaces).

> **Warning: Lasciare la pubblicazione al proprietario**
>
> Un agente dovrebbe creare il build di una bozza, condividere un'anteprima e chiedere conferma. Dagli `sites:write`, ma non `sites:publish`. Potrà così svolgere tutto il lavoro, mentre spetterà al proprietario decidere quando mettere online il sito.

## Nuovi tentativi

La CLI riprova con `429` per tutti i comandi. Riprova con `408` e `5xx` solo per le letture
(`GET`, `HEAD` e `OPTIONS`). Se una scrittura restituisce `5xx`, la CLI segnala l'errore senza ripetere l'operazione, perché potrebbe essere già stata applicata: prima di riprovare, leggi di nuovo il sito. Un'intestazione `Idempotency-Key` non abilita i nuovi tentativi automatici per le scritture. Se `Retry-After` supera 60 secondi, la CLI restituisce l'errore con le istruzioni per risolverlo, senza riprovare in anticipo né attendere a tempo indeterminato. Gli errori di rete e i timeout non vengono ritentati. Disattiva i nuovi tentativi con `--no-retry`.