Connettore AI per GitHub

In questo articolo di supporto

Scopri come sbloccare le tue conoscenze GitHub in Notion AI 🤖

Vai alle Domande frequenti

  • Questa funzionalità è disponibile nei piani Business e nel piano Enterprise.

  • Notion AI genera risposte usando LLM come GPT-5 e Claude. Assicurati di ricontrollare tutte le risposte per verificarne l'accuratezza.

  • Ci sono molti altri modi per usare Slack e Notion insieme. Scopri di più sulla nostra connessione a Slack →

Chi può collegare GitHub a Notion AI?

  • Devi essere proprietario dell'organizzazione GitHub e proprietario dello spazio di lavoro Notion.

  • Il tuo spazio di lavoro deve essere nel piano Business o Enterprise e avere più di un membro.

Una volta configurato il connettore AI per GitHub per lo spazio di lavoro, i membri possono utilizzare l'integrazione per recuperare risposte:

  • Repository pubblici: nessuna autenticazione aggiuntiva richiesta dopo la configurazione iniziale del connettore da parte di un proprietario.

  • Repository privati: ogni membro deve accedere/autenticarsi con GitHub per verificare l'accesso.

Come collego GitHub?

Esistono due modi diversi per connettere GitHub a Notion AI. Per connettere l'organizzazione GitHub, devi essere proprietario dello spazio di lavoro e proprietario dell'organizzazione GitHub. Per connettere repository privati, puoi essere un membro dello spazio di lavoro.

Se sei proprietario dello spazio di lavoro Notion e proprietario dell'organizzazione GitHub:

Per connettere GitHub al tuo spazio di lavoro Notion:

  1. Vai su ImpostazioniNotion AI.

  2. Seleziona + accanto a GitHub.

  3. Verrai reindirizzato a GitHub. Assicurati di aver effettuato l'accesso con l'account GitHub corretto. Non chiudere Notion durante il processo di configurazione!

  4. Nella pagina che si apre, connettiti a GitHub e seleziona l'organizzazione che desideri sincronizzare. Nota: se desideri connettere un repository GitHub personale, devi prima creare un'organizzazione e poi spostare il repository al suo interno.

  5. Seleziona Tutti i repository (scelta consigliata) o Seleziona repository, quindi seleziona Installa.

  6. Torna su Notion.

Una volta configurata, l'integrazione sarà in grado di indicizzare PR e issue risalenti fino a un anno prima dal completamento della configurazione. Avrai inoltre accesso a tutti i file di codice, inclusi i file markdown e i file README, senza limiti di tempo.

Nota: Al momento, i Wiki e i repository fork non sono supportati.

Il completamento della connessione può richiedere fino a 72 ore. Successivamente, ogni utente nel tuo spazio di lavoro Notion dovrà autenticarsi individualmente con GitHub per utilizzare l'integrazione e le relative autorizzazioni verranno mappate di conseguenza.

Se sei un membro dello spazio di lavoro Notion:

Se non sei il proprietario del tuo spazio di lavoro Notion o della tua organizzazione GitHub, dovrai chiedere a un proprietario di collegare Notion a GitHub prima di poter utilizzare l'integrazione. Una volta che l'integrazione è stata configurata da un proprietario, dovrai accedere per collegare i tuoi repository privati. Per farlo:

  1. In Notion, apri Notion AI nella parte inferiore dello schermo e fai clic su •••Connect GitHub.

  2. Seleziona Log In e collega il tuo account GitHub.

Quali contenuti di GitHub possono essere connessi a Notion AI?

Una volta che il connettore AI è stato configurato per lo spazio di lavoro, può indicizzare codice, PR, problemi, file e README.

Ogni utente potrà utilizzare Notion AI solo per visualizzare e cercare contenuti a cui ha accesso in GitHub. Notion AI può recuperare le informazioni dell'ultimo anno dalle PR.

Puoi effettuare ricerche in GitHub tramite le connessioni AI di Notion nei seguenti punti:

  • La chat di Notion AI in basso a destra in Notion.

  • Il widget di Notion AI nella parte superiore di Home.

  • Cerca nella barra laterale.

Puoi restringere la ricerca a GitHub aprendo il menu a tendina Tutte le fonti nella chat e Home, quindi selezionando GitHub. Puoi anche filtrare i risultati di Cerca di Notion AI per mostrare solo le informazioni provenienti da GitHub.

Il connettore AI per GitHub è particolarmente utile per:

  • Chiedere informazioni su modifiche recenti e aggiornamenti di progetto.

  • Trovare implementazioni di codice.

  • Cercare problemi e il loro stato.

  • Esegui il debug dei problemi. Ad esempio, puoi ottenere contesto quando le funzionalità sono interrotte o generano errori leggendo le PR recenti.

  • Trovare pattern di sicurezza.

