Verwenden Sie maschinenlesbare Ausgaben und die Funktionserkennung, anstatt in Skripten oder Agenten-Workflows für Menschen bestimmte Hilfetexte auszuwerten.
Aktuellen Funktionsumfang ermitteln
Die Antwort beschreibt unterstützte Befehle, Authentifizierung, Browsermodi, Ausgabeschemas, Lebenszyklusereignisse und empfohlene Rezepte für Agenten.
Agenten sollten den Vertrag zu Beginn eines Workflows prüfen, anstatt Annahmen über Flags oder JSON-Felder fest zu codieren.
In CI authentifizieren
Die Priorität der Anmeldedaten lautet: Zugriffstoken, API-Schlüssel und anschließend die mit octoparse auth login gespeicherten Anmeldedaten.
Drucken Sie Anmeldedaten nicht aus und nehmen Sie sie weder in Commits noch in geteilte Protokolle, Screenshots oder generierte Dokumentation auf.
Ausgabemodus auswählen
--json gibt einen einzelnen Ergebnis-Umschlag zurück.--jsonl streamt Ereignisse eines im Vordergrund ausgeführten Laufs als JSON Lines.- Die lesbare Ausgabe ist für die interaktive Verwendung im Terminal bestimmt.
Unter Ausgabe und Exit-Codes finden Sie Schemas, Lebenszyklusereignisse, das Verhalten von stdout/stderr und Fehlercodes.
Aufgaben mit einem Agenten erstellen
Agenten sollten detect --agent oder den Workflow „Vorbereiten/Vorschau/Anwenden“ verwenden, nicht --auto.
Folgen Sie machineContract.recipes.createTaskFromUrlWithAgent aus der Antwort des capabilities-Befehls. Übergeben Sie an --agent-command nur eine vertrauenswürdige ausführbare Datei.
Zustandsändernde Befehle bestätigen
Befehle, die Zeitpläne umbenennen, verschieben, löschen, aktualisieren oder ändern, erfordern möglicherweise --yes. Ermitteln Sie die Bestätigungsanforderungen mit capabilities --json, bevor Sie eine Automatisierung erstellen.
Interne Befehle
env wechselt zwischen internen API-Umgebungen und runs untersucht interne lokale Artefakte. Sie gehören nicht zum primären Benutzer-Workflow. Bevorzugen Sie öffentliche Befehle mit Aufgaben- und Lauf-IDs, sofern der Octoparse-Support Sie nicht anders anweist. 