OpenAI
הדף הזה תורגם באופן אוטומטי. לצפייה במאמר המקורי באנגלית.

הגדרת תבנית האפליקציה של GitHub Enterprise ב-ChatGPT

למדו איך מנהלי workspace יכולים להגדיר את תבנית האפליקציה של GitHub Enterprise ב-ChatGPT באמצעות אפליקציית GitHub של הארגון שלהם.

עודכן: 25 days ago

סקירה כללית

מדריך זה מיועד למנהלי workspace ב-ChatGPT שמגדירים את תבנית האפליקציה של GitHub Enterprise עבור הארגון שלהם. התבנית אינה האפליקציה הסופית שבה משתמשים חברי ה-workspace. זהו תהליך הגדרה שיוצר טיוטת אפליקציה ייעודית ל-workspace לאחר שתספקו את הגדרות GitHub Enterprise הנדרשות.

במקרה של GitHub Enterprise, תהליך ההגדרה מחבר את ChatGPT אל מארח GitHub Enterprise של הארגון שלכם. יוצרים אפליקציית GitHub, רושמים את כתובת החזרה של ChatGPT, יוצרים פרטי אימות ואז מדביקים את הערכים האלה בתהליך הגדרת התבנית ב-ChatGPT. לאחר ש-ChatGPT יוצר את טיוטת האפליקציה, אפשר לפרסם ולנהל אותה כמו אפליקציות אחרות ב-workspace.

למידע על ניווט ב-workspace ועל גישה לאפליקציות, ראו: בקרות מנהל, אבטחה ותאימות עבור תוספים ואפליקציות.

מה מגדירים

אתם יוצרים ב-ChatGPT אפליקציית GitHub Enterprise ייעודית ל-workspace. האפליקציה משתמשת ברכיבים הבאים:

  • אפליקציית GitHub שרשומה במארח GitHub Enterprise שלכם.

  • מזהה הלקוח וסוד הלקוח של אפליקציית GitHub, לצורך קבלת הרשאת משתמש באמצעות OAuth.

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

  • סוד webhook וכתובת webhook, כדי ש-GitHub Enterprise יוכל לשלוח בחזרה ל-ChatGPT אירועי התקנה ומאגר.

  • שם המארח של GitHub Enterprise שלכם, למשל github.example.com.

צרו אפליקציית GitHub, ולא אפליקציית OAuth עצמאית של GitHub. הגדרת התבנית ב-ChatGPT דורשת פרטי אימות של אפליקציית GitHub, מפתח פרטי והגדרות webhook.

לפני שמתחילים

תצטרכו:

  • הרשאת מנהל או בעלים של workspace ב-ChatGPT.

  • הרשאת מנהל GitHub Enterprise או בעלים של ארגון, שמאפשרת ליצור ולהתקין אפליקציות GitHub.

  • שם המארח של GitHub Enterprise בלבד, ללא https:// או נתיב.

  • החלטה באילו פעולות במאגרים ChatGPT אמור לתמוך, למשל חיפוש במאגרים לקריאה בלבד, תהליכי עבודה של pull request, תהליכי עבודה של סוגיות, עריכת קבצים, GitHub Actions או תהליכי עבודה רחבים יותר עם Codex.

  • מקום מאובטח לטיפול במפתח הפרטי ובסוד הלקוח של אפליקציית GitHub.

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

ערכים שכדאי להכין

  • שם המארח של GitHub Enterprise: למשל, github.example.com.

  • כתובת חזרה: העתיקו אותה מתוך תהליך הגדרת התבנית ב-ChatGPT.

  • מזהה הלקוח של אפליקציית GitHub.

  • סוד הלקוח של אפליקציית GitHub.

  • המפתח הפרטי של אפליקציית GitHub בפורמט PEM.

  • סוד webhook שנוצר על ידי ChatGPT.

  • כתובת webhook שנוצרת לאחר יצירת טיוטת האפליקציה ב-ChatGPT.

התחלת הגדרת התבנית ב-ChatGPT

  1. ב-ChatGPT, עברו ל-workspace שבו האפליקציה אמורה להיות זמינה.

  2. פתחו את הגדרות ה-workspace > אפליקציות. אפשר גם לעבור אל מסוף הניהול, לבחור את ה-workspace הרצוי ב-ChatGPT ולפתוח את תוספים. בחרו באפשרות ניהול אפליקציות מהדור הקודם כדי לפתוח את דף האפליקציות שנשמר מהגרסה הקודמת.

  3. בחרו באפשרות קטלוג.

  4. חפשו את GitHub Enterprise.

  5. בחרו בתבנית האפליקציה של GitHub Enterprise והתחילו בהגדרה.

  6. הזינו שם ותיאור ברורים לאפליקציה, למשל GitHub Enterprise או GitHub Enterprise - הנדסה.

  7. הזינו את שם המארח של GitHub Enterprise, למשל github.example.com.

  8. העתיקו את כתובת החזרה שמוצגת ב-ChatGPT. השאירו את הכרטיסייה הזו פתוחה.

  9. העתיקו את סוד ה-webhook שנוצר, אם הוא מוצג במהלך ההגדרה.

