Conector da IA do Notion para o GitHub

Para conectar o GitHub à IA do Notion:

• Você deve ser proprietário de uma organização do GitHub e proprietário de um espaço de trabalho do Notion.

• O espaço de trabalho precisa estar no Plano Business ou Enterprise e ter mais de um membro.

Depois que a conexão for feita, os membros do seu espaço de trabalho do Notion deverão fazer login para acessar os repositórios aos quais tenham acesso.

Para conectar o GitHub ao seu espaço de trabalho do Notion:

1. Acesse Configurações → IA do Notion.

2. Selecione o botão + ao lado do GitHub.

   

3. Você será levado ao GitHub. Verifique se você está conectado com a conta correta do GitHub. Não feche o Notion durante o processo de configuração!

   

4. Na página aberta, conecte-se ao GitHub e selecione a organização que deseja sincronizar. Observe que, se você quiser conectar um repositório pessoal do GitHub, primeiro você deve criar uma organização e, em seguida, mover o repositório para a organização.

5. Selecione All repositories (recomendado) ou Select repositoriese, em seguida, selecione Install.

6. Retorne ao Notion.

Depois que a integração for configurada, ela poderá indexar PRs e problemas que remontam a um ano após a conclusão da configuração. Você também terá acesso a todos os arquivos de código, incluindo arquivos de remarcação e READMes, sem restrições de tempo.

A conexão pode levar até 72 horas para ser concluída. Depois disso, cada usuário do seu espaço de trabalho do Notion deve se autenticar com o GitHub individualmente para usar a integração, e suas permissões serão mapeadas de acordo.

Se você não for o proprietário do seu espaço de trabalho do Notion ou da sua organização do Github, precisará primeiro de um proprietário para conectar o Notion ao Github antes de poder usar a integração. Depois que a integração for configurada por um proprietário, você precisará fazer login para conectar seus repositórios privados. Confira o passo a passo:

1. No Notion, abra a IA do Notion na parte inferior da tela e clique em ••• → Conectar com GitHub.

2. Selecione Entrar e conecte sua conta do GitHub.

Cada usuário só poderá usar a IA do Notion para ver e pesquisar conteúdos aos quais tenha acesso no GitHub. A IA do Notion pode recuperar as informações de PRs dos últimos doze meses.

O conector da IA para o GitHub é mais útil para:

• Perguntar sobre alterações recentes e atualizações de projetos.

• Encontrar implementações de código.

• Procurar problemas e seus status.

• Depurar problemas. Por exemplo, você pode obter o contexto quando os recursos estão quebrados ou apresentando erros lendo as PRs recentes.

• Encontrar padrões de segurança.

Você pode tentar solicitar à IA do Notion o seguinte:

• "Quais são as novidades do {nome do projeto}?"

• “Em quais pull requests trabalhamos na semana passada?”

• “Quais são as mudanças recentes no nosso sistema de autenticação?”

• “Mostre exemplos de como estamos implementando o tratamento de erros na nossa base de código.”

• “Quais são as principais dependências usadas em nossos componentes front-end?”

• “Encontre implementações das funções de migração de base de dados.”

• “Quais padrões de segurança estamos usando para os endpoints da API?”

Você pode pesquisar o GitHub por meio de conectores da IA do Notion nos seguintes lugares:

• O chat da IA do Notion no canto inferior direito do Notion.

• No widget da IA do Notion na parte superior da Página inicial.

• Buscar na barra lateral.

Você pode restringir a sua pesquisa apenas ao GitHub abrindo o botão Todas as fontes no chat e na Página inicial e selecionando GitHub. Você também pode filtrar os resultados da busca da IA do Notion para mostrar apenas informações do GitHub.

Quem pode conectar o GitHub à IA do Notion?

Ao conectar o GitHub à IA do Notion pela primeira vez, você deve ser proprietário de um espaço de trabalho do Notion e proprietário de uma organização do GitHub. Depois que a conexão for feita, os membros do seu espaço de trabalho do Notion deverão fazer login para acessar os repositórios aos quais tenham acesso.

Quem pode usar essa integração?

