מחבר AI של GitHub

במסמך העזרה הזה

כיצד ניתן לפתוח את הידע שלך ב-GitHub ב-Notion AI 🤖

מעבר לשאלות הנפוצות

הערה: תכונה זו זמינה בתוכניות Business ו-Enterprise בלבד.

לחבר את GitHub ל-Notion AI

מי יכול לחבר את GitHub ל-Notion AI?

עליכם להיות בעלי ארגון ב-GitHub ובעלי סביבת עבודה ב-Notion.
סביבת העבודה שלכם חייבת להיות בתוכנית Business או בתוכנית Enterprise ולהכיל יותר מחבר אחד.

לאחר הגדרת מחבר AI של GitHub לסביבת העבודה, חברים יכולים להשתמש באינטגרציה כדי לקבל תשובות:

מאגרים ציבוריים: אין צורך באימות נוסף לאחר הגדרת מחבר AI הראשונית על ידי בעלים.
מאגרים פרטיים: כל חבר חייב להתחבר ולבצע אימות מול GitHub כדי לאמת את גישתו.

איך מחברים את GitHub?

ישנן שתי דרכים שונות לחבר את GitHub ל-Notion AI. כדי לחבר את ארגון ה-GitHub, עליכם להיות בעלי סביבת עבודה וגם בעלי ארגון ב-GitHub. כדי לחבר מאגרים פרטיים, ניתן להיות חבר בסביבת העבודה.

אם אתם בעלי סביבת עבודה ב-Notion ובעלי GitHub:

כדי לחבר את GitHub לסביבת העבודה שלכם ב-Notion:

עוברים אל הגדרות ← Notion AI.
יש לבחור ב-+ לצד GitHub.
תועברו ל-GitHub. ודאו שאתם מחוברים לחשבון ה-GitHub הנכון. אל תסגרו את Notion במהלך תהליך ההגדרה!
בדף שייפתח, התחברו ל-GitHub ובחרו את הארגון שברצונכם לסנכרן. שימו לב שאם ברצונכם לחבר מאגר GitHub אישי, עליכם ליצור תחילה ארגון ולאחר מכן להעביר את המאגר לארגון.
יש לבחור ב-All repositories (מומלץ) או ב-Select repositories, ולאחר מכן לבחור ב-Install.
חזרו ל-Notion.

לאחר הגדרת האינטגרציה, היא תוכל לאנדקס PRs ו-issues החל משנה לפני השלמת ההגדרה. כמו כן, תהיה לכם גישה לכל קבצי הקוד, כולל קבצי markdown ו-README, ללא הגבלת זמן.

הערה: נכון לעכשיו, ויקי ו-מאגרים מפוצלים (forked repositories) אינם נתמכים.

השלמת החיבור עשויה להימשך עד 72 שעות. לאחר מכן, כל משתמש בסביבת העבודה שלכם ב-Notion חייב לבצע אימות מול GitHub בנפרד כדי להשתמש באינטגרציה, וההרשאות שלו ימופו בהתאם.

אם אתם חברים בסביבת עבודה ב-Notion:

אם אינכם הבעלים של סביבת העבודה ב-Notion או של ארגון ה-GitHub שלכם, תצטרכו מהבעלים לחבר את Notion ל-GitHub לפני שתוכלו להשתמש באינטגרציה. לאחר שהאינטגרציה הוגדרה על ידי הבעלים, תצטרכו להתחבר כדי לחבר את המאגרים הפרטיים שלכם. כדי לעשות זאת:

ב-Notion, פתחו את Notion AI בתחתית המסך ולחצו על ••• → Connect GitHub.
בחרו ב-Log In (יומן כניסה) וחברו את חשבון ה-GitHub שלכם.

איזה תוכן מ-GitHub ניתן לחבר ל-Notion AI?

לאחר שהוגדר מחבר AI לסביבת העבודה, הוא יכול לאנדקס קוד, PRs, Issues, קבצים ו-READMEs.

כל משתמש יוכל להשתמש ב-Notion AI רק כדי לראות ולחפש תוכן שיש לו גישה אליו ב-GitHub. Notion AI יכול לאחזר מידע מהשנה האחרונה מתוך PRs.

היכן ניתן להשתמש במחבר AI של GitHub שלי?

ניתן לחפש ב-GitHub דרך מחברי AI של Notion במקומות הבאים:

צ'אט ה-Notion AI בפינה הימנית התחתונה של Notion.
ווידג'ט ה-Notion AI בחלק העליון של בית.
Search בסרגל הצד שלכם.

ניתן לצמצם את החיפוש ל-GitHub בלבד על ידי פתיחת ה-רשימה הנפתחת All sources בצ'אט וב-בית ובחירה ב-GitHub. ניתן גם לסנן תוצאות Search של Notion AI כדי להציג מידע מ-GitHub בלבד.

שיטות עבודה מומלצות ודוגמאות להנחיות (prompts)

מחבר AI של GitHub הוא שימושי ביותר עבור:

שאילתות לגבי שינויים אחרונים ועדכוני פרויקטים.
מציאת מימושי קוד.
חיפוש בעיות (issues) והסטטוס שלהן.
פתרון באגים בבעיות. לדוגמה, ניתן לקבל הקשר כאשר תכונות אינן פועלות או מציגות שגיאות על ידי קריאת PRs אחרונים.
מציאת דפוסי אבטחה.