כתובת חזרה לדוגמה: https://chatgpt.com/connector/oauth/<callback_id>

אין להסיר את מזהה החזרה, להוסיף לוכסן בסוף הכתובת או להחליף אותה בכתובת כללית של ChatGPT.

יצירת אפליקציית GitHub ב-GitHub Enterprise

  1. פתחו את מארח GitHub Enterprise שלכם, למשל https://github.example.com.

  2. עברו לארגון או לחשבון שאמורים להיות הבעלים של האפליקציה.

  3. פתחו את הגדרות > הגדרות מפתחים > אפליקציות GitHub.

  4. בחרו באפשרות אפליקציית GitHub חדשה.

  5. הזינו שם ברור לאפליקציה, למשל ChatGPT GitHub Enterprise.

  6. הזינו כתובת של דף בית. אם אין דף פנימי ייעודי, השתמשו בכתובת הארגון ב-GitHub Enterprise.

  7. בשדה כתובת חזרה, הדביקו את כתובת החזרה המדויקת שהעתקתם מ-ChatGPT.

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

  9. הפעילו את האפשרות לבקש הרשאת משתמש במהלך ההתקנה, כדי שמשתמשים יוכלו להעניק הרשאה לאפליקציה במהלך ההתקנה או החיבור.

  10. תחת השאלה ״היכן אפשר להתקין את אפליקציית GitHub הזו?״, בחרו באפשרות המצומצמת ביותר שמתאימה להיקף הפריסה שלכם.

  11. צרו את אפליקציית GitHub.

הגדרת הרשאות ואירועים

בחרו את ההרשאות המינימליות הנדרשות לפעולות שברצונכם לאפשר ב-ChatGPT.

לאיתור מאגרים ולשאלות ותשובות במצב קריאה בלבד, התחילו בהרשאות קריאה כגון:

  • מטא-נתונים: קריאה בלבד. GitHub מחייב מתן גישה למטא-נתונים לאפליקציות GitHub.

  • תוכן: קריאה בלבד, לצורך גישה לתוכן הקבצים והמאגרים.

  • סוגיות: קריאה בלבד, אם נדרשים חיפוש או קריאה של סוגיות.

  • Pull requests: קריאה בלבד, אם נדרש חיפוש pull request או מידע לצורך סקירת קוד.

  • פעולות: קריאה בלבד, אם נדרשים סטטוס הרצה של תהליך עבודה, משימות, יומנים או תוצרי הרצה.

לתהליכי עבודה הכוללים כתיבה, הוסיפו הרשאות כתיבה רק היכן שנדרש, למשל לתוכן, Pull requests, סוגיות, פעולות או תהליכי עבודה. השתמשו בהרשאות המצומצמות ביותר שמאפשרות את הפעולות הרצויות ב-ChatGPT.

אירועי ה-webhook צריכים להתאים לתהליכי העבודה שאתם תומכים בהם. אירועים נפוצים כוללים התקנה, מאגרי התקנה, דחיפת קוד, Pull request, סוגיות, תגובה לסוגיה, הרצת תהליך עבודה ומשימה בתהליך עבודה.

יצירה והעתקה של פרטי האימות של אפליקציית GitHub

  1. בהגדרות של אפליקציית GitHub, העתיקו את מזהה הלקוח.

  2. צרו סוד לקוח והעתיקו אותו מיד.

  3. תחת מפתחות פרטיים, צרו מפתח פרטי.

  4. הורידו את קובץ ה-.pem ושמרו אותו במקום מאובטח.

  5. פתחו את קובץ ה-.pem במחשב שלכם והעתיקו את טקסט ה-PEM במלואו, כולל שורות הפתיחה והסיום.

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

השלמת ההגדרה ב-ChatGPT

  1. חזרו לכרטיסיית הגדרת התבנית ב-ChatGPT.

  2. הדביקו את מזהה הלקוח של אפליקציית GitHub בשדה מזהה לקוח OAuth.

  3. הדביקו את סוד הלקוח של אפליקציית GitHub בשדה סוד לקוח OAuth.

  4. השאירו את היקפי ההרשאה ללא שינוי, אלא אם הארגון שלכם צריך במכוון לחרוג מברירות המחדל של התבנית.

  5. ודאו שבשדה שם המארח של GitHub Enterprise מופיע רק שם מארח, למשל github.example.com.

  6. הדביקו או העלו את המפתח הפרטי של אפליקציית GitHub בפורמט PEM בשדה המפתח הפרטי של אפליקציית GitHub.

  7. ודאו שסוד ה-webhook שנוצר מופיע.

  8. צרו את טיוטת האפליקציה.

  9. פתחו ב-ChatGPT את פרטי טיוטת האפליקציה שנוצרה והעתיקו את כתובת ה-webhook שנוצרה.

כתובת ה-webhook אמורה להיראות כך: https://connectors.api.openai.org/connectors/<connector_id>/webhook

