WebCull - Documentation - Sortie Et Limites

Sortie

Garder Les Reponses CLI Limitees Et Lisibles

Utilisez des limites claires sur les commandes de type liste. Cela garde la sortie du terminal lisible sur les grands comptes et donne aux outils d'agent des résultats assez petits pour être examinés soigneusement.

Limites d'utilisation

Vérifier l'utilisation actuelle de la CLI

Exécutez webcull limits pour voir l'utilisation actuelle des lectures et des écritures du compte sélectionné avant de lancer de nombreuses commandes.

webcull limits --account <account-hash>

Commandes

Utiliser Les Memes Controles Dans Les Commandes De Lecture

--account <hash|id>

Sélectionne le compte WebCull autorisé localement qui fournit le token pour cette commande. Les agents doivent utiliser le hash du compte.

--limit <n>

Nombre maximal de lignes ou de nœuds renvoyés.

--page <n>

Numéro de page pour les commandes prenant en charge la pagination.

--fields <list>

Champs séparés par des virgules, comme id,title,url,parent_id,modified.

--max-chars <n>

Taille maximale de réponse.

--max-metadata-chars <n>

Longueur maximale du texte pour les grands champs de détail de favori.

--format json|jsonl

Le JSON mis en forme est utilisé par défaut. JSONL affiche un élément par ligne lorsqu'une réponse contient une liste d'éléments.

Exemples

Commencer Avec De Petites Charges Utiles

webcull bookmarks tree --account <account-hash> --path / --max-depth 1 --limit 25 --max-chars 8000 --fields id,type,title,modified
webcull graph around --account <account-hash> --stack-id 2301 --depth 1 --limit 50 --max-chars 12000
webcull bookmarks get --account <account-hash> --ids 2302 --fields id,title,url,notes --max-metadata-chars 1200

Quand une réponse est trop large, réduisez d'abord les champs, puis les champs de texte long, puis les limites de lignes. Augmentez une limite à la fois.

Conseils pour les nouvelles tentatives

Respecter les réponses structurées de nouvelle tentative

La CLI conserve les codes de réponse permettant une nouvelle tentative afin que les personnes, les scripts et les agents puissent réagir sans faire de suppositions. request_busy signifie qu'une autre requête est toujours en cours pour le même compte. request_lock_unavailable signifie que la coordination des requêtes n'a pas pu être vérifiée. Attendez le délai indiqué avant de réessayer.

{
  "success": "false",
  "code": "request_busy",
  "retry_after_ms": 1000
}

Une réponse throttled contient retry_after_seconds. Attendez au moins ce délai, puis réduisez les limites, la taille de la sortie ou l'étendue de la requête avant de continuer. La CLI ne relance pas automatiquement les écritures.