Conecta agentes de IA a tus sitios de documentación
Deja que Claude Code, Codex, ChatGPT o tus propios scripts redacten, organicen y publiquen páginas en tus sitios de documentación. Planes (Pro en adelante), permisos de sitios de documentación, alcance de sitios y reglas de publicación, con enlaces a las guías completas de agentes de IA y API.
Los agentes de IA como Claude Code, Codex, Cursor, Claude o ChatGPT pueden leer y escribir en tus sitios de documentación por ti: redactar artículos, corregir páginas con baja calificación de los lectores, responder a vacíos de contenido, traducir o publicar. Este artículo cubre lo específico para los sitios de documentación. Los tokens, conectores, gastos y errores se explican en Agentes de IA y API.
Antes de empezar
- Agentes de IA y API está disponible en los planes Pro, Negocios y Personalizado, incluyendo conectores para Claude y ChatGPT. Los planes Gratuito y Starter no lo incluyen; los tokens y aplicaciones dejarán de funcionar si un espacio de trabajo se cambia a uno de ellos.
- Un agente actúa como la persona que creó su token o lo conectó, dentro del rol de esa persona. Nunca puede hacer más en un sitio de lo que ella podría.
- Las llamadas a la API no tienen costo en créditos. Traducir páginas y generar páginas de sitio con IA sí cuesta créditos, y solo con un token que pueda gastarlos.
Conectar un agente
Abre el menú del espacio de trabajo y elige Agentes de IA y API, o elige Agentes de IA y API en el menú de Ajustes de un sitio de documentación (abre la actividad para ese sitio).
- Token de API para Claude Code, Codex, Cursor o un script: Tokens → Nuevo token, luego un asistente de cuatro pasos (Propósito, Permisos, Límites, Revisar). Elige un ajuste preestablecido de sitio de documentación como Escritor o Publicador, selecciona los sitios en Límites → Sitios de documentación, y copia el token, que se muestra una sola vez. Consulta Crear un token de API.
- Conector para Claude.ai o ChatGPT: pega la URL del conector desde Aplicaciones conectadas en la aplicación, inicia sesión y elige los Sitios y el Acceso. Consulta Conectar aplicaciones y agentes de IA.
Ajustes preestablecidos de sitios de documentación
| Ajuste preestablecido | Descripción en pantalla | Para |
|---|---|---|
| Escritor | "Los agentes redactan; una persona revisa y publica." | Redactar artículos y entradas de registro de cambios, subir imágenes |
| Publicador | "Automatización confiable que puede cambiar lo que ven los lectores." | Todo para sitios de documentación, incluyendo publicar, ajustes y crear sitios |
| Asistente de soporte | "Respuestas de documentos publicados. Nada más." | Un bot de ayuda que busca solo en páginas públicas publicadas |
| Solo lectura | "Investigación, auditorías y comprobaciones de traducción." | Leer contenido |
| Analista | "Lee contenido y señales de los lectores para sugerir correcciones." | Leer contenido y perspectivas |
Productor y Agente del espacio de trabajo añaden videos y créditos de gasto. Cada permiso y quién puede otorgarlo: Permisos de agente.
Permisos de sitios de documentación
| Permiso | Permite |
|---|---|
content:read |
Leer sitios, páginas, artículos (también borradores), revisiones, el registro de cambios y páginas de sitio |
articles:write |
Crear borradores de artículos y editar artículos que no están publicados |
structure:write |
Crear y editar secciones; mover, ocultar y renombrar páginas |
site-pages:write |
Editar páginas de sitio como inicio, contacto y legal |
changelog:write |
Crear y editar entradas de registro de cambios como borradores |
media:write |
Subir imágenes |
site:publish |
Publicar: cambiar lo que ven los lectores, editar contenido en vivo, marcar páginas como listas |
insights:read |
Leer vacíos de búsqueda, preguntas sin respuesta y comentarios de página |
site:configure |
Cambiar ajustes del sitio, apariencia y navegación |
sites:create |
Crear nuevos sitios de documentación |
help:read |
Buscar solo en páginas públicas publicadas (para un asistente de soporte) |
La lectura está abierta a cualquier miembro. Escribir y organizar: propietario, administradores, editores y Creadores de contenido. Publicar y ajustes del sitio: propietario, administradores y editores ("Solo los propietarios, administradores y editores pueden otorgar permisos de publicación"). Crear sitios: propietario y administradores.
Qué sitios cubre un token
En Límites → Sitios de documentación, elige Todos los sitios ("Cada sitio de documentación en este espacio de trabajo, incluyendo los nuevos") o Sitios elegidos. Un token o aplicación conectada solo ve y cambia los sitios que cubre. Si un artículo también aparece en un sitio fuera de su alcance, el cambio es rechazado: "Este artículo también se muestra en un sitio que este token no puede cambiar".
El contenido en vivo necesita derechos de publicación
Sin site:publish, un agente no puede cambiar lo que ven los lectores. Editar un artículo que está en vivo es rechazado ("Este contenido está en vivo en un sitio publicado, por lo que cambiarlo requiere la capacidad site:publish"), y el agente puede enviar su borrador para revisión en su lugar. Recibes una notificación, "agente solicitó revisión de página en sitio": "No se publicó nada. Lee el artículo y publícalo cuando esté listo".
Cada cambio que hace un agente se muestra en el historial de la página como "Agente nombre (token)". Las publicaciones están limitadas a 10 por hora por token. Un sitio pausado es de solo lectura para los agentes: "Este sitio está pausado o fuera de línea y es de solo lectura".
Qué pueden hacer los agentes en un sitio
Listar sitios y leer el árbol de páginas, buscar y leer páginas, previsualizar Markdown, crear y actualizar artículos, enviarlos para revisión, organizar secciones y páginas, editar páginas de sitio y el registro de cambios, subir imágenes, leer perspectivas y marcar vacíos como cubiertos, cambiar ajustes, apariencia, navegación y redirecciones, crear sitios, traducir páginas, generar páginas de sitio, publicar y revertir cambios. Cada uno necesita el permiso correspondiente.