Propojte Slack s pracovním prostorem

Co postavíš

Na konci tohohle tutoriálu budeš mít:

• Aplikaci Slack vytvořenou pro tvůj pracovní prostor, se správnými oprávněními a událostmi už nastavenými
• Živé spojení mezi Slackem a Control Center
• Vlastní účet Slack propojený s tvým uživatelem Control Center
• Agenta, který ti odpovídá ve vláknu Slacku, a ticket založený příkazem s lomítkem

Předpoklady:

• Hotové Váš první pracovní prostor a Odešlete prvního agenta. Pracovní prostor bez agentů zprávu ze Slacku přijme, ale nemá kdo odpovědět
• Agent CEO pracovního prostoru má v Nastavení → Pracovní prostor → Agenti nastavený adaptér a model. Most probudí CEO, ne agenta z předchozího tutoriálu. Agent bez adaptéru běží na vestavěné smyčce s výchozím modelem Anthropic
• Role owner nebo admin v pracovním prostoru Control Center (připojení chatové aplikace mluví za celý pracovní prostor)
• Oprávnění vytvářet a instalovat aplikace v pracovním prostoru Slacku

Nic z toho nepotřebuje veřejnou adresu, tunel ani příchozí port. Control Center volá ven do Slacku přes Socket Mode, takže to funguje z notebooku za NAT.

Krok 1: Získej token konfigurace aplikace Slack

Tohle je jediné tajemství, které si musíš vyzvednout sám. Díky němu Control Center aplikaci vytvoří a později za tebe upraví.

1. Otevři api.slack.com/apps
2. Sjeď dolů na stránce k sekci tokenů konfigurace aplikace
3. Vygeneruj pár tokenů pro svůj pracovní prostor Slacku
4. Zkopíruj refresh token. Začíná na xoxe-

Krok 2: Nech Control Center vytvořit aplikaci

1. V Control Center jdi do Nastavení → Pracovní prostor → Obecné a najdi kartu Mosty chatu
2. V bloku Slack klikni na Vytvořit aplikaci za mě
3. Vlož token konfigurace aplikace
4. Zkontroluj, jak bude bot vypadat:
   • Název aplikace: jak Slack aplikaci vypíše, např. Control Center · Acme
   • Jméno bota: co lidé píší za @, např. control-center
   • Krátký popis a Co bot říká, že umí
   • Slash příkaz: výchozí je cc, takže příkaz je /cc
   • Přímé zprávy: nech zapnuté, ať členové můžou botovi psát přímou zprávu
5. Klikni na Vytvořit aplikaci

Control Center složí celou definici aplikace: zapnutý Socket Mode, scopes bota a odběry událostí, které potřebuje, slash příkaz i kartu Messages, a vytvoří ji ve Slacku.

Krok 3: Dokonči dva kroky, které umí jen Slack

Slack nemá API na vygenerování tokenu na úrovni aplikace ani na instalaci aplikace, takže dialog ti obojí předá jako odkazy:

1. Vygenerovat token na úrovni aplikace otevře Basic Information → App-Level Tokens. Vytvoř token se scopem connections:write a zkopíruj ho. Začíná na xapp-
2. Nainstalovat aplikaci otevře Install App. Nainstaluj do pracovního prostoru a zkopíruj Bot User OAuth Token. Začíná na xoxb-

Obě hodnoty si nech na další krok.

Krok 4: Připoj

1. Zpět v dialogu klikni na Vložit přihlašovací údaje
2. Vyplň Token bota (xoxb-…) a Token na úrovni aplikace (xapp-…)
3. Token konfigurace aplikace nech prázdný. Ten z kroku 1 už je uložený (Slack ho otočil a Control Center si novou hodnotu uložil)
4. Klikni na Připojit

Control Center ověří token bota u Slacku, ještě než cokoli uloží, a pak otevře socket. Řádek teď ukazuje jméno bota a název tvého pracovního prostoru Slack se štítkem Živě.

Krok 5: Propoj vlastní účet Slack

Připojení udělá bota dosažitelným. Propojení udělá rozpoznatelným tebe. Dokud není tvoje identita ve Slacku propojená, bot podle tvých zpráv nejedná. Zprávu nikdy nepřiřadí tomu, kdo aplikaci nainstaloval.

Propojení je osobní, takže leží na jiné stránce než připojení celého pracovního prostoru.

1. Jdi do Nastavení → Pracovní prostor → Profil a identita a najdi kartu Propojené účty chatu
2. Klikni na Propojit můj účet Slack
3. Zkopíruj příkaz, který ukáže, například /cc link K7M2QP
4. Ve Slacku ten příkaz pošli botovi v přímé zprávě
5. Bot odpoví „Linked — you are …“

Kód je jednorázový a vyprší za 15 minut. Když se e-mail ve Slacku shoduje s uživatelem Control Center, který už je členem tohoto pracovního prostoru, most tě propojí sám při první zprávě a tenhle krok můžeš přeskočit.

Když bota zmíníš dřív, odmítne to a řekne proč. Tři odmítnutí se liší, tak si přečti, které ti přišlo:

• Nepropojený odesílatel: bot ti řekne, jak se propojit. Vrať se k tomuhle kroku.
• Propojený, ale ne člen tohoto pracovního prostoru: požádej admina o pozvánku.
• Člen s rolí jen ke čtení (viewer nebo guest): bot za tebe práci nespustí.

Krok 6: Nasaď agenta na něco

1. Ve Slacku pozvi bota do kanálu: /invite @control-center

2. Zmiň ho se skutečným požadavkem:

   @control-center shrň otevřené PR v repozitáři api

Most:

1. Založí v Control Center prostor pro to vlákno Slacku, pojmenovaný podle kanálu Slacku a podle tvého požadavku
2. Probudí vstupního agenta pracovního prostoru (agenta CEO, když existuje, jinak prvního agenta)
3. Streamuje odpověď agenta zpátky do vlákna Slacku tak, jak vzniká

Odpovídej ve stejném vláknu Slacku a pokračuj. Další zmínky nejsou potřeba, protože vlákno Slacku je teď přemostěné. Nebo botovi napiš přímou zprávu místo kanálu. Každá konverzace v přímé zprávě vede vlastní prostor Control Center, s nadpisem a stavovým řádkem „is thinking…“, dokud agent pracuje.

Streamování potřebuje streamovací API Slacku a to nemá každý tarif. Když ho aplikace nedostane, most o něj po celou dobu toho spojení přestane žádat a každou odpověď pošle jako jednu zprávu. Karta Mosty chatu pak hlásí „Živé streamování je pro tuto aplikaci Slack vypnuté — odpovědi přijdou jako jedna zpráva.“ Všechno ostatní funguje stejně.

Krok 7: Založ ticket, aniž opustíš Slack

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

Bot odpoví klíčem ticketu, který založil. Ticket je obyčejný místní ticket Control Center, nahlášený tebou, připravený k přiřazení agentovi. /cc help vypíše všechno, co příkaz umí.

Shrnutí

Z Control Center vznikla aplikace Slack, připojená odchozím socketem. Identita ve Slacku je propojená s tvým uživatelem Control Center a agenta řídí vlákno Slacku. Všechno, co se stalo ve Slacku, existuje i v Control Center: vlákno Slacku je prostor, odpověď je přepis a ticket je ticket.

Další: Nastavte integraci Slack popisuje ruční cestu, rotaci tokenů a řešení problémů. Model pod tím popisují Chatové mosty.