Le CLI ou la compétence d’agent manque
Si le CLI est absent, installez-le avant de toucher au contenu. Si le diagnostic de compétence échoue, corrigez la cible signalée : supposer que la publication est configurée ne règle pas un environnement incomplet.
command -v ow
ow agent doctor --target autoLes credentials Hosted manquent
Relancez setup lorsqu’une publication Hosted signale un problème d’identifiant, ou lorsque vous devez délibérément vous reconnecter. La construction locale d’un brouillon ne dépend pas de cette connexion.
ow setup --target autoLe paquet ne passe pas la validation
Corrigez la commande de brouillon qui a produit le contenu invalide. N’éditez ni le JSON généré ni le binaire .mdw pour passer outre, et ne jetez pas l’espace de travail parce qu’une commande idempotente mentionne un conflit.
ow a2ui draft status ./artifact
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdwL’entrée n’est pas prise en charge
Hosted n’accepte pas Markdown brut, HTML brut, répertoires, stdin, Bundle JSON hérité ni JSON-LD. Construisez d’abord un .mdw typé. Pour héberger un HTML existant sans le modifier, utilisez un hébergeur statique ou d’artefacts HTML.
La revue a expiré
Un timeout signifie qu’aucune décision finale n’est arrivée ; ce n’est jamais un accord. Conservez la révision formelle actuelle, signalez le délai, puis attendez ou publiez un candidat corrigé seulement si le workflow le demande.
FAQ
Questions fréquentes
Que lancer avant de retenter une publication échouée ?
Commencez par ow agent doctor, puis exécutez draft status, check, build et digest. Ne retentez que la frontière précise qui échoue.
Faut-il supprimer l’espace de brouillon après un conflit ?
Non. Un conflit peut signaler une idempotence. Inspectez draft status et gardez l’espace sauf si une commande indique explicitement qu’une suppression est nécessaire.
Utiliser le vrai workflow
Publiez ce que votre Agent crée.
Donnez à chaque rapport, document ou plan une page pensée pour ses lecteurs, d’où reviennent commentaires, décisions et révisions formelles.