Slack összekötése a munkaterülettel

Mit fog felépíteni

Az oktatóanyag végére a következőkkel fog rendelkezni:

• A munkaterületéhez létrehozott Slack-alkalmazás, a megfelelő jogosultságokkal és a már beállított eseményekkel
• Élő kapcsolat a Slack és a Control Center között
• Az Ön Slack-fiókja összekapcsolva a Control Center-felhasználójával
• Egy ügynök, amely válaszol Önnek a Slack-szálban, és egy slash-parancsból létrehozott jegy

Előfeltételek:

• Az első munkaterületed és Az első ügynök indítása kész van — egy ügynök nélküli munkaterület fogadhat Slack-üzenetet, de nincs senki, aki válaszoljon rá
• A munkaterület CEO-ügynökének van adaptere és modellje a Beállítások → Munkaterület → Ügynökök helyen. A híd a CEO-t ébreszti fel, nem az előző oktatóanyagban beállított ügynököt, és az adapter nélküli ügynök a beépített cikluson fut az Anthropic alapértelmezett modelljével.
• Az owner vagy admin szerepkör a Control Center-munkaterületen (egy csevegőalkalmazás csatlakoztatása az egész munkaterület nevében szól)
• Jogosultság alkalmazások létrehozásához és telepítéséhez a Slack-munkaterületen

Itt semmihez nem kell nyilvános cím, alagút vagy bejövő port. A Control Center a Socket Mode-on keresztül kifelé tárcsáz a Slackhez, így ez egy NAT mögötti laptopról is működik.

1. lépés: Szerezzen be egy Slack-alkalmazáskonfigurációs tokent

Ez az egyetlen titok, amelyet kézzel kell beszereznie. Segítségével a Control Center létrehozza, majd később szerkeszti is az alkalmazást az Ön számára.

1. Nyissa meg az api.slack.com/apps oldalt
2. Görgessen az oldal alján lévő alkalmazáskonfigurációs tokenek szakaszig
3. Generáljon egy tokenpárt a Slack-munkaterületéhez
4. Másolja ki a refresh tokent — xoxe- előtaggal kezdődik

2. lépés: Hagyja, hogy a Control Center létrehozza az alkalmazást

1. A Control Centerben lépjen a Beállítások → Munkaterület → Általános oldalra, és keresse meg a Csevegőhidak kártyát
2. A Slack blokkon kattintson az Alkalmazás létrehozása helyettem elemre
3. Illessze be az alkalmazáskonfigurációs tokent
4. Tekintse át, hogyan fog kinézni a bot:
   • Alkalmazás neve: ahogyan a Slack listázza az alkalmazást, például Control Center · Acme
   • Bot neve: amit a tagok a @ után gépelnek, például control-center
   • Rövid leírás és Mit mond a bot, hogy mire képes
   • Slash parancs: alapértelmezés szerint cc, így a parancs a /cc
   • Közvetlen üzenetek: hagyja bekapcsolva, hogy a tagok közvetlen üzenetet küldhessenek a botnak
5. Kattintson az Alkalmazás létrehozása elemre

A Control Center összeállítja a teljes alkalmazásdefiníciót — a bekapcsolt Socket Mode-ot, a bot által igényelt hatóköröket és eseményfeliratkozásokat, a slash-parancsot, az Messages lapot —, és létrehozza az alkalmazást a Slackben.

3. lépés: Végezze el a két lépést, amelyet csak a Slack tud megtenni

A Slacknek nincs API-ja alkalmazásszintű token generálásához vagy alkalmazás telepítéséhez, ezért a párbeszédablak mindkettőt hivatkozásként adja át Önnek:

1. Alkalmazásszintű token generálása — megnyitja a Basic Information → App-Level Tokens oldalt. Hozzon létre egy tokent a connections:write hatókörrel, és másolja ki. xapp- előtaggal kezdődik
2. Az alkalmazás telepítése — megnyitja az Install App oldalt. Telepítse a munkaterületére, majd másolja ki a Bot User OAuth Token értékét. xoxb- előtaggal kezdődik

Tartsa meg mindkét értéket a következő lépéshez.

4. lépés: Csatlakoztatás

1. A párbeszédablakban visszatérve kattintson a Hitelesítő adatok beillesztése elemre
2. Adja meg a Bot token (xoxb-…) és az Alkalmazásszintű token (xapp-…) értékét
3. Hagyja üresen az Alkalmazáskonfigurációs token mezőt — az 1. lépésben megadott érték már el van tárolva (a Slack rotálta, a Control Center pedig elmentette az újat)
4. Kattintson a Csatlakozás elemre

