GitHub AI -liitin

Tässä ohjeasiakirjassa

Opi, miten voit hyödyntää GitHub-tietojasi Notion AI:ssa 🤖

Siirry usein kysyttyihin kysymyksiin

  • Tämä ominaisuus on saatavilla Business- ja Enterprise-sopimuksissa.

  • Notion AI luo vastauksia käyttämällä kielimalleja, kuten GPT-5 ja Claude. Muista tarkistaa kaikkien vastausten paikkansapitävyys.

  • Voit käyttää Slackia ja Notionia yhdessä monin eri tavoin. Lue lisää Slack-yhteydestä →

Yhdistä GitHub Notion AI:hin

Kuka voi yhdistää GitHubin Notion AI:hin?

  • Sinun on oltava GitHub-organisaation omistaja ja Notion-työtilan omistaja.

  • Työtilasi on oltava Business- tai Enterprise-sopimus, ja siinä on oltava useampi kuin yksi jäsen.

Kun GitHub AI -liitin on määritetty työtilalle, jäsenet voivat käyttää integraatiota vastausten hakemiseen:

  • Julkiset tietovarastot: Ei vaadi lisätodennusta sen jälkeen, kun omistaja on tehnyt alkuperäisen liittimen määrityksen.

  • Yksityiset tietovarastot: Jokaisen jäsenen on kirjauduttava sisään tai todennettava itsensä GitHubin kautta, jotta pääsy vahvistetaan.

Miten yhdistän GitHubin?

GitHubin voi yhdistää Notion AI:hin kahdella eri tavalla. GitHub-organisaation yhdistäminen edellyttää, että olet sekä työtilan omistaja että GitHub-omistaja. Yksityisten tietovarastojen yhdistämiseen riittää, että olet työtilan jäsen.

Jos olet Notion-työtilan omistaja ja GitHub-omistaja:

GitHubin yhdistäminen Notion-työtilaasi:

  1. Siirry kohtaan Asetukset → Notion AI.

  2. Valitse + kohdan GitHub vierestä.

    hc: GitHub-liittimen aloituspiste

  3. Sinut ohjataan GitHubiin. Varmista, että olet kirjautunut sisään oikealla GitHub-käyttäjätilillä. Älä sulje Notionia asennusprosessin aikana!

    hc: GitHub-liittimen määritys

  4. Yhdistä avautuvalla sivulla GitHubiin ja valitse organisaatio, jonka haluat synkronoida. Huomaa, että jos haluat yhdistää henkilökohtaisen GitHub-tietovaraston, sinun on ensin luotava organisaatio ja siirrettävä tietovarasto siihen.

  5. Valitse Kaikki tietovarastot (suositus) tai Valitse tietovarastot ja valitse sitten Asenna.

  6. Palaa Notioniin.

Kun integraatio on määritetty, se voi indeksoida pull requestit (PR) ja ongelmat vuoden ajalta määrityksen valmistumisesta alkaen. Sinulla on myös pääsy kaikkiin kooditiedostoihin, mukaan lukien markdown-tiedostot ja README-tiedostot, ilman aikarajoituksia.

Huomio: Tällä hetkellä wikejä ja haarautettuja tietovarastoja ei tueta.

Yhteyden muodostaminen voi kestää jopa 72 tuntia. Tämän jälkeen jokaisen Notion-työtilasi käyttäjän on todennettava itsensä GitHubin kautta erikseen integraation käyttämiseksi, ja heidän käyttöoikeutensa määritetään sen mukaisesti.

Jos olet Notion-työtilan jäsen:

Jos et ole Notion-työtilasi tai GitHub-organisaatiosi omistaja, tarvitset omistajan yhdistämään Notionin GitHubiin, ennen kuin voit käyttää integraatiota. Kun omistaja on määrittänyt integraation, sinun on kirjauduttava sisään yhdistääksesi yksityiset tietovarastosi. Tee se näin:

  1. Avaa Notionissa Notion AI näytön alareunasta ja napsauta ••• → Yhdistä GitHub.

  2. Valitse Kirjaudu sisään ja yhdistä GitHub-tilisi.

hc: GitHub-liitin jäsenille

Mitä sisältöä GitHubista voidaan yhdistää Notion AI:hin?

Kun AI-yhdistin on määritetty työtilaa varten, se voi indeksoida koodia, PR-pyyntöjä, ongelmia (Issues), tiedostoja ja README-tiedostoja.

Jokainen käyttäjä voi käyttää Notion AI -palvelua vain nähdäkseen ja etsiäkseen sisältöä, johon hänellä on pääsy GitHubissa. Notion AI voi hakea PR-pyyntöjen tietoja viimeisen vuoden ajalta.

Missä voin käyttää GitHub Notion AI -yhdistintäni?

Voit hakea GitHubista Notion AI -yhdistimien kautta seuraavista paikoista:

  • Notion AI -keskustelu Notionin oikeassa alakulmassa.

  • Notion AI -widget Koti-näkymän yläreunassa.

  • Haku sivuvalikossasi.

Voit rajata haun vain GitHubiin avaamalla Kaikki lähteet -valitsimen keskustelussa ja Koti-näkymässä sekä valitsemalla GitHub. Voit myös suodattaa Notion AI Haku -tuloksia näyttämään vain GitHubista peräisin olevat tiedot.

Parhaat käytännöt ja esimerkkikehotteet

GitHub AI -yhdistin on hyödyllisimmillään seuraavissa tilanteissa:

  • Viimeaikaisista muutoksista ja projektin ilmoituksista kysyminen.

  • Kooditoteutusten etsiminen.

  • Ongelmien ja niiden tilan tarkistaminen.

  • Ongelmien vianmääritys. Voit esimerkiksi saada kontekstia, kun ominaisuudet ovat rikki tai aiheuttavat virheitä, lukemalla viimeisimpiä PR-pyyntöjä.

  • Tietoturvamallien etsiminen.