השלמת הגדרת ה-webhook ב-GitHub Enterprise

  1. חזרו להגדרות של אפליקציית GitHub ב-GitHub Enterprise.

  2. פתחו את ההגדרות הכלליות של אפליקציית GitHub.

  3. הפעילו את האפשרות ל-webhooks פעילים אם היא עדיין לא מופעלת.

  4. הדביקו את כתובת ה-webhook של ChatGPT בשדה כתובת webhook.

  5. הדביקו את סוד ה-webhook של ChatGPT בשדה סוד webhook.

  6. השאירו את אימות SSL מופעל.

  7. ודאו שאירועי ה-webhook שנרשמתם לקבלת עדכונים עליהם תואמים להרשאות ולפעולות שהפעלתם.

  8. שמרו את השינויים.

פרסום האפליקציה וניהולה ב-ChatGPT

יצירת טיוטת האפליקציה אינה הופכת אותה לזמינה אוטומטית לחברי ה-workspace. לאחר בדיקת הטיוטה:

  1. פרסמו את טיוטת האפליקציה.

  2. בהגדרות ה-workspace, פתחו את דף האפליקציות, פתחו את מופעלות וודאו שהאפליקציה מופיעה. אפשר גם לפתוח את דף האפליקציות דרך ניהול אפליקציות מהדור הקודם במסוף הניהול > תוספים.

  3. ב-Enterprise וב-Edu, השתמשו באפשרות גישת משתמשים כדי לבחור אילו תפקידים יוכלו להשתמש באפליקציה. ב-Business, נהלו את זמינות האפליקציה בכל ה-workspace.

  4. בדקו את בקרת הפעולות עבור פעולות קריאה וכתיבה.

  5. בדקו את הרשאות האפליקציה כדי לבחור מתי ChatGPT יבקש אישור מחברי ה-workspace לפני השימוש באפליקציה.

  6. בקשו ממשתמש בדיקה בעל הרשאה לפתוח את אפליקציות ב-ChatGPT ולוודא שהאפליקציה מופיעה.

הרשאות האפליקציה האלה חלות על שיחות ב-ChatGPT. סוכני workspace משתמשים בבקרות נפרדות לכל סוכן, שמגדיר יוצר הסוכן, כדי לקבוע אילו פעולות באפליקציות זמינות ומתי משתמשי הקצה מתבקשים לאשר אותן. למידע על התנהגות סוכנים, ראו: סוכני workspace ב-ChatGPT עבור Enterprise ו-Business.

התקנה ובדיקה של אפליקציית GitHub

  1. ב-GitHub Enterprise, התקינו את אפליקציית GitHub בארגון או בחשבון.

  2. בחרו את כל המאגרים או מאגרים מסוימים בהתאם למדיניות ה-workspace.

  3. התחילו את תהליך החיבור מתוך ChatGPT באמצעות משתמש בעל הרשאה.

  4. העניקו הרשאה לאפליקציית GitHub כשתתבקשו לעשות זאת.

  5. התחילו בפעולת קריאה קטנה, למשל הצגת רשימת המאגרים הנגישים או שליפת pull request מוכר.

  6. אם פעולות כתיבה מופעלות, בדקו אותן במאגר בסיכון נמוך לפני הרחבת השימוש.

שם המארח ואופן הפעולה של OAuth

ChatGPT משתמש בשם המארח כדי לקבוע את נקודות הקצה של GitHub Enterprise. הזינו רק את שם המארח, למשל github.example.com או octocorp.ghe.com.

אין להזין נתיב API, נתיב מאגר או github.com, אלא אם זהו מארח GitHub Enterprise המדויק של האפליקציה הזו.

פתרון בעיות

  • אי-התאמה ב-URI להפניה מחדש: ודאו שכתובת החזרה של אפליקציית GitHub זהה בדיוק לכתובת החזרה שמוצגת ב-ChatGPT.

  • ChatGPT לא מצליח ליצור או לשמור את טיוטת האפליקציה: ודאו שכל שדות החובה מולאו, כולל שם מארח, מזהה לקוח OAuth, סוד לקוח OAuth, מפתח פרטי וסוד webhook.

  • האימות מצליח אך הקריאות למאגר נכשלות: ודאו שאפליקציית GitHub מותקנת ושיש לה גישה למאגר.

  • ה-API מחזיר שגיאת 403 או הודעה על הרשאות לא מספיקות: הוסיפו את ההרשאה החסרה לאפליקציית GitHub ובקשו מבעלי ההתקנה לאשר את ההרשאות המעודכנות אם תופיע בקשה לכך.

  • לא מופיעים מאגרים: ודאו שהתקנת האפליקציה כוללת את המאגרים הצפויים ושהמשתמש שמעניק הרשאה ב-ChatGPT יכול לגשת אליהם.

  • שליחת הודעות ה-webhook נכשלת: ודאו שכתובת ה-webhook וסוד ה-webhook תואמים לערכים מ-ChatGPT, השאירו את אימות SSL מופעל וודאו שמארח GitHub Enterprise יכול להגיע אל connectors.api.openai.org.

  • שגיאות במפתח הפרטי: ודאו שכל תוכן ה-PEM הועתק, כולל שורות הפתיחה והסיום.

האם המאמר הזה היה מועיל?