Integración · Automatizar y colaborar
GitBook + agentes de IA de Meteor
Conecta GitBook con un Met: revisa la estructura de tu documentación y propone cambios en un change request para que tu equipo los revise.
¿Cómo se conecta GitBook con Meteor?
Con el conector listo de GitBook, tu Met trabaja sobre la documentación o el centro de ayuda que tu empresa tiene en GitBook, con la cuenta que autoriza el admin. Lista los sitios de la organización, lee la estructura de páginas de uno y abre un change request para proponer un cambio sin tocar lo publicado; después lo envía a revisión o lo fusiona. Para llamar otras operaciones de la API de GitBook, como escribir el contenido del change request o traer el enlace de vista previa, usa una acción genérica que arranca apagada hasta que el admin la encienda. Es el servidor oficial de GitBook y el uso corre por tu plan de GitBook.
Qué automatiza
Lo que un agente de Meteor hace con GitBook
Ubicar dónde va una respuesta en tu centro de ayuda
Cuando tu equipo nota que una pregunta se repite por WhatsApp, el Met lista los sitios de GitBook, abre la estructura del centro de ayuda y te dice en qué sección encaja un artículo nuevo o qué página ya existe sobre ese tema.
Proponer un cambio sin tocar lo publicado
El Met abre un change request en el espacio que corresponde, así el cambio queda como borrador revisable en GitBook. Lo publicado no cambia hasta que alguien fusiona ese change request.
Escribir el borrador y conseguir la vista previa
Si el admin enciende la acción genérica, el Met llama las operaciones de la API de GitBook que escriben el contenido en el change request y traen los datos del sitio para armar el enlace de vista previa del cambio, que GitBook no entrega en una sola llamada.
Mandar el cambio a revisión
Con el borrador listo, el Met envía el change request a revisión para que la persona responsable lo apruebe en GitBook. La misma acción puede fusionarlo, y fusionar publica el cambio en el espacio.
5 herramientas
Todo lo que el agente puede pedirle a GitBook
Cada una es una acción real del conector. Puedes desactivar las que no quieras que use.
| Herramienta | Qué hace |
|---|---|
list_sites | Lista los sitios de documentación de la organización de GitBook conectada. |
get_site_structure | Trae la estructura actual de un sitio de documentación de la organización. |
create_change_request | Abre un change request en un espacio para redactar cambios sin editar lo publicado. |
submit_or_merge_change_request | Envía un change request a revisión o lo fusiona, lo que publica sus cambios en el espacio. |
invoke_operation | Llama una operación de la API de GitBook por su nombre, como getSpaceById. Viene apagada hasta que el admin la encienda. |
Los límites
Qué NO hace la integración con GitBook
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No te pide confirmación en el chat antes de escribir en GitBook. El admin elige en Conexiones qué acciones quedan encendidas; la acción genérica de la API arranca apagada.
-
No configura Git Sync. Según GitBook, conectar GitHub o GitLab, elegir el repositorio y la rama es un paso que solo se hace en la aplicación, con cualquier forma de conexión.
-
No es el MCP de la documentación publicada. Ese otro servidor de GitBook es de solo lectura para tus lectores; este trabaja sobre tu organización con la cuenta que autoriza el admin.
-
No entrega el enlace de vista previa de un change request en una sola llamada. Hay que armarlo con los datos del sitio, y para eso el Met necesita la acción genérica encendida.
-
No ve más que la cuenta que autorizó la conexión. Sitios, espacios u organizaciones a los que esa cuenta no tiene acceso quedan fuera.
Antes de empezar
Qué necesitas para conectar GitBook
- 1
Una cuenta de GitBook con acceso a la documentación que el Met va a usar
Conecta con una cuenta de tu organización de GitBook que vea los sitios y espacios del centro de ayuda, porque el conector trabaja con los permisos de esa cuenta.
- 2
Conectarla en Met
En Met, abre Conexiones → GitBook → Conectar. Se abre una ventana de GitBook para que inicies sesión y autorices a Met. Después eliges qué acciones quedan encendidas.
Preguntas frecuentes
Preguntas sobre GitBook y Meteor
Propone cambios en un change request, que no toca lo publicado. Fusionarlo sí publica el cambio: si no quieres que el Met lo haga, el admin apaga esa acción en Conexiones y la fusión la hace tu equipo en GitBook.
Llama operaciones de la API de GitBook por su nombre: escribir el contenido de un change request, leer un espacio o traer los datos de un sitio. Como abre la puerta a la API de GitBook, arranca apagada.
Sí para leer la estructura y proponer cambios pequeños en un change request. GitBook recomienda que los cambios grandes de un espacio sincronizado pasen por el repositorio, y Git Sync no se configura desde el conector.
Tú, con tu propio plan de GitBook. Meteor no revende GitBook: el conector usa la cuenta de tu empresa y respeta lo que tu plan permite.
Paso a paso
Automatizaciones que usan GitBook
Tareas completas, con los pasos y las herramientas que se ejecutan en cada uno.
Automatizar y colaborar
Otras integraciones de la misma familia
¿Quieres ver a un agente operando GitBook?
Te lo mostramos con tu propia cuenta conectada, no con una demostración enlatada.