> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatizza la CLI di Octoparse

> Usa la CLI di Octoparse in CI, script e agenti AI con rilevamento delle funzionalità, output JSON, credenziali di ambiente e codici di uscita.

Usa output leggibili dalle macchine e il rilevamento delle funzionalità invece di analizzare l'aiuto destinato alle persone negli script o nei flussi di lavoro degli agenti.

## Individua il contratto corrente

```bash theme={null}
octoparse capabilities --json
```

La risposta descrive i comandi supportati, l'autenticazione, le modalità browser, gli schemi di output, gli eventi del ciclo di vita e le procedure consigliate per gli agenti.

Gli agenti devono esaminare il contratto all'inizio di un flusso di lavoro anziché codificare presupposti sui flag o sui campi JSON.

## Autenticazione in CI

```bash theme={null}
OCTO_ENGINE_API_KEY=xxx octoparse task list --json
OCTO_ENGINE_ACCESS_TOKEN=xxx octoparse task list --json
```

La priorità delle credenziali è: token di accesso, chiave API e infine credenziali memorizzate da `octoparse auth login`.

<Warning>
  Non stampare, sottoporre a commit o includere le credenziali in log condivisi, screenshot o documentazione generata.
</Warning>

## Scegli una modalità di output

```bash theme={null}
octoparse task list --json
octoparse run <taskId> --json
octoparse run <taskId> --jsonl
```

* `--json` restituisce un singolo contenitore di risultati.
* `--jsonl` trasmette gli eventi delle esecuzioni in primo piano come JSON Lines.
* L'output leggibile dalle persone è destinato all'uso interattivo nel terminale.

Consulta [Output e codici di uscita](../reference/output-and-exit-codes) per schemi, eventi del ciclo di vita, comportamento di stdout/stderr e codici di errore.

## Crea attività con un agente

Gli agenti devono usare `detect --agent` o il flusso prepara / anteprima / applica, non `--auto`.

```bash theme={null}
octoparse detect <url> \
  --agent \
  --agent-command "path/to/trusted-agent" \
  --goal "Extract product titles and prices" \
  --run-sample 5 \
  --json
```

Segui `machineContract.recipes.createTaskFromUrlWithAgent` nella risposta delle funzionalità. Passa a `--agent-command` solo un eseguibile attendibile.

## Conferma i comandi che modificano lo stato

I comandi che rinominano, spostano, eliminano, aggiornano o cambiano le pianificazioni possono richiedere `--yes`. Usa `capabilities --json` per rilevare i requisiti di conferma prima di costruire l'automazione.

## Comandi interni

`env` cambia gli ambienti API interni e `runs` esamina gli elementi locali interni. Non fanno parte del flusso di lavoro principale dell'utente. Preferisci i comandi pubblici basati su ID attività e ID lotto, a meno che l'assistenza Octoparse non fornisca indicazioni diverse.