דלגו לתוכן

דברו עם 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.

שתי דרכים, ושתיהן מפעילות את אותו פייפליין 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?

מה קורה, לפי הסדר:

  1. מופיע 👀 על התגובה שלכם, מהחשבון שלכם, כך שאתם יודעים שהתגובה נראתה
  2. השאלה מפורסמת במרחב הסקירה של ה-PR בשמכם — אותו ייחוס כאילו הקלדתם אותה ב-Control Center
  3. סוכן עונה במרחב, והתשובה מפורסמת חזרה ב-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 עצמו, לעולם אינן נחשבות לשאלות.

ה-👀 הוא גם הדרך שבה שרתים מסכימים מי עונה. הוא נוסף עם הכניסה של המחבר עצמו, וה-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 לא זמין, הרשאות שהשתנו) נרשם ביומן ואינו מנסה שוב; שאלו שוב בשרשור אם זה חשוב לכם.