טריגרים לצוות
הפעילו סוכני Ingot מהמקום שבו הצוות כבר עוקב אחרי העבודה: הוסיפו תווית לנושא ב-GitHub, הזיזו כרטיס ב-Jira, הוסיפו תווית לנושא ב-Linear או הקלידו /ingot ב-Slack. Ingot עונה באותו שרשור עם קישור, התקדמות ותוצאה.
מה מפעיל סוכן
| כלי | אותות |
|---|---|
| GitHub | נושא או pull request מקבלים תווית (ברירת מחדל ingot), או שתגובה אומרת @ingot <task> |
| Jira | נושא עובר לעמודה (למשל Ready for agent), מקבל תווית, או שתגובה אומרת @ingot |
| Linear | נושא מקבל תווית, או שתגובה אומרת @ingot |
| Slack | /ingot <task>, או אזכור של אפליקציית Ingot שלכם בערוץ |
כל כלל בוחר אות אחד, את המאגר שבו הסוכן עובד ואיפה הוא רץ:
- סוכן בענן: ריצת Zaprex בחשבון של בעל הכלל. היא עובדת גם כשכל המחשבים סגורים, ופותחת pull request כשהיא משנה קוד.
- ה-Ingot של בעל הכלל: צ'אט חדש ב-Ingot הפועל של בעל הכלל (אפליקציית הדסקטופ או
ingot serve), דרך אותו חיבור ש-Ingot Remote משתמש בו. אם ה-Ingot שלו לא רץ, השרשור מקבל הודעה על כך ושום דבר לא מתחיל.
מה רואים בשרשור
- On it (מטפל בזה), עם קישור למעקב אחרי הריצה (ענן) או שם בעל הכלל (ה-Ingot שלו).
- אותה הודעה מתעדכנת ככל שהריצה מתקדמת. כשצעד מסוכן צריך אישור, הערה קצרה אומרת שהריצה ממתינה.
- Done (הושלם), עם הסיכום של הסוכן וקישור ל-pull request, או הסיבה שבגללה עצר.
ענו בשרשור כדי לכוון אותו. ב-GitHub, ב-Jira וב-Linear, הזכירו את @ingot בתשובה; ב-Slack, כל תשובה מתחת להודעה של Ingot נחשבת. תשובה מגיעה מיד לצ'אט שרץ ב-Ingot של בעל הכלל. ריצה בענן מקבלת אותה כריצת המשך ברגע שהריצה הנוכחית מסתיימת, עם הסיכום הקודם והתשובה שלכם.
הגדרה
צריך צוות (לוח הבקרה › צוות) ולהיות הבעלים או מנהל שלו. פתחו את לוח הבקרה › אינטגרציות › טריגרים.
GitHub
- לחצו חיבור בכרטיס של GitHub. הדביקו טוקן לתשובות: טוקן fine-grained עם Issues: Read and write על המאגרים, או טוקן התקנה מ-GitHub App משלכם. בלי טוקן הריצות עדיין מתחילות, אבל Ingot לא יכול להגיב.
- העתיקו את כתובת ה-webhook ואת סוד ה-webhook ש-Ingot מציג.
- ב-GitHub: Settings › Webhooks › Add webhook של המאגר (או הארגון). Payload URL: כתובת ה-webhook. Content type:
application/json. Secret: סוד ה-webhook. אירועים: Issues, Issue comments ו-Pull requests.
Jira
- לחצו חיבור בכרטיס של Jira ומלאו את כתובת האתר (
https://your-team.atlassian.net), את האימייל של החשבון ש-Ingot עונה בשמו, וטוקן API של החשבון הזה (id.atlassian.com › Security › API tokens). - העתיקו את כתובת ה-webhook ואת סוד ה-webhook.
- ב-Jira: Settings › System › WebHooks › Create a WebHook. URL: כתובת ה-webhook. Secret: סוד ה-webhook. אירועים: Issue updated ו-Comment created. אפשר לצמצם עם JQL (למשל
project = SHOP).
Linear
- לחצו חיבור בכרטיס של Linear. אפשר להדביק מפתח API של Linear לתשובות עכשיו (Settings › API › Personal API keys) או מאוחר יותר.
- העתיקו את כתובת ה-webhook.
- ב-Linear: Settings › API › Webhooks › New webhook. URL: כתובת ה-webhook. סוגי משאבים: Issues ו-Comments. Linear מציג signing secret.
- בחזרה ב-Ingot, לחצו עדכון פרטי גישה בכרטיס של Linear והדביקו את סוד החתימה. עד אז, הקריאות של Linear נדחות.
Slack
- לחצו חיבור בכרטיס של Slack והעתיקו את כתובת ה-webhook.
- צרו אפליקציית Slack לסביבת העבודה (api.slack.com/apps › Create New App › From a manifest) והדביקו את זה, עם כתובת ה-webhook בשני המקומות:
display_information:
name: Ingot
features:
bot_user:
display_name: Ingot
slash_commands:
- command: /ingot
url: <your Ingot webhook URL>
description: Start an Ingot agent
usage_hint: fix the flaky login test
oauth_config:
scopes:
bot:
- commands
- chat:write
- app_mentions:read
- channels:history
- groups:history
- users:read
- users:read.email
settings:
event_subscriptions:
request_url: <your Ingot webhook URL>
bot_events:
- app_mention
- message.channels
- message.groups
- התקינו את האפליקציה בסביבת העבודה. העתיקו את Signing Secret (Basic Information) ואת Bot User OAuth Token (
xoxb-…, OAuth & Permissions). - ב-Ingot, לחצו עדכון פרטי גישה בכרטיס של Slack והדביקו את שניהם. אם Slack אמר שה-Request URL לא אומת, פתחו את Event Subscriptions באפליקציה ולחצו Retry: Ingot עונה ברגע שסוד החתימה נשמר.
- הזמינו את האפליקציה לערוצים שבהם תרצו להשתמש בה (
/invite @Ingot).
הוספת כלל
לחצו הוספת כלל, בחרו מקור, שם ואות, ומלאו את התווית, העמודה או מילת האזכור (ברירת מחדל ingot). רק ב מצמצם כלל למאגר GitHub אחד (owner/name), למפתח פרויקט ב-Jira, למפתח צוות ב-Linear או למזהה ערוץ ב-Slack. בחרו את המאגר (אחד המאגרים שלכם ב-Zaprex) ואיפה הוא רץ, והוסיפו הנחיות לסוכן אם תרצו, למשל „שמרו על pull requests קטנים”.
המתג בעמודה פעיל מכבה ומדליק כלל בלי למחוק אותו.
מי יכול להפעיל סוכן
רק חברי הצוות שלכם. Ingot מזהה את מי שהוסיף את התווית, הגיב או הקליד את הפקודה:
- לפי חשבון מקושר (אינטגרציות › טריגרים › חשבונות מקושרים: מנהלים מקשרים כל אחד בצוות, חברים מקשרים את עצמם),
- לפי אימייל, כשהכלי משתף אותו (משתמשי Jira ו-Linear, פרופילי Slack עם אימייל גלוי),
- לפי הכניסה עם GitHub שלהם ב-Ingot.
כל השאר מקבלים סירוב מנומס בשרשור (ב-Slack, רק הם רואים אותו). שום דבר לא מתחיל.
בטיחות ומגבלות
- כל webhook חתום: GitHub ו-Jira עם הסוד ש-Ingot יצר, Slack עם סוד החתימה שלו, Linear עם סוד החתימה שלו וחותמת זמן. קריאות לא חתומות או חוזרות נדחות.
- webhook שנשלח שוב אף פעם לא מתחיל ריצה שנייה.
- טקסט מנושאים, מתגובות ומ-Slack מגיע לסוכן רק כתיאור המשימה, אף פעם לא כהנחיות שמשנות את הכללים שלו.
- הריצות משתמשות בתוכנית, בדקות ובמגבלות של בעל הכלל. צעדים מסוכנים עדיין ממתינים לאישור של בעל הכלל ב-Zaprex: אף אחד לא יכול לאשר משרשור. תקרות ההוצאה וההשהיה של המנהל חלות.
- מגבלות קצב: 6 הפעלות לאדם בכל 10 דקות, 30 למקור בשעה.
- התגובות של Ingot עצמו ובוטים אחרים אף פעם לא מתחילים או ממשיכים ריצה.
פתרון בעיות
| מה רואים | מה לעשות |
|---|---|
| שום דבר לא קורה | בדקו את משלוחי ה-webhook בכלי. 401 אומר שהסוד לא תואם; 503 אומר שהסוד עדיין לא נשמר ב-Ingot. ודאו שהכלל פעיל ושה-רק ב שלו תואם. |
| הריצה מתחילה אבל Ingot לא עונה | למקור אין טוקן תשובות, או שהטוקן לא יכול להגיב. הכרטיס אומר אין טוקן תשובות. |
| „Only members of … can start agents” | קשרו את החשבון של האדם תחת חשבונות מקושרים, או הזמינו אותו לצוות. |
| „…'s Ingot is not running right now” | הכלל רץ במחשב של בעל הכלל. הפעילו את ה-Ingot שלו, או העבירו את הכלל לסוכן בענן. |
| „Could not start an agent: …” | התוכנית, הדקות או הריצות במקביל של בעל הכלל נוצלו, או שמנהל השהה את הסוכנים. |
.ingot/automations/ מוסברות באוטומציות. טריגרים לצוות לא צריכים קבצים במאגר.