Saltar al contenido

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.

Antes de empezar

Qué necesitas para conectar GitBook

  1. 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. 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.

Ver todas las automatizaciones

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.