חברו את Slack לסביבת העבודה שלכם

מה תבנו

בסוף המדריך הזה יהיו לכם:

• אפליקציית Slack שנוצרה עבור סביבת העבודה שלכם, עם ההרשאות והאירועים הנכונים כבר מוגדרים
• חיבור חי בין Slack ל-Control Center
• חשבון ה-Slack שלכם מקושר למשתמש ה-Control Center שלכם
• סוכן שמשיב לכם בשרשור ב-Slack וכרטיס שנפתח מפקודת קו נטוי

דרישות מוקדמות:

• סביבת העבודה הראשונה שלכם ושילחו את הסוכן הראשון הושלמו — סביבת עבודה בלי סוכנים יכולה לקבל הודעת Slack אבל אין מי שישיב לה
• לסוכן ה־CEO של סביבת העבודה מוגדרים מתאם ומודל בהגדרות ← סביבת עבודה ← סוכנים. הגשר מעיר את ה־CEO, לא את הסוכן שהגדרתם במדריך הקודם, וסוכן בלי מתאם רץ על הלולאה המובנית עם מודל ברירת המחדל של Anthropic.
• תפקיד owner או admin בסביבת העבודה של Control Center (חיבור אפליקציית צ’אט מדבר בשם כל סביבת העבודה)
• הרשאה ליצור ולהתקין אפליקציות בסביבת העבודה שלכם ב-Slack

דבר כאן אינו דורש כתובת ציבורית, מנהרה או פורט נכנס. Control Center מחייג החוצה אל Slack דרך Socket Mode, כך שזה עובד ממחשב נייד מאחורי NAT.

שלב 1: השגת אסימון תצורה של אפליקציית Slack

זה הסוד היחיד שעליכם להשיג ביד. הוא מאפשר ל-Control Center ליצור ולאחר מכן לערוך את האפליקציה עבורכם.

1. פתחו את api.slack.com/apps
2. גללו אל הקטע של אסימוני תצורת האפליקציה בתחתית הדף
3. הפיקו זוג אסימונים עבור סביבת העבודה שלכם ב-Slack
4. העתיקו את אסימון הרענון — הוא מתחיל ב-xoxe-

שלב 2: תנו ל-Control Center ליצור את האפליקציה

1. ב-Control Center, עברו אל הגדרות ← סביבת עבודה ← כללי ומצאו את הכרטיס גשרי צ’אט
2. בבלוק Slack, לחצו על יצירת האפליקציה עבורי
3. הדביקו את אסימון תצורת האפליקציה
4. עברו על איך הבוט ייראה:
   • שם האפליקציה: איך Slack מציג את האפליקציה, למשל Control Center · Acme
   • שם הבוט: מה שאנשים מקלידים אחרי @, למשל control-center
   • תיאור קצר ומה הבוט אומר שהוא יודע לעשות
   • פקודת סלאש: cc כברירת מחדל, כך שהפקודה היא /cc
   • הודעות ישירות: השאירו דלוק כדי שחברים יוכלו לשלוח הודעה ישירה לבוט
5. לחצו על יצירת אפליקציה

Control Center מרכיב את כל הגדרת האפליקציה — Socket Mode דלוק, הרשאות הבוט ומנויי האירועים שהוא צריך, פקודת הסלאש, לשונית Messages — ויוצר אותה ב-Slack.

שלב 3: השלימו את שני השלבים שרק Slack יכול לבצע

ל-Slack אין API להפקת אסימון ברמת האפליקציה או להתקנת אפליקציה, ולכן תיבת הדו-שיח נותנת לכם את שניהם כקישורים:

1. יצירת אסימון גישה ברמת האפליקציה — פותח את Basic Information → App-Level Tokens. צרו אסימון עם ההרשאה connections:write והעתיקו אותו. הוא מתחיל ב-xapp-
2. התקנת האפליקציה — פותח את Install App. התקינו בסביבת העבודה שלכם, ואז העתיקו את הBot User OAuth Token. הוא מתחיל ב-xoxb-

שמרו את שני הערכים לקראת השלב הבא.

שלב 4: התחברות