A Control Center a Slackkel ellenőrzi a bot tokent, mielőtt bármit tárolna, majd megnyitja a socketet. A sor most a bot nevét és a Slack-munkaterülete nevét mutatja egy Élő címkével.

5. lépés: Kapcsolja össze a saját Slack-fiókját

A kapcsolat teszi a botot elérhetővé; az összekapcsolás teszi Önt felismerhetővé. Amíg a Slack-identitása nincs összekapcsolva, a bot nem cselekszik az üzeneteire — soha nem rendel egy üzenetet ahhoz, aki az alkalmazást telepítette.

Az összekapcsolás személyes, ezért más oldalon él, mint a munkaterület szintű kapcsolat.

1. Lépjen a Beállítások → Munkaterület → Profil és identitás oldalra, és keresse meg az Összekapcsolt csevegőfiókok kártyát
2. Kattintson A Slack fiókom összekapcsolása elemre
3. Másolja ki a megjelenített parancsot, például /cc link K7M2QP
4. A Slackben küldje el ezt a parancsot a botnak közvetlen üzenetben
5. A bot ezt válaszolja: „Linked — you are …”

A kód egyszer használatos, és 15 perc múlva lejár. Ha a Slack-e-mail-címe egy olyan Control Center-felhasználóhoz tartozik, aki már tagja ennek a munkaterületnek, a híd az első beszélgetés alkalmával automatikusan összekapcsolja Önt, és kihagyhatja ezt a lépést.

Ha ezelőtt megemlíti a botot, az elutasítja, és megindokolja, miért. A három elutasítás különbözik, ezért olvassa el, melyiket kapta:

• Nem összekapcsolt feladó: a bot elmondja, hogyan kapcsolhatja össze. Térjen vissza ehhez a lépéshez.
• Összekapcsolva, de nem tagja ennek a munkaterületnek: kérje meg egy admint, hogy hívja meg Önt.
• Csak olvasható szerepkörű tag (viewer vagy guest): a bot nem indít munkát az Ön nevében.

6. lépés: Adjon munkát egy ügynöknek

1. A Slackben hívja meg a botot egy csatornába: /invite @control-center

2. Említse meg egy valódi kéréssel:

   @control-center foglalja össze az api repóban nyitott PR-eket

A híd:

1. Létrehoz egy Control Center-teret ehhez a Slack-szálhoz, elnevezve a Slack-csatornáról és az Ön kéréséről
2. Felébreszti a munkaterület belépési ügynökét (a CEO-ügynököt, ha van, egyébként az első ügynököt)
3. A Slack-szálba streameli vissza az ügynök válaszát, ahogy az íródik

Válaszoljon ugyanabban a Slack-szálban a folytatáshoz — további említés nem kell, mert a Slack-szál most már át van hidalva. Vagy küldjön közvetlen üzenetet a botnak csatorna helyett; minden közvetlen beszélgetés a saját Control Center-terét vezérli, címmel és egy „is thinking…” állapotsorral, amíg az ügynök dolgozik.

A streameléshez a Slack streamelő API-jára van szükség, amellyel nem minden csomag rendelkezik. Ha az alkalmazásától megtagadják, a híd a teljes kapcsolat idejére felhagy a próbálkozással, és minden választ egyetlen üzenetként tesz közzé, a Csevegőhidak kártya pedig ezt írja: „Az élő streamelés ki van kapcsolva ehhez a Slack-alkalmazáshoz — a válaszok egy üzenetként érkeznek.” Minden más ugyanúgy működik.

7. lépés: Jegy létrehozása a Slack elhagyása nélkül

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

A bot a létrehozott jegy kulcsával válaszol. A jegy egy közönséges helyi Control Center-jegy, amelyet Ön jelentett be, és készen áll arra, hogy ügynökhöz rendeljék. A /cc help listázza mindazt, amit a parancs tud.

Összefoglaló

Létrehozott egy Slack-alkalmazást a Control Centerből, csatlakoztatta egy kifelé irányuló socketen keresztül, összekapcsolta a Slack-identitását a Control Center-felhasználójával, és egy Slack-szálból vezérelt egy ügynököt. Minden, ami a Slackben történt, a Control Centerben is létezik: a Slack-szál egy tér, a válasz egy átirat, a jegy pedig egy jegy.

Következő: a Slack-integráció beállítása bemutatja a kézi útvonalat, a tokenek rotálását és a hibaelhárítást. A mögötte lévő modellhez olvassa el a Csevegőhidak oldalt.