ניתן לנסות לבקש מ-Notion AI את הדברים הבאים:

"מה חדש ב-{project name}?"
"על אילו בקשות משיכה (pull requests) עבדנו במהלך השבוע האחרון?"
"מהם השינויים האחרונים במערכת האימות שלנו?"
להציג דוגמאות לאופן שבו אנו מטמיעים טיפול בשגיאות בבסיס הקוד שלנו.
"מהן התלויות העיקריות המשמשות ברכיבי ה-frontend שלנו?"
מציאת מימושים של פונקציות העברת מאגר ידע.
"אילו דפוסי אבטחה אנחנו משתמשים עבור נקודות קצה של API?"

מידע נוסף

שאלות נפוצות

חיברתי את סביבת העבודה הלא נכונה של Notion. כיצד אוכל לנתק את מאגר ה-GitHub שלי?

בעלי סביבת עבודה יכולים לנתק או לערוך ערוצים לאחר השלמת האינטגרציה הראשונית על ידי מעבר אל הגדרות → Notion AI. בחר ⚙️ לצד GitHub → הגדרות → ניתוק.

כמה זמן לוקח לאינטגרציה להסתיים?

הגדרת האינטגרציה עשויה להימשך עד 72 שעות, בהתאם לגודל המאגר ולסוג תוכנית ה-GitHub.

כמה זמן לוקח לתוכן חדש ב-GitHub להשתקף ב-Notion AI?

לאחר ההגדרה הראשונית, ייתכן שיחלפו עד 3 שעות עד שנתונים חדשים יאונדקסו על ידי Notion AI. נפחי נתונים גדולים יותר עשויים לדרוש זמן נוסף.

האם כולם בסביבת העבודה שלי ב-Notion יכולים לגשת למידע מ-GitHub?

חברים בסביבת עבודה חייבים לבצע אימות ולהתחבר בנפרד כדי לאחזר מידע ממאגרים פרטיים שלגביהם כבר יש להם גישה ב-GitHub.

עד כמה אחורה אני יכול לשאול שאלות לגבי GitHub?

ניתן לאחזר עד שנה אחת של PRs ונושאים במאגר שלהם. כל קבצי ה-README יהיו זמינים ללא כל הגבלת זמן.

למה ל-Notion AI יש גישה?

במהלך תהליך ההצטרפות, לאחר שתבחר את ארגון ה-GitHub שברצונך לחבר, תוכל לבחור אם ל-Notion AI תהיה גישה ל:

כל המאגרים: זה חל על כל המאגרים הנוכחיים והעתידיים שבבעלות בעל המשאב. כולל גם מאגרים ציבוריים (לקריאה בלבד).
רק מאגרים נבחרים: בחר לפחות מאגר אחד. כולל גם מאגרים ציבוריים (לקריאה בלבד).

האם מחברי (Connectors) Notion AI מכבדים הרשאות Notion AI קיימות?

בהחלט. Notion AI יכבד את ההרשאות הקיימות בהתאם ל-נהלי האבטחה של Notion AI הקיימים שלנו. משתמשים לא יוכלו ליצור תוכן או לקבל תשובות מ-Notion AI המבוססות על משאבי צד שלישי שאין להם גישה אליהם.

באופן ספציפי לתוכן של צד שלישי, Notion AI מטפל בתוכן פרטי וציבורי תוך מחשבה על אבטחה, ומעבד תוכן רק בהתאם למיפוי ההרשאות בין משתמשי GitHub ל-Notion.

כיצד Notion AI מטפל במיפוי הרשאות?

משתמשים יראו ב-Notion AI רק תוכן של GitHub (למשל, קוד, PRs, בעיות) שיש להם אישית הרשאה לגשת אליו ב-GitHub. גם אם מישהו ינסה לשאול על מאגר שאין לו גישה אליו ב-GitHub, Notion AI לא יחזיר תוצאות מאותו מאגר.

עליך להיות חבר גם ב-GitHub וגם ב-Notion כדי לאמת אפליקציה זו ברמת המשתמש.
משתמשים אינם צריכים להשתמש באותה כתובת אימייל ב-Notion וב-GitHub.
ההרשאות ממופות על סמך אימות מוצלח של כל משתמש עם חשבון ה-GitHub שלו, ולא על ידי השוואת כתובות אימייל. Notion AI מסתמך על התחברות OAuth כדי לאשר זהות והיקף הרשאות - לא על התאמת אימייל.
אנו מסנכרנים הרשאות מ-GitHub בכל שעה ומעדכנים את ההרשאות ב-Notion בהתאם.

כיצד Notion מאחסן או מתייחס לנתוני ה-GitHub שלי במערכות שלו?

בדומה למוצר ה-Notion AI המרכזי שלנו, אנו יוצרים ומאחסנים הטמעות (embeddings) במאגר ידע וקטורי המתארח על ידי Turbopuffer, המאפשר לספק תשובות לשאלות הממנפות תוכן של צד שלישי (למשל, GitHub).‏ Turbopuffer נבדקה על ידי צוות האבטחה שלנו וכן על ידי מבקר חיצוני כדי לקבל את הסמכת SOC2 Type II שלה. למידע נוסף על האבטחה של Turbopuffer כאן →