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 de pertenecer al plan Business o Enterprise y contar con más de un miembro.

Una vez completada 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 + junto a GitHub.

   

3. Se te llevará 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 abre a continuación, 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 esta.

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

6. Vuelve a Notion.

Tras configurar la integración, esta podrá indexar las relaciones públicas y los problemas que se remonten a un año atrás 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 rebajas y los archivos 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 contar con un propietario para conectar 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 ello:

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 puede recuperar la información de las solicitudes de incorporación de cambios del último año.

La conexión de IA de GitHub te servirá, sobre todo, para:

• Preguntar sobre cambios recientes y actualizaciones de proyectos.

• Encontrar implementaciones de código.

• Buscar incidencias y el estado de las mismas.

• Problemas de depuración. Por ejemplo, puedes obtener información cuando las funciones están rotas o aparecen 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áles son las últimas novedades sobre {nombre del proyecto}?».

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

• «¿Cuáles son los cambios más recientes en nuestro sistema de autenticación?».

• «Muéstrame ejemplos de cómo estamos implementando la gestión 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 limitar 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 te enseñe 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 completada 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.

¿Quién puede usar esta integración?

Una vez que se configura el conector de IA de GitHub para el espacio de trabajo, los miembros pueden usar la integración para recuperar respuestas:

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

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

He conectado el espacio de trabajo de Notion equivocado. ¿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 el contenido nuevo en GitHub en reflejarse 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 individualmente para recuperar información de los repositorios privados a los que ya tienen acceso en GitHub.

¿De cuánta antigüedad puede ser la información de GitHub sobre la que quiero preguntar?

Puedes recuperar hasta un año de PR (solicitudes de incorporación de cambios) y problemas del repositorio. 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 tiene acceso a:

• Todos los repositorios: esto se aplica a todos los repositorios actuales y futuros que sean propiedad del 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 ha configurado el conector de IA para el espacio de trabajo, puede indexar código, solicitudes de incorporación de cambios, incidencias, archivos y 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 el contenido público como privado con un enfoque prioritario en la seguridad, y solo procesa el contenido conforme a la asignación de permisos entre los usuarios de Jira y Notion.

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

Los usuarios solo verán el contenido de GitHub (por ejemplo, código, solicitudes de incorporación de cambios, incidencias) en la IA de Notion al que tengan permiso personal para acceder en GitHub. Aunque alguien intente consultar un repositorio al que no tenga acceso en GitHub, la IA de Notion no devolverá resultados de ese repositorio.

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

  • Los usuarios no necesitan usar la misma dirección de correo electrónico en Notion y GitHub.

  • Los permisos se asignan en función de la autenticación correcta 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 de OAuth para confirmar la identidad y el alcance de los permisos, no en la coincidencia de correos electrónicos.

• Sincronizamos los permisos de GitHub cada hora y los actualizamos en Notion en consecuencia.

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

Al igual que en el caso de nuestro producto principal de la IA de Notion, creamos y almacenamos incrustaciones en una base de datos vectorial alojada en Turbopuffer, lo cual permite responder a preguntas que aprovechan el contenido de terceros (por ejemplo, GitHub). Después de una evaluación por nuestro equipo de seguridad y por un auditor externo, Turbopuffer obtuvo la certificación SOC 2 Tipo 2. Obtén más información sobre la seguridad de Turbopuffer aquí →