Depois que o conector de IA do GitHub estiver configurado para o espaço de trabalho, os membros poderão usar a integração para obter respostas:

• Repositórios públicos: nenhuma autenticação adicional é necessária após a configuração inicial do conector por um proprietário.

• Repositórios privados: cada membro deve fazer login/autenticação com o GitHub para verificar o acesso.

Conectei o espaço de trabalho errado do Notion. Como posso desconectar meu repositório do Github?

Os proprietários do espaço de trabalho podem desconectar ou editar canais após a integração inicial ser concluída acessando Configurações → IA do Notion. Selecione ao ⚙️ lado de GitHub → Configurações → Desconectar.

Quanto tempo leva para a integração ser concluída?

A configuração da integração pode levar até 72 horas, dependendo do tamanho do repositório e do tipo de plano do GitHub.

Quanto tempo leva para o novo conteúdo do GitHub se refletir na IA do Notion?

Após a configuração inicial, indexaremos novos dados a cada 30 minutos.

Todos no meu espaço de trabalho do Notion podem acessar as informações do GitHub?

Os membros devem se autenticar e fazer login individualmente para recuperar informações de repositórios privados aos quais já têm acesso no GitHub.

Posso fazer perguntas sobre o conteúdo do GitHub de quanto tempo atrás?

É possível recuperar até um ano de PRs e problemas em seu repositório. Todos os READMes estarão disponíveis sem restrições de tempo.

A que a IA do Notion tem acesso?

Durante o processo de integração, depois de selecionar a organização do GitHub que você gostaria de conectar, você pode escolher se a IA do Notion tem acesso a:

• Todos os repositórios: isso se aplica a todos os repositórios atuais e futuros pertencentes ao proprietário do recurso. Também inclui repositórios públicos (somente leitura).

• Somente propriedades selecionadas: selecione pelo menos um repositório. Também inclui repositórios públicos (somente leitura).

Que conteúdo do GitHub é compatível com o conector IA?

Depois que o conector de IA for configurado para o espaço de trabalho, ele poderá indexar código, pull requests, problemas, arquivos e READMEs.

Os conectores da IA do Notion respeitam as permissões existentes da IA do Notion?

Com certeza. A IA do Notion honrará as autorizações existentes de acordo as práticas de segurança da IA do Notion em vigor. Usuários não poderão gerar conteúdo ou receber respostas da IA do Notion baseadas nos recursos aos quais não têm acesso.

Especificamente em relação ao conteúdo de terceiros, a IA do Notion lida com o conteúdo particular e público com a segurança em mente, processando apenas o conteúdo de acordo com o mapeamento de autorizações entre os usuários do GitHub e do Notion.

Como a IA do Notion lida com o mapeamento de permissões?

Os usuários só verão o conteúdo do GitHub (por exemplo, código, pull requests, problemas) na IA do Notion que eles pessoalmente têm permissão para acessar no GitHub. Mesmo que alguém tente consultar um repositório ao qual não tem acesso no GitHub, a IA do Notion não retornará resultados desse repositório.

• O usuário deve ser membro do GitHub e do Notion para autenticar esse aplicativo no nível de usuário.

  • Os usuários não precisam usar o mesmo endereço de e-mail no Notion e no GitHub.

  • As permissões são mapeadas com base na autenticação bem-sucedida de cada usuário com sua conta do GitHub, não comparando endereços de e-mail. A IA do Notion depende do login OAuth para confirmar a identidade e o escopo da permissão, não da correspondência de e-mail.

• Sincronizamos as permissões do GitHub a cada hora e atualizamos as permissões no Notion de acordo.

Como o Notion armazena ou faz referência aos meus dados do GitHub nos seus sistemas?

Assim como com o produto principal da IA do Notion, armazenamos incorporações em uma base de dados vetorial hospedada pela Turbopuffer, que fornece a capacidade de oferecer respostas a perguntas extraídas de fontes de conteúdo externas (como o GitHub). A Turbopuffer foi aprovada pela nossa equipe de segurança e por um auditor externo para obter a certificação SOC2 Tipo II. Saiba mais sobre a segurança do Turbopuffer aqui →