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.

¿Quién puede usar esta integración?

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.

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.

¿A qué tiene acceso la IA de Notion?

Durante el proceso de incorporación, después de seleccionar la organización de GitHub que quieres conectar, puedes elegir si la IA de Notion tendrá acceso a:

• Todos los repositorios: aplica a todos los repositorios actuales y futuros que sean administrados por el propietario del recurso. También incluye repositorios públicos (solo lectura).

• Solo propiedades seleccionadas: selecciona al menos un repositorio. También incluye repositorios públicos (solo lectura).

¿Qué contenido de Jira es compatible con la conexión de la IA?

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.

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

Con respecto al contenido de terceros, la IA de Notion gestiona tanto contenido público como privado con estrictas consideraciones de seguridad, y solo procesa información conforme a la asignación de permisos establecida entre los usuarios de GitHub y Notion.

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

Los usuarios solo verán en la IA de Notion el contenido de GitHub (código, solicitudes de incorporación de cambios e incidencias) al que tengan acceso autorizado directamente en GitHub. Incluso si alguien intenta consultar un repositorio al que no tiene acceso en GitHub, la IA de Notion no devolverá resultados provenientes de dicho repositorio.

• Para autenticar esta app a nivel de usuario, el usuario debe ser miembro de GitHub y Notion.

  • No es necesario que los usuarios usen la misma dirección de correo electrónico en Notion y GitHub.

  • Los permisos se asignan en función de la autenticación exitosa de cada usuario con su cuenta de GitHub, no comparando direcciones de correo electrónico. La IA de Notion se basa en el inicio de sesión mediante OAuth para verificar la identidad y el alcance de los permisos, sin basarse en la coincidencia de direcciones de correo electrónico.

• 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 →