Kösd össze a MyAgenst a Slackkel

A Slack a MyAgensbe vezető három út egyike, a Telegram és a webes panel mellett. Kösd össze, és Atlas egy privát üzenetben válaszol a saját munkaterületeden: a válaszok streamelve érkeznek, ahogy íródnak, a jóváhagyások gombokként jelennek meg, amikre kattinthatsz, a háttérben futó riasztások pedig ugyanabba a DM-be futnak be. Ez az útmutató a nulláról állítja be.

A Slack opcionális és kiegészítő. Futtathatod csak panellel, panel plusz Telegrammal, panel plusz Slackkel, vagy mindhárommal együtt. Ha később adod hozzá a Slacket, azzal semmit nem kell újratelepítened.

Csak privát üzenetek. A Slack felület csak az engedélyezési listádon szereplő tag azonosítók DM-jeire válaszol, semmi másra. Ha az appot meghívod egy csatornába, az szándékosan nem ad hozzáférést annak a csatornának: egy csatornameghívás soha nem válhat hozzáféréssé ahhoz a gépehez, amin a MyAgens fut.

Mire lesz szükséged

• A MyAgens legyen már telepítve és fusson. Ha még nem jutottál el idáig, kezdd a Állítsd be a MyAgenst öt perc alatt útmutatóval.
• Egy Slack munkaterület, ahol jogosult vagy appokat telepíteni. Sok munkaterületen az app telepítéséhez egy adminisztrátor jóváhagyása kell, szóval ha a telepítés gomb engedélyt kér, az a munkaterületed szabálya, nem a MyAgensé.
• Két perc az api.slack.com/apps oldalon.

1. Indulj a panelből, ne egy szövegszerkesztőből

Nyisd meg a panelt, és menj a Settings → Slack menüpontra. Az első indításkor futó varázslóban ugyanez a lépés szerepel, ha még a kezdeti beállításnál tartasz, egy Skip gombbal, ha inkább később adnád hozzá a Slacket.

Az számít, hogy itt csináld, nem kézzel a .env fájlban, mert ez a legveszélyesebb rész, ha vakon próbálod beállítani: van két token, amik hasonlítanak egymásra, és a Slack admin felület két különböző oldalán élnek, plusz egy tag azonosító, amit a legtöbben még sosem kerestek ki. A panel minden tokent leellenőriz a Slacknél, mielőtt bármit is elmentene, így egy felcserélt bot és app token azonnal kiderül, nem csak a következő újraindításnál. Az itt elmentett tokenek a titkosított trezorba kerülnek, és azonnal életbe lépnek, újraindítás nélkül.

2. Hozd létre a Slack appot a manifestből

Az api.slack.com/apps oldalon válaszd a Create New App → From an app manifest opciót, add meg a munkaterületed, válaszd a JSON formátumot, és illeszd be a manifestet. A panel megmutatja a pontos szöveget, amit át kell másolnod, valahogy így néz ki:

{
  "display_information": { "name": "MyAgens Atlas" },
  "features": {
    "app_home": {
      "home_tab_enabled": false,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": ["chat:write", "files:read", "files:write", "im:history",
              "im:read", "im:write", "search:read", "users:read"]
    }
  },
  "settings": {
    "event_subscriptions": { "bot_events": ["message.im"] },
    "interactivity": { "is_enabled": true },
    "socket_mode_enabled": true
  }
}

A manifest három dolgot végez el, amiket érdemes ismerni:

• messages_tab_enabled adja az appnak azt a DM fület, amibe ténylegesen tudsz gépelni.
• socket_mode_enabled azt jelenti, hogy a Slack egy WebSocketen keresztül csatlakozik ki a MyAgenshez. Nincs szükséged nyilvános URL-re, alagútra vagy nyitott portra ahhoz, hogy a Slack működjön.
• interactivity teszi lehetővé, hogy az Approve, Deny és kérdés gombok elérjék a botot. Hagyd bekapcsolva, hacsak nincs rá okod, lásd lentebb a Ha a gombjaid nem csinálnak semmit szakaszt.

3. Generáld le az app szintű tokent

Még mindig az új appodban, menj a Basic Information → App-Level Tokens menüpontra, és kattints a Generate Token and Scopes gombra.

• Adj neki egy felismerhető nevet, például myagens-socket.
• Add hozzá a connections:write hatáskört. Ezen az egy hatáskörön fut a Socket Mode.
• Másold ki a tokent. xapp- előtaggal kezdődik.

4. Telepítsd az appot, és másold ki a bot tokent

Menj az OAuth & Permissions menüpontra, és kattints az Install to Workspace gombra, majd hagyd jóvá a hatásköröket. A Slack ad egy Bot User OAuth Token-t, ami xoxb- előtaggal kezdődik.

