Conexión de la IA para GitHub (beta)

¿Quién puede conectar GitHub a la IA de Notion?

• Debes ser propietario tanto de la organización de GitHub como del espacio de trabajo de Notion.

• Tu espacio de trabajo debe pertenecer al plan Business o Enterprise y contar con más de un miembro.

Una vez que la conexión de la IA con GitHub se configura en el espacio de trabajo, los miembros podrán usar la integración para obtener respuestas:

• Repositorios públicos: después de la configuración inicial de la conexión por parte de un propietario, no se requiere autenticación adicional.

• Repositorios privados: cada miembro debe iniciar sesión o autenticarse con GitHub para verificar el acceso.

¿Cómo conecto GitHub?

Existen dos formas diferentes de conectar GitHub a la IA de Notion. Para conectar la organización de GitHub, debes ser propietario del espacio de trabajo de Notion y de la organización de GitHub. Para conectar repositorios privados, puedes ser miembro del espacio de trabajo.

Si eres propietario de un espacio de trabajo de Notion y de un organización de GitHub:

Para conectar GitHub a tu espacio de trabajo de Notion:

1. Ve a Configuración → IA de Notion.

2. Selecciona el ícono + junto a GitHub.

   

3. Te redirigiremos a GitHub. Asegúrate de haber iniciado sesión con la cuenta de GitHub correcta. ¡No cierres Notion durante el proceso de configuración!

   

4. En la página que se abre, conéctate a GitHub y selecciona la organización que quieres sincronizar. Ten en cuenta que si quieres conectar un repositorio personal de GitHub, primero debes crear una organización y luego mover el repositorio a dicha organización.

5. Selecciona Todos los repositorios (recomendado) o Seleccionar repositoriosy, a continuación, haz clic en Instalar.

6. Regresa a Notion.

Tras configurar la integración, esta podrá indexar solicitudes de incorporación de cambios e incidencias de hasta un año de antigüedad desde el momento en que se complete la configuración. También tendrás acceso a todos los archivos de código, incluidos los archivos de Markdown y README, sin restricciones de tiempo.

La conexión puede tardar hasta 72 horas en completarse. Después, cada usuario de tu espacio de trabajo de Notion deberá autenticarse con GitHub individualmente para usar la integración y se le asignarán sus permisos pertinentes.

Si eres miembro de un espacio de trabajo de Notion:

Si no eres el propietario de tu espacio de trabajo de Notion o de tu organización de GitHub, primero necesitarás que un propietario conecte Notion con GitHub antes de poder usar la integración. Una vez que un propietario haya configurado la integración, tendrás que iniciar sesión para conectar tus repositorios privados. Para hacerlo:

1. En Notion, abre la IA de Notion en la parte inferior de la pantalla y haz clic en ••• → Conectar GitHub.

2. Selecciona Iniciar sesión y conecta tu cuenta de GitHub.

Una vez que se configure la conexión de la IA para el espacio de trabajo, podrá indexar código, solicitudes de incorporación de cambios, incidencias, archivos y archivos README.

Cada usuario solo podrá usar la IA de Notion para ver y buscar contenido al que tenga acceso en GitHub. La IA de Notion puede recuperar la información de las solicitudes de incorporación de cambios de hasta un año de antiguedad.

Puedes buscar en GitHub a través de las conexiones de la IA de Notion en los siguientes lugares:

• El chat de la IA de Notion en la esquina inferior derecha de Notion.

• El widget de la IA de Notion en la parte superior de la página de inicio.

• La herramienta Buscar en la barra lateral.

Si quieres acotar tu búsqueda únicamente a GitHub, haz clic en Todas las fuentes en el chat y en Inicio y selecciona GitHub. También puedes filtrar los resultados de búsqueda de la IA de Notion para que solo muestre información de GitHub.

La conexión de la IA para GitHub es muy útil para:

• Preguntar sobre cambios recientes y actualizaciones de proyectos.

• Encontrar implementaciones de código.

• Buscar problemas y su estado.

• Problemas de depuración. Por ejemplo, puedes obtener contexto cuando las funciones están rotas o arrojan errores al leer las solicitudes de incorporación de cambios recientes.

• Encontrar patrones de seguridad.

Puedes darle una de las siguientes indicaciones a la IA de Notion:

• "¿Cuál es el estado actual de {nombre del proyecto}?"

• "¿En qué solicitudes de incorporación de cambios trabajamos la semana pasada?"

• "¿Cuáles son los cambios recientes en nuestro sistema de autenticación?"

• "Muéstrame ejemplos de cómo estamos implementando el manejo de errores en nuestra base de código"

• "¿Cuáles son las principales dependencias utilizadas en nuestros componentes de frontend?"

• "Busca implementaciones de las funciones de migración de la base de datos"

• "¿Qué patrones de seguridad estamos usando para los puntos finales de la API?"