Made in DeveloperHub
Adjunta tu código fuente a un proyecto y AI Agent podrá comprobar lo que afirma tu documentación frente a lo que hace realmente tu código. También puede vigilar tus pull requests y redactar los cambios de documentación que implica cada una.
El agente solo lee tu código. Nunca escribe en un repositorio, ni hace commits, ni abre pull requests.
Este vídeo muestra todo el proceso: la configuración, el agente que se inicia al abrirse una pull request, los cambios que prepara, cómo pedirle una publicación de registro de cambios y, por último, cómo guardar y publicar el resultado.
Antes de empezar
Conecta GitHub. Abre Configuración del proyecto → Developers → Integrations y conecta GitHub; después, concede a la aplicación de GitHub de DeveloperHub acceso a los repositorios que quieras adjuntar. No es necesario que uses GitHub Sync para tu documentación. La conexión es el único requisito previo.
Adjuntar requiere un administrador. Solo los administradores pueden abrir esta configuración, aunque se puede elegir a cualquier miembro del proyecto para avisarle cuando termine una comprobación.
Las ejecuciones requieren un plan con funciones de IA y créditos. Puedes adjuntar repositorios en cualquier plan, pero no se ejecutará nada hasta que el proyecto tenga uno y disponga de créditos de IA para gastar.
Adjuntar un repositorio
Abre Configuración del proyecto → AI → Self-Updating Docs y, en la tarjeta Code repositories:
En Add a repository, elige un repositorio de la lista. Aquí solo aparecen los repositorios que la aplicación de GitHub de DeveloperHub ya puede ver, y tu repositorio de documentación queda excluido porque ya está sincronizado.
Haz clic en Add repository.
DeveloperHub obtiene una copia del repositorio y la lee para escribir una guía del agente por ti. Puedes salir de la página mientras trabaja.
Si la obtención falla, el repositorio sigue adjunto y te indica el motivo, de modo que puedas corregirlo y usar Fetch now en lugar de volver a añadirlo.
El contenido de estos repositorios se envía a un modelo de IA cada vez que se lee. Como en cualquier ejecución del agente, solo va a proveedores con retención de datos cero y nunca se usa para entrenar un modelo. Adjunta únicamente código fuente que estés dispuesto a compartir en estas condiciones.
Rama
Cada repositorio se lee desde una sola rama, que se muestra en la fila Branch. Por defecto es la rama predeterminada de tu repositorio.
Cámbiala si no es la rama que quieres leer. Elige aquella en la que llegan los cambios de tu código, para que el agente vea el código que tu documentación debe describir. Si tu documentación solo cubre lo ya publicado, elige en su lugar la rama desde la que haces las versiones.
La rama que elijas se aplica a todo el proyecto. Si documentas varias versiones, todas leen esa misma rama.
La guía del agente
La Agent guide describe qué es el repositorio y qué contiene cada directorio. Es lo que más influye en el buen funcionamiento del agente: con una buena guía va directo al lugar correcto, por lo que las ejecuciones terminan antes y responden con más precisión.
DeveloperHub escribe una primera guía por ti cuando adjuntas un repositorio. Puedes editarla a mano en cualquier momento o usar Rewrite it for me para que lea el repositorio y escriba una nueva. Reescribirla sustituye todo lo que haya en el cuadro.
Mantener la copia actualizada
La copia de tu repositorio se actualiza sola mientras trabaja el agente. También puedes actualizarla tú con Fetch now y salir de la página mientras trabaja. Si la obtención falla, la fila muestra el motivo.
Si un repositorio no se ha leído en más de una semana, la fila indica la antigüedad de la copia. Conviene vigilarlo, porque una copia desactualizada puede llevar al agente a corregir con total seguridad una página que ya era correcta.
Comprobación de pull requests
Activa Check PRs for new doc changes en un repositorio y el agente leerá cada nueva pull request, determinará si tu documentación debe cambiar y preparará los cambios para su revisión.
No se publica nada. La ejecución deja los cambios propuestos en AI Agent para que alguien los revise, igual que un cambio que hubieras pedido tú mismo.
Una ejecución se inicia cuando se abre una pull request, se reabre, se marca como lista para revisión o se actualiza con nuevos commits. El agente informa en la pull request mediante una comprobación llamada DeveloperHub docs. La comprobación nunca es un éxito ni un fallo y nunca bloquea una fusión: indica que no hace falta ningún cambio de documentación o cuántos cambios se propusieron y dónde revisarlos.
Para revisar lo que preparó una ejecución, abre AI Agent y selecciona la ejecución en la sección Pull requests de la lista de conversaciones anteriores. La comprobación enlaza directamente ahí desde que la ejecución empieza, de modo que al seguirla desde la pull request llegas a la ejecución correcta y puedes seguir el proceso mientras el agente aún lee. Puedes responder a una ejecución para pedir más, pero no puedes asumirla como conversación propia ni responder mientras sigue trabajando. Una ejecución en curso puede detenerse, y se conserva todo lo que preparó antes de detenerla.
Los revisores también pueden leer estas ejecuciones, línea por línea, sin poder responder ni guardar. El resto de personas de la pull request necesita una cuenta de DeveloperHub en el proyecto: el enlace no es público y no caduca.
Las comprobaciones consumen créditos de IA del mismo saldo que las conversaciones que inicia tu equipo, por lo que un proyecto sin créditos no ejecuta comprobaciones hasta que se renueve o se recargue.
Si un repositorio es público, cualquiera puede abrir una pull request en él. Nuestro proveedor de IA lee el título, la descripción y los cambios de código de cada una, y la comprobación que se deja en la pull request nombra las páginas de documentación que cambiarían y cuánto gana o pierde cada una. Todo ello es visible para cualquiera que pueda ver el repositorio.
Cada repositorio puede ejecutar como máximo 20 comprobaciones al día y lo indica en la pull request cuando se alcanza el límite. El límite se restablece a medianoche UTC, y volver a hacer push antes no iniciará una comprobación.
Avisar a las personas sobre una ejecución
Usa Notify when a check finishes para elegir quién recibe un correo. Solo se puede elegir a miembros del proyecto, y únicamente las ejecuciones que realmente proponen un cambio envían algo, por lo que una pull request que no necesitó actualizar la documentación pasa en silencio. Los revisores de la pull request no reciben aviso.
Qué hace el agente con tu código
Puede listar y buscar archivos, encontrar dónde se define una clase o función, leerlos, leer tu historial de commits y leer la diferencia entre commits. Todo lo que lee en una conversación proviene de un único commit, de modo que sus respuestas se mantienen coherentes mientras trabajas, y puedes pedirle que obtenga el código más reciente cuando hayas subido algo nuevo.
El agente trata tu código como evidencia de lo que afirma tu documentación, no como algo que copiar. Te avisa cuando una página y el código no coinciden en lugar de copiar tu código fuente en nuevas páginas de referencia. Todo lo que lee se trata como material sobre el que trabajar, así que las instrucciones escritas dentro de un archivo se te comunican en lugar de seguirse.
El agente nunca lee archivos de credenciales comunes, como archivos .env, claves privadas y credenciales de la nube.
Límites
Un repositorio debe pesar menos de 250 MB. Contáctanos si necesitas límites más altos.
Los archivos individuales de más de 1 MB no se copian, por lo que el agente trabaja con los archivos más pequeños que los rodean.
Solo se busca en el primer repositorio adjunto cuando señalas un archivo de código con
@en AI Agent.
Si desconectas GitHub
Al desconectar GitHub se eliminan todos los repositorios de código adjuntos, junto con su rama, guía del agente, ajuste de pull requests y lista de notificaciones, y se borran las copias que conserva DeveloperHub. Los archivos de tus propios repositorios no se tocan.