1. חזרה בתיבת הדו-שיח, לחצו על הדבקת פרטי הגישה
2. הזינו את אסימון גישה של הבוט (xoxb-…) ואת אסימון גישה ברמת האפליקציה (xapp-…)
3. השאירו את אסימון גישה לתצורת האפליקציה ריק — זה משלב 1 כבר נשמר (Slack סיבב אותו ו-Control Center שמר את החדש)
4. לחצו על התחברות

Control Center מאמת את אסימון הבוט מול Slack לפני שהוא שומר משהו, ואז פותח את הסוקט. השורה מציגה כעת את שם הבוט ואת שם סביבת העבודה שלכם ב-Slack עם תג פעיל.

שלב 5: קישור חשבון ה-Slack שלכם

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

הקישור הוא אישי, ולכן הוא נמצא בדף אחר מזה של החיבור ברמת סביבת העבודה.

1. עברו אל הגדרות ← סביבת עבודה ← פרופיל וזהות ומצאו את הכרטיס חשבונות צ’אט מקושרים
2. לחצו על קישור חשבון ה-Slack שלי
3. העתיקו את הפקודה שמוצגת, למשל /cc link K7M2QP
4. ב-Slack, שלחו את הפקודה הזו לבוט בהודעה ישירה
5. הבוט משיב “מקושר — אתם …”

הקוד חד-פעמי ופג בתוך 15 דקות. אם כתובת האימייל שלכם ב-Slack תואמת למשתמש Control Center שכבר חבר בסביבת העבודה הזו, הגשר מקשר אתכם אוטומטית בפעם הראשונה שאתם מדברים איתו ותוכלו לדלג על השלב הזה.

אם אתם מזכירים את הבוט לפני שזה נעשה, הוא מסרב ואומר למה. שלושת הסירובים שונים זה מזה, ולכן קראו איזה מהם קיבלתם:

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

שלב 6: העמידו סוכן על משהו

1. ב-Slack, הזמינו את הבוט לערוץ: /invite @control-center

2. אזכרו אותו עם בקשה אמיתית:

   @control-center סכמו את בקשות המשיכה הפתוחות במאגר api

הגשר:

1. יוצר מרחב Control Center עבור שרשור ה-Slack הזה, בשם הערוץ ב-Slack והבקשה שלכם
2. מעיר את סוכן הכניסה של סביבת העבודה (סוכן ה־CEO כשיש כזה, אחרת הסוכן הראשון)
3. מזרים את תשובת הסוכן חזרה אל שרשור ה-Slack בזמן שהיא נכתבת

השיבו באותו שרשור ב-Slack כדי להמשיך — אין צורך באזכורים נוספים, כי השרשור ב-Slack מגושר כעת. לחלופין, שלחו הודעה ישירה לבוט במקום להשתמש בערוץ; כל שיחת הודעה ישירה מניעה מרחב Control Center משלה, עם כותרת ושורת מצב “חושב…” בזמן שהסוכן עובד.

הזרמה דורשת את ה-API של ההזרמה של Slack, שלא כל תוכנית כוללת אותו. אם האפליקציה שלכם נדחית ממנו, הגשר מפסיק לנסות עבור כל החיבור ומפרסם כל תשובה כהודעה אחת במקום, והכרטיס גשרי צ’אט מציג “הזרמה חיה כבויה לאפליקציית ה-Slack הזו — תשובות מגיעות כהודעה אחת.” כל השאר עובד באותה צורה.

שלב 7: פתחו כרטיס בלי לעזוב את Slack

/cc ticket Fix the flaky login test | It fails on CI about once a day.

הבוט משיב עם מפתח הכרטיס שפתח. הכרטיס הוא כרטיס Control Center מקומי רגיל, מדווח על ידכם, מוכן להאצה לסוכן. /cc help מפרט כל מה שהפקודה יכולה לעשות.

סיכום

יצרתם אפליקציית Slack מ-Control Center, חיברתם אותה דרך סוקט יוצא, קישרתם את זהות ה-Slack שלכם למשתמש ה-Control Center שלכם והנעתם סוכן משרשור ב-Slack. כל מה שקרה ב-Slack קיים גם ב-Control Center: השרשור ב-Slack הוא מרחב, התשובה היא תמלול, הכרטיס הוא כרטיס.

המשך: הגדרת אינטגרציית Slack מכסה את המסלול הידני, סיבוב אסימונים ופתרון תקלות. למודל שמתחת, קראו את גשרי צ’אט.