דברו עם Control Center מתוך PR ב-GitHub
המדריך הזה מראה איך לעבוד עם Control Center בלי לצאת מ-GitHub: לבקש סקירת AI מדף ה-PR, לשאול את הבוט שאלה בתגובה, ולהמשיך את השיחה בשרשורי הסקירה שלו.
התשובות מגיעות דרך נתיב ה-GitHub של סביבת העבודה: ה-GitHub App של השרת עצמו, או האפליקציה המשותפת של Control Center דרך Connect. לא נרשם שום דבר חדש, ואין צורך שמשהו יהיה נגיש מהאינטרנט: השרת מגלה מה נאמר ב-GitHub על ידי סריקה, כך שמחשב נייד מאחורי NAT מתנהג בדיוק כמו פריסה ציבורית.
דרישות מקדימות
קטע בשם “דרישות מקדימות”- לסביבת העבודה יש נתיב GitHub: ה-GitHub App של השרת או Connect, עם האפליקציה מותקנת על החשבון שהמאגר שייך לו. לאפליקציה משלכם נדרשות הרשאות Pull requests ו-Issues לקריאה וכתיבה, שכבר ניתנות על ידי יצירת אפליקציית GitHub שלי
- המאגר משויך לסביבת עבודה ב-Control Center
- אתם מחוברים ל-GitHub בשרת הזה, ויכולים לדחוף למאגר
- אין כתובת webhook, אין מנהרה, אין callback — אין מה להגדיר בצד הרשת
מצאו את שם הבוט שלכם
קטע בשם “מצאו את שם הבוט שלכם”הזכירו את @usectrl, חשבון ה-GitHub הייעודי של Control Center. זהו הטריגר היחיד: אזכור הכניסה של האפליקציה עצמה לא עושה דבר. נתיב ה-GitHub
של סביבת העבודה עדיין מטפל בבקשה ומפרסם תשובות. אינכם צריכים פרטי גישה לחשבון usectrl.
בקשת סקירה מתוך GitHub
קטע בשם “בקשת סקירה מתוך GitHub”שתי דרכים, ושתיהן מפעילות את אותו פייפליין pr_review שהכפתור שאל את ה-AI מפעיל:
- הוסיפו את התווית
ai-reviewל-PR. זה הקרוב ביותר שיש ב-GitHub להקצאת הבוט כסוקר, כי לחשבונות אפליקציות אין מקום של סוקר מבוקש מקורי. החשבון שלכם מגיב ל-PR ב-👀, והסקירה מתחילה ב-Control Center; לא מתפרסמת תגובה - הגיבו
@usectrl review(או רק@usectrl) בשיחת ה-PR. מופיע 👀 על התגובה שלכם, ואז תשובה מודיעה שהסקירה התחילה (או שכבר רצה אחת)
הסוקרים עובדים במרחב הסקירה של ה-PR; קראו את הממצאים ופרסמו אותם כמתואר ב-שימוש בסקירה מבוססת AI. פרסום חזרה ל-GitHub נשאר החלטה שאתם מקבלים ב-Control Center — הפעלת סקירה מ-GitHub לא מפרסמת דבר ב-GitHub מעצמה.
התווית מופעלת פעם אחת לכל PR: ההוספה שלה היא הבקשה, והיא אינה מופעלת מחדש כשמסירים ומוסיפים אותה שוב. כדי להריץ סקירה שוב — למשל אחרי דחיפה — הזכירו את הבוט.
שאלו שאלה
קטע בשם “שאלו שאלה”הגיבו בשיחת ה-PR:
@usectrl why does the flaky test in runner_test.dart fail on CI but not locally?מה קורה, לפי הסדר:
- מופיע 👀 על התגובה שלכם, מהחשבון שלכם, כך שאתם יודעים שהתגובה נראתה
- השאלה מפורסמת במרחב הסקירה של ה-PR בשמכם — אותו ייחוס כאילו הקלדתם אותה ב-Control Center
- סוכן עונה במרחב, והתשובה מפורסמת חזרה ב-PR. כל תשובה מתחילה ב-
**Control Center** (for @your-login):
שאלה על PR שאין לו עדיין סקירה מעירה את סוכן ה-CEO של סביבת העבודה; אחרי שסקירה רצה, הסוכן שדיבר אחרון עונה, כך שהמעקבים מגיעים למי שיש לו את ההקשר.
המשיכו בשרשור סקירה
קטע בשם “המשיכו בשרשור סקירה”הגיבו בתוך שרשור סקירה מוטבע ששייך לבוט — תגובת diff שהוא השאיר, או תשובה שפרסם באותו שרשור. לא צריך אזכור; השרשור הוא הכתובת:
> @usectrl the retry loop looks O(n²) to me
what would the complexity be with the bounded queue instead?שיחה רב־שלבית עובדת באותו אופן: כל תגובה היא שאלה נוספת באותה שיחה, עם מרחב הסקירה כהקשר, והתשובה חוזרת בשרשור.
מעקב בציר הזמן של שיחת ה-PR הוא תגובה חדשה ברמה עליונה, ולכן הוא עדיין צריך אזכור.
עם מי הבוט מדבר
קטע בשם “עם מי הבוט מדבר”השרת מזהה את מחבר התגובה, או את מי שהוסיף את התווית ai-review, לפני שהוא עושה דבר:
- חשבון ה-GitHub חייב להיות מחובר בשרת הזה. ההתאמה נעשית לפי מזהה החשבון המספרי של GitHub, לעולם לא לפי השם. היכנסו מהגדרות ← אישי ← פרופיל ← אחסון קוד
- חייב להיות חבר בתפקיד כתיבה (
member,adminאוowner) בסביבת העבודה שמקשרת את המאגר - חייב להיות מסוגל לדחוף למאגר ב-GitHub. תשובות משתמשות באסימון מוגבל להרשאות של אותו אדם, ולכן מי שיכול רק לקרוא לא מקבל תשובה
כל אחד אחר מתעלם בשקט: שום דבר לא מפורסם, והמילים שלו לעולם אינן נכנסות לסביבת העבודה. תגובות של בוטים, וגם התשובות של Control Center עצמו, לעולם אינן נחשבות לשאלות.
שני שרתים, PR אחד
קטע בשם “שני שרתים, PR אחד”ה-👀 הוא גם הדרך שבה שרתים מסכימים מי עונה. הוא נוסף עם הכניסה של המחבר עצמו, וה-GitHub מודיע לשרת אם התגובה הזו חדשה. אם אתם מחוברים בשני שרתי Control Center שמקשרים את המאגר, הראשון שמגיב עונה, והשני שותק. אותו דבר נכון לתווית.
למה לצפות
קטע בשם “למה לצפות”| דבר | התנהגות |
|---|---|
| אישור קבלה | 👀 מהחשבון שלכם על התגובה (או על ה-PR, עבור התווית), תוך סבב סריקה אחד |
| תשובות | מתפרסמות בנתיב שבו נשאלה השאלה, ומתחילות ב-**Control Center** (for @your-login):. המחבר הוא הבוט של האפליקציה. באפליקציה המשותפת של Connect, תשובה בתוך שרשור סקירה נכתבת מחשבונכם, אלא אם מפעיל Connect רשם את ההתקנה הזו |
| ייחוס במרחב | השאלה שלכם; הסוכן רץ בשמכם, תחת הגדרות האוטונומיה של המרחב |
| סקירות | הממצאים נכנסים למרחב הסקירה; הפרסום ל-GitHub הוא ידני |
סבב סריקה רץ כל דקה באפליקציה משלכם, ובודק עד 25 בקשות משיכה; דרך Connect הוא רץ כל שתי דקות ובודק עד 10, כי הקריאות האלה חולקות את מכסת ה-GitHub של כל חבר. סביבת עבודה שמכסת ה-GitHub שלה מתחת ל-15% מדולגת עד שהיא מתאוששת. ההשהיה היא המחיר של אי־צורך בתעבורה נכנסת לרשת בכלל. שום דבר לא אובד כשהשרת לא פועל — תגובה שמגיעה בזמן השבתה נתפסת בסבב הבא.
פתרון תקלות
קטע בשם “פתרון תקלות”שום דבר לא קורה לתגובה שמאזכרת את הבוט.
- האם האפליקציה מותקנת על החשבון שהמאגר שייך לו, והמאגר מקושר לסביבת עבודה? מאגר לא מקושר מדולג לפני שמשהו נרשם, כך שקישור מאוחר יותר עדיין מוביל לתשובה
- האם אתם מחוברים ל-GitHub בשרת הזה, חבר בתפקיד כתיבה, ומסוגלים לדחוף למאגר? השרת מתעלם מכל אחד אחר בלי להשיב
- עדיין כלום? יומן השרת מציין את הסבב ואת ה-PR כשמשהו נכשל; חפשו
pr_conversation:(הסורק) ו-github_pr_conversation:(הגשר)
התווית לא מתחילה סקירה.
התווית מופעלת פעם אחת לכל PR, והאדם שהוסיף אותה עובר את אותן בדיקות כמו מחבר תגובה. אם כבר רצה
סקירה, או שהתווית נוספה לפני שהשרת ראה את ה-PR בכלל (הסבב הראשון רושם את הצבר בשקט במקום להציף), הזכירו
את הבוט במקום זאת — @usectrl review תמיד מתחיל אחת, אלא אם סקירה כבר רצה.
תשובת הבוט לא הגיעה ל-GitHub.
התשובה עצמה לעולם אינה אובדת — היא נמצאת במרחב הסקירה של ה-PR ב-Control Center. כשל בפרסום (GitHub לא זמין, הרשאות שהשתנו) נרשם ביומן ואינו מנסה שוב; שאלו שוב בשרשור אם זה חשוב לכם.
מדריכים קשורים
קטע בשם “מדריכים קשורים”- יצירת GitHub App: הרישום שממנו הבוט נולד
- שימוש בסקירה מבוססת AI: קריאת הממצאים שסקירה שהופעלה באזכור מפיקה
- הגדרת אינטגרציית GitHub: חיבור חשבון ה-GitHub שלכם, שלפיו הבוט מזהה אתכם
- שימוש במרחבים: החדר שאליו כל זה נוחת