Voit kokeilla Notion AI:n kehottamista seuraavilla tavoilla:

  • "Mikä on uusinta {project name} -projektissa?"

  • "Mitä pull requesteja työstimme viime viikolla?"

  • "Mitkä ovat viimeisimmät muutokset todennusjärjestelmäämme?"

  • "Näytä esimerkkejä siitä, miten toteutamme virheiden käsittelyn koodikannassamme."

  • "Mitkä ovat tärkeimmät riippuvuudet, joita käytämme käyttöliittymäkomponenteissamme?"

  • "Etsi tietokannan migraatiofunktioiden toteutukset."

  • "Mitä tietoturvamalleja käytämme API-päätepisteissä?"

Lue lisää

Usein kysytyt kysymykset

Yhdistin väärän Notion-työtilan. Miten voin katkaista GitHub-tietovarastoni yhteyden?

Työtilan omistajat voivat katkaista yhteyden tai muokata kanavia alkuperäisen integraation valmistuttua siirtymällä kohtaan Asetukset → Notion AI. Valitse ⚙️ GitHubin vierestä → Asetukset → Katkaise yhteys.

Kuinka kauan integraation valmistuminen kestää?

Integraation määrittäminen voi kestää jopa 72 tuntia tietovaraston koon ja GitHub-tilaustyypin mukaan.

Kuinka kauan kestää, että uusi sisältö GitHubissa näkyy Notion AI:ssa?

Alkuperäisen määrityksen jälkeen uuden tiedon indeksointi Notion AI:ssa voi kestää jopa 3 tuntia. Suuremmat tietomäärät saattavat vaatia enemmän aikaa.

Voivatko kaikki Notion-työtilani käyttäjät käyttää GitHubin tietoja?

Työtilan jäsenten on todennettava ja kirjauduttava sisään yksitellen, jotta he voivat hakea tietoja yksityisistä tietovarastoista, joihin heillä on jo pääsy GitHubissa.

Kuinka kauas menneisyyteen voin kysyä kysymyksiä GitHubista?

Voit hakea enintään yhden vuoden ajalta PR-pyyntöjä ja ongelmia tietovarastostasi. Kaikki README-tiedostot ovat saatavilla ilman aikarajoituksia.

Mihin Notion AI:lla on pääsy?

Käyttöönoton aikana, kun olet valinnut yhdistettävän GitHub-organisaation, voit määrittää, mihin Notion AI saa pääsyn:

  • Kaikki tietovarastot: Tämä koskee kaikkia resurssin omistajan nykyisiä ja tulevia tietovarastoja. Sisältää myös julkiset tietovarastot (vain luku).

  • Vain valitut tietovarastot: Valitse vähintään yksi tietovarasto. Sisältää myös julkiset tietovarastot (vain luku).

Noudattavatko Notion AI -yhdistimet olemassa olevia Notion AI -käyttöoikeuksia?

Ehdottomasti. Notion AI noudattaa olemassa olevia käyttöoikeuksia Notion AI -tietoturvakäytäntöjemme mukaisesti. Käyttäjät eivät voi luoda sisältöä tai vastaanottaa Notion AI -vastauksia, jotka perustuvat kolmannen osapuolen resursseihin, joihin heillä ei ole pääsyä.

Kolmannen osapuolen sisältöä varten Notion AI käsittelee sekä yksityistä että julkista sisältöä tietoturvaa silmällä pitäen. Se vastaanottaa sisältöä vain GitHubin ja Notionin käyttäjien välillä sovitun käyttöoikeuksien kartoituksen mukaisesti.

Miten Notion AI käsittelee käyttöoikeuksien kartoitusta?

Notion AI näyttää sinulle vain sellaista GitHub-sisältöä (esim. koodia, PR-pyyntöjä, ongelmia), joihin sinulla on käyttöoikeus GitHubissa. Jos joku yrittää hakea arkistoa, johon hänellä ei ole oikeuksia, Notion AI ei palauta siitä tuloksia.

  • Sinun täytyy olla sekä GitHubin että Notionin jäsen, jotta voit todentaa tämän sovelluksen käyttäjätasolla.

  • Sinun ei tarvitse käyttää samaa sähköpostiosoitetta Notionissa ja GitHubissa.

  • Käyttöoikeutesi perustuvat siihen, että olet onnistuneesti todentanut GitHub-käyttäjätilisi – eivätkä ne määräydy sähköpostiosoitteiden vertailun perusteella. Notion AI käyttää OAuth-kirjautumista varmistaakseen henkilöllisyytesi ja käyttöoikeuksiesi laajuuden.

  • Synkronoimme käyttöoikeutesi GitHubista tunnin välein ja päivitämme ne Notionissa vastaavasti.

Miten Notion tallentaa tai viittaa GitHub-tietoihisi järjestelmissään?

Kuten ydintuotteessamme Notion AI:ssa, luomme ja tallennamme embeddingsia vektoritietokantaan, jonka Turbopuffer isännöi; näin pystymme tarjoamaan vastauksia kysymyksiin, jotka hyödyntävät kolmannen osapuolen sisältöä (esim. GitHub). Turvatiimimme sekä ulkopuolinen tarkastaja ovat arvioineet Turbopufferin, ja se on saanut SOC2 Type II -sertifikaatin. Lue lisää Turbopufferin tietoturvasta täältä →

Anna palautetta

Oliko tästä resurssista apua?