Conexión de la IA de Notion para GitHub

Para 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 establecida la conexión, los miembros de tu espacio de trabajo de Notion deben iniciar sesión para acceder a los repositorios a los que tienen acceso.

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

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.

La conexión de la IA de 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?"

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.

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

Para conectar GitHub a la IA de Notion por primera vez, debes ser propietario del espacio de trabajo de Notion y también propietario de la organización de GitHub. Una vez establecida la conexión, los miembros de tu espacio de trabajo en Notion deben iniciar sesión para acceder a los repositorios a los que tienen acceso.

Conecté el espacio de trabajo de Notion incorrecto. ¿Cómo puedo desconectar mi repositorio de GitHub?

Los propietarios de espacios de trabajo pueden desconectar o editar canales después de que se complete la integración inicial desde el menú Configuración → IA de Notion. Selecciona ⚙️ junto a GitHub → Configuración → Desconectar.

¿Cuánto tiempo tarda en completarse la integración?

Según el tamaño del repositorio y el tipo de plan de GitHub, la configuración de la integración puede tardar hasta 72 horas.

¿Cuánto tarda en reflejarse el contenido nuevo de GitHub en la IA de Notion?

Después de la configuración inicial, indexaremos los datos nuevos cada 30 minutos.

¿Todos los usuarios en mi espacio de trabajo de Notion pueden acceder a la información de GitHub?

Los miembros de un espacio de trabajo deben autenticarse e iniciar sesión de manera individual para recuperar información de repositorios privados a los que ya tienen acceso en GitHub.

¿Qué tan antigua puede ser la información de GitHub sobre la que puedo preguntar?

Puedes acceder a información de PR (solicitudes de incorporación de cambios) e incidencias del repositorio de hasta un año. Todos los archivos README estarán disponibles sin restricciones de tiempo.

¿Las conexiones de la IA de Notion respetan los permisos existentes de la IA?

Por supuesto. La IA de Notion respetará los permisos actuales de acuerdo con las prácticas de seguridad de la IA de Notion. Los usuarios no podrán generar contenido ni recibir respuestas de la IA de Notion basadas en recursos de terceros a los que no tengan acceso.

¿Cómo gestiona la IA de Notion la asignación de permisos?

La IA de Notion para GitHub conecta a los miembros de GitHub con los miembros de Notion. Para autenticar esta app a nivel de usuario, el usuario debe ser miembro de GitHub y Notion. Sincronizamos los permisos de GitHub cada hora y los actualizamos en Notion debidamente.

¿Cómo almacena o hace referencia Notion a mis datos de GitHub en sus sistemas?

Al igual que con nuestro principal producto, la IA de Notion, creamos y almacenamos incrustaciones en una base de datos vectorial alojada por Turbopuffer, lo que permite proporcionar respuestas a consultas utilizando contenido de terceros (por ejemplo, GitHub). Luego de una evaluación exhaustiva por parte de nuestro equipo de seguridad, así como por un auditor externo, Turbopuffer obtuvo la certificación SOC 2 Tipo II. Para obtener más información sobre la seguridad de Turbopuffer, consulta este enlace →