A két tokent könnyű összekeverni. Az xapp- az app token a Basic Information alól, az xoxb- a bot token az OAuth & Permissions alól. Illeszd be mindegyiket a saját mezőjébe a panelben, és azonnal szól, ha felcserélted őket, illetve azt is megmondja, melyik munkaterülethez tartozik ténylegesen a bot token.

5. Bizonyítsd, hogy te vagy az

A MyAgens csak az engedélyezési listáján szereplő Slack tag azonosítóknak válaszol, mindenki mást szó nélkül figyelmen kívül hagy, pontosan úgy, mint a Telegram felhasználói azonosító engedélyezési lista esetében.

Nem kell magadnak kivadászni a sajátodat. Ha mindkét token ellenőrizve van, a panel vár egy privát üzenetre: nyisd meg a Slacket, keresd meg az új appodat az Apps alatt, és küldj neki bármit. A panel kiolvassa a tag azonosítódat ebből az üzenetből, és kitölti helyetted. A bot saját azonosítója ki van zárva, így nem tudja saját magát jelölni.

Ha inkább kézzel keresnéd meg, nyisd meg a Slack profilodat, kattints a ... menüre, és válaszd a Copy member ID opciót. U betűvel kezdődik.

6. Köszönj be

Mentsd el, és a Slack újraindítás nélkül csatlakozik. Küldj Atlasnak egy üzenetet a DM-ben, és egy streamelt választ kell kapnod. Próbáld ki először a !ping parancsot, ha a lehető legkisebb teszt kell.

A parancsok !-lel kezdődnek, nem /-vel

A Slack sosem kézbesít egy /parancsot, amit az app nem jelentett be, ezért a Slack felület ! előtagot használ helyette. Ezek külön Slack beállítás nélkül is működnek:

Ha inkább a / formát szeretnéd, jelentsd be ugyanezeket a parancsokat a Slash Commands alatt a Slack appodban. A kezelők már mindkettőre regisztrálva vannak, így azonnal működnek, amint a Slack tud róluk.

Ha a gombjaid nem csinálnak semmit

A jóváhagyó és kérdés gombok csak akkor érik el a botot, ha a Slack appodon be van kapcsolva az Interactivity. Ha ki van kapcsolva, vagy a munkaterületed kiveszi, minden továbbra is működik gépeléssel:

• Válaszolj egy kérdésre az opciója számával, az opció szövegével, vagy a saját szavaiddal.
• Válaszolj egy jóváhagyásra ezekkel: yes, no, vagy always. Írj hozzá all-t, hogy egy egész köteget egyszerre rendezz le.
• A !stop lemond egy függőben lévő kérdést vagy jóváhagyást, és megszakítja a kört is.

A Slack felület nem ugyanaz, mint a Slack integráció

Ez két különálló funkció, érdemes külön tartani őket:

• A Slack felület (ez az útmutató) az, ahogy te beszélsz Atlasszal: egy DM, a saját fiókodon, a saját engedélyezési listáddal.
• A Slack integráció az, ahogy az ügynökeid beszélnek a Slackkel: csatornák listázása, előzmények olvasása, üzenetek küldése, válasz szálakban, keresés és fájlfeltöltés, egy hitelesítő adattal, amit a panel Connectors nézetében adsz meg.

Az egyiket a másik nélkül is futtathatod. A felület bekapcsolása nem ad az ügynököknek jogot posztolni a csatornáidban, az integráció hozzáadása pedig nem ad neked DM-et Atlasszal.

A .env fájl használata helyette

Ha inkább a környezeti fájlban állítanád be a Slacket, a három változó továbbra is működik, és akkor lép életbe, amikor a panelben nincs semmi beállítva:

SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
SLACK_ALLOWED_USER_IDS=U0123456789

A SLACK_ALLOWED_USER_IDS egy vesszővel elválasztott listát fogad el. Ha teljesen kihagyod a sort, vagy üresen hagyod, az azt jelenti, hogy "Slack nincs beállítva", és a MyAgens ettől függetlenül normálisan elindul.

Kikapcsolás

Töröld a tokeneket a Settings → Slack alatt (vagy vedd ki a SLACK_* sorokat a .env fájlból), és a felület leáll. A MyAgens tovább fut, amíg legalább egy útvonalad megmarad: a panel, a Telegram vagy a Slack. Csak akkor tagadja meg az indulást, ha semmi nincs beállítva, vagy ha egy felület félig van beállítva, például egy token engedélyezési lista nélkül.

Ha a Slack oldaláról is el akarod távolítani, töröld az appot az api.slack.com/apps oldalon, ami mindkét tokent visszavonja.

Kapcsolódó

• A Jóváhagyások és autonómia, kockázatos műveletek kordában tartása elmagyarázza, hogy az Approve és Deny gombok valójában mit kapuznak.
• Nyisd meg a MyAgens webes panelt, ha a teljes irányítóteremre is szükséged van a csevegés mellett.
• Hogyan hozd létre az első Telegram botodat a BotFatherrel a másik csevegő felülethez.