Conector de IA do GitHub

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

Como conecto o GitHub?

Existem duas maneiras diferentes de conectar o GitHub à IA do Notion. Para conectar a organização do GitHub, você precisa ser proprietário de um espaço de trabalho e proprietário do GitHub. Para conectar repositórios privados, você pode ser membro do espaço de trabalho.

Se você for proprietário de um espaço de trabalho no Notion e proprietário no GitHub:

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ê for membro do espaço de trabalho no Notion:

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.

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.

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.

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.

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?”