> ## 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.

# Automatiser Octoparse CLI

> Utilisez Octoparse CLI dans les pipelines CI, scripts et agents d’IA grâce à la détection des capacités, aux sorties JSON et aux codes de sortie.

Dans les scripts et les flux de travail d’agents, utilisez une sortie lisible par machine et la détection des capacités au lieu d’analyser l’aide destinée aux utilisateurs.

## Découvrir le contrat actuel

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

La réponse décrit les commandes prises en charge, l’authentification, les modes du navigateur, les schémas de sortie, les événements du cycle de vie et les procédures recommandées pour les agents.

Les agents doivent examiner ce contrat au début d’un flux de travail plutôt que de coder en dur des hypothèses sur les options ou les champs JSON.

## S’authentifier dans un pipeline CI

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

L’ordre de priorité des identifiants est le suivant : jeton d’accès, clé API, puis identifiants enregistrés avec `octoparse auth login`.

<Warning>
  N’affichez pas les identifiants et ne les incluez jamais dans un commit, des journaux partagés, des captures d’écran ou de la documentation générée.
</Warning>

## Choisir un mode de sortie

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

* `--json` renvoie une seule enveloppe de résultat.
* `--jsonl` diffuse les événements d’une exécution au premier plan au format JSON Lines.
* La sortie destinée aux utilisateurs convient à une utilisation interactive dans le terminal.

Consultez [Sortie et codes de sortie](../reference/output-and-exit-codes) pour connaître les schémas, les événements du cycle de vie, le comportement de stdout/stderr et les codes d’échec.

## Créer des tâches avec un agent

Les agents doivent utiliser `detect --agent` ou le flux de travail de préparation, d’aperçu et d’application, et 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
```

Suivez `machineContract.recipes.createTaskFromUrlWithAgent` dans la réponse des capacités. Transmettez uniquement un exécutable fiable à `--agent-command`.

## Confirmer les commandes qui modifient l’état

Les commandes qui renomment, déplacent, suppriment ou mettent à jour des éléments, ou qui modifient des planifications, peuvent nécessiter `--yes`. Utilisez `capabilities --json` pour connaître les exigences de confirmation avant de créer une automatisation.

## Commandes internes

`env` change d’environnement d’API interne et `runs` inspecte les artefacts locaux internes. Ces commandes ne font pas partie du flux de travail principal. Privilégiez les commandes publiques reposant sur les identifiants de tâche et de lot, sauf indication contraire de l’assistance Octoparse.