Potresti provare a chiedere a Notion AI quanto segue:

  • "Quali sono le ultime novità su {project name}?"

  • "Su quali pull request abbiamo lavorato nell'ultima settimana?"

  • "Quali sono le modifiche recenti al nostro sistema di autenticazione?"

  • "Mostrami esempi di come stiamo implementando la gestione degli errori nella nostra codebase."

  • "Quali sono le principali dipendenze utilizzate nei nostri componenti frontend?"

  • "Trova le implementazioni delle funzioni di migrazione del database."

  • "Quali pattern di Sicurezza stiamo utilizzando per gli endpoint API?"


Domande frequenti

Ho connesso lo spazio di lavoro Notion sbagliato. Come posso disconnettere il mio repository GitHub?

I proprietari dello spazio di lavoro possono disconnettere o modificare i canali dopo il completamento dell'integrazione iniziale andando su ImpostazioniNotion AI. Seleziona ⚙️ accanto a GitHub → ImpostazioniDisconnetti.

Quanto tempo occorre affinché l'integrazione venga completata?

La configurazione dell'integrazione può richiedere fino a 72 ore a seconda delle dimensioni del repository e del tipo di piano GitHub.

Quanto tempo occorre affinché il nuovo contenuto in GitHub venga visualizzato in Notion AI?

Dopo la configurazione iniziale, i nuovi dati potrebbero impiegare fino a 3 ore per essere indicizzati da Notion AI. Volumi di dati più grandi potrebbero richiedere più tempo.

Tutti nel mio spazio di lavoro Notion possono accedere ai contenuti di GitHub?

I membri di uno spazio di lavoro devono autenticare e accedere individualmente per recuperare informazioni dai repository privati a cui hanno già accesso in GitHub.

Quanto indietro nel tempo posso porre domande su GitHub?

Puoi recuperare fino a un anno di PR e issue nel loro repository. Tutti i README saranno disponibili senza alcuna restrizione temporale.

A cosa ha accesso Notion AI?

Durante il processo di onboarding, dopo aver selezionato l'organizzazione GitHub che desideri connettere, puoi scegliere se Notion AI ha accesso a:

  • Tutti i repository: Questo si applica a tutti i repository attuali e futuri di proprietà del proprietario della risorsa. Include anche i repository pubblici (sola lettura).

  • Solo repository selezionati: Seleziona almeno un repository. Include anche i repository pubblici (sola lettura).

Le connessioni AI di Notion rispettano i permessi esistenti di Notion AI?

Assolutamente. Notion AI rispetterà i permessi esistenti in conformità con le nostre Pratiche di sicurezza di Notion AI attuali. Gli utenti non saranno in grado di generare contenuto o ricevere risposte di Notion AI basate su risorse di terze parti a cui non hanno accesso.

Nello specifico per i contenuti di terze parti, Notion AI gestisce sia contenuti privati che pubblici tenendo presente la sicurezza, acquisendo contenuti solo in base alla mappatura dei permessi tra gli utenti GitHub e Notion.

In che modo Notion AI gestisce la mappatura dei permessi?

Gli utenti vedranno in Notion AI solo i contenuti GitHub (ad esempio, codice, PR, issue) a cui hanno personalmente il permesso di accedere in GitHub. Anche se qualcuno provasse a interrogare un repository a cui non ha accesso in GitHub, Notion AI non restituirà risultati da quel repository.

  • L'utente deve essere sia un membro di GitHub che di Notion per autenticare questa app a livello utente.

  • Gli utenti non devono utilizzare lo stesso indirizzo email in Notion e GitHub.

  • I permessi vengono mappati in base all'autenticazione riuscita di ogni utente con il proprio account GitHub, non confrontando gli indirizzi email. Notion AI si affida all'accesso OAuth per confermare l'identità e l'ambito dei permessi, non alla corrispondenza delle email.

  • Sincronizziamo i permessi da GitHub ogni ora e aggiorniamo i permessi in Notion di conseguenza.

In che modo Notion archivia o fa riferimento ai miei dati GitHub nei suoi sistemi?

Analogamente al nostro prodotto Notion AI principale, creiamo e archiviamo embeddings in un database vettoriale ospitato da Turbopuffer, che consente di fornire risposte a domande che sfruttano contenuti di terze parti (ad esempio, GitHub). Turbopuffer è stato esaminato dal nostro team di sicurezza e da un revisore esterno per ottenere la certificazione SOC2 Type II. Scopri di più sulla sicurezza di Turbopuffer qui


Lascia un feedback

Ti è stata utile questa risorsa?