1. Vérifier le CLI et la compétence de l’agent
Avant d’écrire, vérifiez les deux maillons : le binaire doit être disponible et la compétence installée doit réussir son diagnostic. Avoir seulement ow dans le PATH ne garantit pas que l’agent connaît le workflow courant.
command -v ow
ow agent doctor --target auto2. Construire un document typé
Initialisez un espace de travail, ajoutez les sections et nœuds de présentation nécessaires, puis faites la chaîne de validation locale. Le paquet généré est un résultat de build : on ne le retouche pas à la main.
ow a2ui draft init ./artifact --title "Launch plan" --description "Decision-ready launch plan" --language en
ow a2ui draft check ./artifact
ow a2ui draft build ./artifact
ow a2ui digest ./artifact/document.mdw3. Publier le paquet validé
Ne publiez qu’après un check, un build et un digest réussis. Hosted refait sa propre validation du paquet : c’est une seconde barrière, pas une formalité décorative.
ow publish ./artifact/document.mdw --no-openMarkdown brut, HTML brut, répertoires, stdin, Bundle JSON et JSON-LD ne sont pas des entrées de publication Hosted.
4. Conserver les identifiants renvoyés
- Partagez l’URL de lecture avec les lecteurs.
- Gardez le document ID pour les mises à jour et la récupération.
- Traitez les liens de review ou d’édition comme des secrets, jamais comme des liens publics.
- Ouvrez le rendu publié dans un vrai navigateur avant toute remise.
FAQ
Questions fréquentes
Puis-je publier directement un fichier Markdown ?
Non. Hosted attend un paquet .mdw créé et vérifié avec ow a2ui draft ; le Markdown brut n’est pas une entrée de publication.
Faut-il un compte pour préparer le document localement ?
Non. La construction, les contrôles et le digest sont locaux. Le compte et le credential Hosted ne sont nécessaires qu’au moment de publier.
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.