Connecter des agents IA à vos sites de documentation
Laissez Claude Code, Codex, ChatGPT ou vos propres scripts rédiger, organiser et publier des pages de sites de documentation. Plans (Pro et supérieurs), autorisations des sites de documentation, portée des sites et règles de publication, avec des liens vers les guides complets sur les agents IA et l'API.
Les agents IA tels que Claude Code, Codex, Cursor, Claude ou ChatGPT peuvent lire et écrire sur vos sites de documentation pour vous : rédiger des articles, corriger des pages mal notées par les lecteurs, répondre aux lacunes de contenu, traduire ou publier. Cet article couvre ce qui est spécifique aux sites de documentation. Les jetons, les connecteurs, les dépenses et les erreurs sont expliqués dans Agents IA et API.
Avant de commencer
- Les agents IA et l'API sont disponibles sur les plans Pro, Entreprise et Personnalisé, incluant des connecteurs pour Claude et ChatGPT. Les plans Gratuit et Starter ne les incluent pas ; les jetons et les applications cessent de fonctionner si un espace de travail bascule vers l'un d'eux.
- Un agent agit en tant que personne ayant créé son jeton ou l'ayant connecté, dans le cadre du rôle de cette personne. Il ne peut jamais en faire plus sur un site que ce que cette personne pourrait faire.
- Les appels API ne coûtent aucun crédit. La traduction de pages et la génération de pages de site avec l'IA coûtent des crédits, et uniquement avec un jeton autorisé à les dépenser.
Connecter un agent
Ouvrez le menu de l'espace de travail et choisissez Agents IA et API, ou choisissez Agents IA et API dans le menu Paramètres d'un site de documentation (cela ouvre l'activité pour ce site).
- Jeton API pour Claude Code, Codex, Cursor ou un script : Jetons → Nouveau jeton, puis un assistant en quatre étapes (Objectif, Autorisations, Limites, Examiner). Choisissez un préréglage de site de documentation tel que Rédacteur ou Éditeur, choisissez les sites sous Limites → Sites de documentation, et copiez le jeton, qui n'est affiché qu'une seule fois. Voir Créer un jeton API.
- Connecteur pour Claude.ai ou ChatGPT : collez l'URL du connecteur depuis Applications connectées dans l'application, connectez-vous et choisissez les Sites Web et l'Accès. Voir Connecter des applications et agents IA.
Préréglages de site de documentation
| Préréglage | Description à l'écran | Pour |
|---|---|---|
| Rédacteur | "Les agents rédigent ; une personne examine et publie." | Rédiger des articles et des entrées de journal des modifications, télécharger des images |
| Éditeur | "Automatisation approuvée pouvant modifier ce que voient les lecteurs." | Tout pour les sites de documentation, y compris la publication, les paramètres et la création de sites |
| Assistant support | "Réponses à partir de documents publiés. Rien d'autre." | Un bot d'aide qui recherche uniquement dans les pages publiques publiées |
| Lecture seule | "Recherche, audits et vérifications de traduction." | Lecture de contenu |
| Analyste | "Lit le contenu et les signaux des lecteurs pour suggérer des correctifs." | Lecture de contenu et d'informations |
Producteur et Agent de l'espace de travail ajoutent des vidéos et des crédits de dépense. Chaque autorisation et qui peut l'accorder : Autorisations des agents.
Autorisations des sites de documentation
| Autorisation | Permet |
|---|---|
content:read |
Lire les sites, les pages, les articles (brouillons inclus), les révisions, le journal des modifications et les pages de site |
articles:write |
Créer des brouillons d'articles et modifier des articles qui ne sont pas en ligne |
structure:write |
Créer et modifier des sections ; déplacer, masquer et renommer des pages |
site-pages:write |
Modifier les pages de site telles que l'accueil, le contact et les mentions légales |
changelog:write |
Créer et modifier des entrées de journal des modifications en tant que brouillons |
media:write |
Télécharger des images |
site:publish |
Publier : modifier ce que voient les lecteurs, modifier le contenu en ligne, marquer les pages comme prêtes |
insights:read |
Lire les lacunes de recherche, les questions sans réponse et les retours sur les pages |
site:configure |
Modifier les paramètres du site, l'apparence et la navigation |
sites:create |
Créer de nouveaux sites de documentation |
help:read |
Rechercher uniquement dans les pages publiques publiées (pour un assistant support) |
La lecture est ouverte à tout membre. L'écriture et l'organisation : propriétaire, administrateurs, éditeurs et créateurs de contenu. La publication et les paramètres de site : propriétaire, administrateurs et éditeurs ("Seuls les propriétaires, administrateurs et éditeurs peuvent accorder la publication."). La création de sites : propriétaire et administrateurs.
Quels sites un jeton couvre
Sous Limites → Sites de documentation, choisissez Tous les sites ("Chaque site de documentation dans cet espace de travail, y compris les nouveaux.") ou Sites choisis. Un jeton ou une application connectée ne voit et ne modifie que les sites qu'il couvre. Si un article apparaît également sur un site en dehors de sa portée, la modification est refusée : "Cet article est également affiché sur un site que ce jeton ne peut pas modifier."
Le contenu en ligne nécessite des droits de publication
Sans site:publish, un agent ne peut pas modifier ce que voient les lecteurs. La modification d'un article en ligne est refusée ("Ce contenu est en ligne sur un site publié, sa modification nécessite donc la capacité site:publish"), et l'agent peut soumettre son brouillon pour examen à la place. Vous recevez une notification, "agent a demandé une révision de page sur site": "Rien n'a été publié. Lisez l'article et publiez-le lorsqu'il est prêt."
Chaque modification effectuée par un agent apparaît dans l'historique de la page sous la forme "Agent nom (jeton)". Les publications sont limitées à 10 par heure et par jeton. Un site en pause est en lecture seule pour les agents : "Ce site est en pause ou hors ligne et en lecture seule."
Ce que les agents peuvent faire sur un site
Lister les sites et lire l'arborescence des pages, rechercher et lire des pages, prévisualiser le Markdown, créer et mettre à jour des articles, les soumettre pour examen, organiser des sections et des pages, modifier les pages de site et le journal des modifications, télécharger des images, lire les informations et marquer les lacunes comme couvertes, modifier les paramètres, l'apparence, la navigation et les redirections, créer des sites, traduire des pages, générer des pages de site, publier et annuler des publications. Chaque action nécessite l'autorisation correspondante.