Koble Slack til arbeidsområdet ditt

Det du skal bygge

Når du er ferdig med denne veiledningen, har du:

• En Slack-app opprettet for arbeidsområdet ditt, med de riktige tillatelsene og hendelsene allerede satt opp
• En levende tilkobling mellom Slack og Control Center
• Din egen Slack-konto knyttet til Control Center-brukeren din
• En agent som svarer deg i en Slack-tråd, og en sak opprettet fra en skråstrekkommando

Forutsetninger:

• Ditt første arbeidsområde og Send ut din første agent fullført — et arbeidsområde uten agenter kan ta imot en Slack-melding, men har ingen som kan svare på den
• Arbeidsområdets CEO-agent har en adapter og en modell satt under Innstillinger → Arbeidsområde → Agenter. Broen vekker CEO-en, ikke agenten du konfigurerte i forrige veiledning, og en agent uten adapter kjører på den innebygde løkken med Anthropics standardmodell.
• Rollen owner eller admin i Control Center-arbeidsområdet (å koble til en chat-app taler for hele arbeidsområdet)
• Tillatelse til å opprette og installere apper i Slack-arbeidsområdet

Ingenting her trenger en offentlig adresse, en tunnel eller en innkommende port. Control Center ringer ut til Slack over Socket Mode, så dette virker fra en bærbar maskin bak NAT.

Steg 1: Skaff et appkonfigurasjonstoken for Slack

Dette er den ene hemmeligheten du må hente for hånd. Det lar Control Center opprette og senere redigere appen for deg.

1. Åpne api.slack.com/apps
2. Rull ned til delen for appkonfigurasjonstokenet nederst på siden
3. Generer et tokenpar for Slack-arbeidsområdet ditt
4. Kopier oppdateringstokenet — det begynner med xoxe-

Steg 2: La Control Center opprette appen

1. I Control Center går du til Innstillinger → Arbeidsområde → Generelt og finner kortet Chat-broer
2. I Slack-blokken klikker du på Opprett app for meg
3. Lim inn appkonfigurasjonstokenet
4. Se gjennom hvordan boten vil se ut:
   • Appnavn: hvordan Slack viser appen, f.eks. Control Center · Acme
   • Botnavn: det folk skriver etter @, f.eks. control-center
   • Kort beskrivelse og Hva boten sier den kan gjøre
   • Slash-kommando: cc som standard, så kommandoen er /cc
   • Direktemeldinger: la stå på, slik at medlemmer kan sende direktemeldinger til boten
5. Klikk Opprett app

Control Center setter sammen hele appdefinisjonen — Socket Mode på, bot-scopene og hendelsesabonnementene den trenger, skråstrekkommandoen, Messages-fanen — og oppretter den i Slack.

Steg 3: Fullfør de to stegene bare Slack kan gjøre

Slack har ingen API for å generere et app-nivå-token eller installere en app, så dialogen gir deg begge som lenker:

1. Generer et app-nivå-token — åpner Basic Information → App-Level Tokens. Opprett et token med scopet connections:write og kopier det. Det begynner med xapp-
2. Installer appen — åpner Install App. Installer til arbeidsområdet, og kopier deretter Bot User OAuth Token. Det begynner med xoxb-

Ta vare på begge verdiene til neste steg.

Steg 4: Koble til

1. Tilbake i dialogen klikker du på Lim inn påloggingsinformasjonen
2. Fyll inn Bot-token (xoxb-…) og App-nivå-token (xapp-…)
3. La Appkonfigurasjonstoken stå tomt — det fra steg 1 er allerede lagret (Slack roterte det, og Control Center lagret det nye)
4. Klikk Koble til

Control Center verifiserer bot-tokenet med Slack før den lagrer noe, og åpner deretter socketen. Raden viser nå botens navn og navnet på Slack-arbeidsområdet ditt med et Live-merke.

Steg 5: Knytt din egen Slack-konto

Tilkoblingen gjør boten tilgjengelig; knytningen gjør deg gjenkjennelig. Inntil Slack-identiteten din er knyttet, vil ikke boten handle på meldingene dine — den tilskriver aldri en melding til den som installerte appen.

Knytningen er personlig, og ligger derfor på en annen side enn den arbeidsområdeomfattende tilkoblingen.

1. Gå til Innstillinger → Arbeidsområde → Profil og identitet og finn kortet Knyttede chat-kontoer
2. Klikk Knytt Slack-kontoen min
3. Kopier kommandoen den viser, for eksempel /cc link K7M2QP
4. I Slack sender du den kommandoen til boten i en direktemelding
5. Boten svarer «Knyttet — du er …»

Koden er til engangsbruk og utløper etter 15 minutter. Hvis Slack-e-postadressen din stemmer med en Control Center-bruker som allerede er medlem av dette arbeidsområdet, knytter broen deg til automatisk første gang du snakker med den, og du kan hoppe over dette steget.

Hvis du nevner boten før dette er gjort, avviser den og sier hvorfor. De tre avvisningene er forskjellige, så les hvilken du fikk:

• Avsender uten knytning: boten forteller deg hvordan du knytter. Kom tilbake til dette steget.
• Knyttet, men ikke medlem av dette arbeidsområdet: be en admin om å invitere deg.
• Medlem med en skrivebeskyttet rolle (viewer eller guest): boten starter ikke arbeid på dine vegne.

Steg 6: Sett en agent på noe

1. I Slack inviterer du boten inn i en kanal: /invite @control-center

2. Nevn den med en ekte forespørsel:

   @control-center oppsummer de åpne PR-ene i api-repoet

Broen:

1. Oppretter et Control Center-område for den Slack-tråden, oppkalt etter Slack-kanalen og forespørselen din
2. Vekker arbeidsområdets frontdør-agent (CEO-agenten når det finnes en, ellers den første agenten)
3. Strømmer agentens svar tilbake til Slack-tråden etter hvert som det skrives

Svar i den samme Slack-tråden for å fortsette — du trenger ikke nevne boten flere ganger, fordi Slack-tråden nå er broet. Du kan også sende direktemelding til boten i stedet for å bruke en kanal; hver direktemeldingssamtale driver sitt eget Control Center-område, med en tittel og en «Tenker…»-statuslinje mens agenten jobber.

Strømming krever Slacks strømme-API, som ikke finnes i alle abonnementer. Hvis appen din avvises for det, slutter broen å prøve for hele tilkoblingen og legger i stedet ut hvert svar som én enkelt melding, og kortet Chat-broer viser «Live-strømming er av for denne Slack-appen — svar kommer som én melding.» Alt annet virker på samme måte.

Steg 7: Opprett en sak uten å forlate Slack

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

Boten svarer med saksnøkkelen den opprettet. Saken er en vanlig lokal Control Center-sak, rapportert av deg, klar til å tilordnes en agent. /cc help viser alt kommandoen kan gjøre.

Oppsummering

Du opprettet en Slack-app fra Control Center, koblet den til over en utgående socket, knyttet Slack-identiteten din til Control Center-brukeren din og styrte en agent fra en Slack-tråd. Alt som skjedde i Slack, finnes også i Control Center: Slack-tråden er et område, svaret er en transkripsjon, saken er en sak.

Neste: Sett opp Slack-integrasjon dekker veien for hånd, rotasjon av token og feilsøking. For modellen under, les Chatbroer.