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
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
L’ordre de priorité des identifiants est le suivant : jeton d’accès, clé API, puis identifiants enregistrés avec octoparse auth login.
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.
Choisir un mode de sortie
--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 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.
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. 