Discord
Pripojte bota Discord ku kanálom servera a vláknam. Priame správy a skupinové DM sa ignorujú, pretože neposkytujú kontext člena servera. Ignorujú sa aj systémové správy, správy botov a správy zo servera vylúčeného nastavením pluginu. O zdieľanej identite a prístupe sa dočítate v článku Kanály.
Pripojenie bota
- Vytvorte aplikáciu v Discord Developer Portal.
- Vytvorte bota a skopírujte jeho token. V časti Privileged Gateway Intents zapnite Message Content Intent.
- Pozvite bota na svoj server s oprávnením čítať a odosielať správy a používať príkazy aplikácie. Udeľte aj ďalšie oprávnenia Discordu, ktoré bot na svoje akcie potrebuje.
- V Elowen otvorte Nastavenia → Dostupné pluginy, nainštalujte Discord a potom zadajte token bota v Nastavenia → Prístupy → Discord.
- Pridajte pravidlo roly a plugin zapnite.
Server Members Intent zapnite tiež, ak potrebujete nástroj DiscordListMembers.
Komu bot odpovedá
V Nastavenia → Pluginy → Discord → Pravidlá rolí pridajte ID rolí Discordu, ktoré smú bota používať. Pravidlá sa kontrolujú v poradí a použije sa prvá zhoda; členovia bez zhody sa ignorujú. Pomocou pravidla * vpusťte všetkých členov servera a dajte ho za pomenované roly. Pravidlo môže obsahovať aj prompt pre konkrétnu miestnosť.
Voľbou Prístup administrátora pri pravidle povolíte ovládanie spoločného kanála, napríklad /model, /reasoning, /context a /display, aj operátorské príkazy ako /restart. Pravidlo roly nenahrádza prepojenie identity odosielateľa na Discorde s účtom Elowen. Prístup k Projektom a nástrojom pochádza z prepojeného účtu a akcie na Discorde navyše vyžadujú oprávnenia bota v Discorde.
Obmedzenie odpovedí a oznámení
V Nastavenia → Pluginy → Discord:
- Odpovedať bez zmienky je v predvolenom nastavení zapnuté. Vypnutím vynútite @zmienku.
- ID servera obmedzí odpovede na jeden server. Ak pole necháte prázdne, bot odpovedá na všetkých serveroch, kde je nainštalovaný.
- Povolené vlákna obmedzí odpovede na uvedené ID vlákien. Ak je zoznam prázdny, bot môže odpovedať v ktoromkoľvek inak povolenom kanáli alebo vlákne.
- Cieľ oznámení zvolí kanál alebo aktívne vlákno pre proaktívne správy, napríklad naplánované výsledky a upozornenia. Ak ho necháte prázdne, tieto správy sa vypnú.
Výber cieľa potrebuje token bota aj ID servera. Ponúka textové kanály a aktívne vlákna; kategórie, hlasové, oznamovacie, stage, fórum či mediálne kanály ani archivované vlákna nie.
Príkazy a zobrazenie
Discord zobrazuje dostupné príkazy ako slash príkazy, výberové ponuky a tlačidlá. Ponuku určuje bežiace nastavenie. Medzi bežné príkazy patria /new, /stop, /stats, /compact, /fast a /help. Spoločné ovládanie /model, /reasoning, /context a /display vyžaduje pravidlo administrátora, rovnako ako príkazy miestnosti /stop, /stats a /compact. /restart reštartuje Elowen pre všetkých a vyžaduje pravidlo administrátora.
Otázky od Elowen sa zobrazujú ako tlačidlá alebo ponuky a pri prompte s viacerými otázkami sa nimi prechádza jedna po druhej. Odpovedať môže ktorýkoľvek člen vpustený pravidlami rolí. Člen, ktorého nevpustí žiadne pravidlo, dostane súkromné oznámenie.
Predvolené hodnoty nastavte v nastavení pluginu alebo použite /display v kanáli, kde máte oprávnenie:
- Aktivita nástrojov: Vypnuté, Živý stav, alebo Živý výstup.
- Doručenie odpovede: Len finálna odpoveď, alebo Priebežne zobrazovať odpoveď.
- Detail výstupu nástrojov: Len stav, Krátke zhrnutie, alebo Posledná časť výstupu.
- Rozloženie správ nástrojov: Jedna živá správa, alebo Jedna správa na nástroj.
- Nahradiť priebeh práce odpoveďou: v predvolenom nastavení vypnuté. Po zapnutí sa správa s priebehom nahradí finálnou odpoveďou. Prepíše sa priebežné zobrazovanie odpovede aj rozloženie po nástrojoch.
Reakcie počas spracovania a Stavový riadok (malý riadok s modelom a percentom kontextu pod finálnou odpoveďou) sú v predvolenom nastavení zapnuté. Zobraziť uvažovanie je v predvolenom nastavení vypnuté a vyžaduje model, ktorý podporuje rozšírené uvažovanie. Jazyk služobných správ ovláda vlastné správy bota a ponúka angličtinu, češtinu a slovenčinu.
História konverzácie, obrázky a súbory
Počet správ z histórie kanála je v predvolenom nastavení 0. Nastavte ho v rozsahu 0 až 100, aby nová konverzácia v kanáli zahrnula toľko posledných správ Discordu. Existujúce konverzácie históriu znova nenačítavajú. Ak Discord históriu nenačíta, konverzácia začne bez nej.
Na spracovanie obrázkov je potrebný model s podporou zraku. Voliteľný Model pre obrázky vyberie model pre správy s obrázkom; ak je prázdny, použije sa obvyklý model kanála. V predvolenom nastavení platí Max. veľkosť prichádzajúceho obrázka 5 MiB na prichádzajúci obrázok a Max. obrázkov na správu štyri obrázky na správu. Ostatné súbory obmedzuje Max. veľkosť súboru (v predvolenom nastavení 25 MiB) a Max. súborov na správu (v predvolenom nastavení päť). Príliš veľké a nadbytočné prílohy sa len zaznamenajú, nestahujú sa. Max. obrázkov na odpoveď určuje, koľko obrázkov môže agent pripojiť k jednej odpovedi nástrojom ShareImage; predvolená hodnota sú štyri. Prepis zvuku sa rieši samostatne a je obmedzený na 25 MiB na klip.
Hlasové správy a nástroje Discordu
Hlasové správy používajú hlasový režim core, ktorý sa nastavuje v Nastavenia → Hlasový režim. Pre prepojený účet s oprávnením na hlas Elowen prepíše zvukovú prílohu. Hlasový režim musí byť zapnutý a účet musí mať priestor v rámci limitu útraty. Ak je prepis odmietnutý alebo zlyhá, príloha sa označí ako neprepísaná nahrávka.
Natívna hlasová správa Discordu dostane textovú odpoveď a za ňou hlasovú odpoveď v OGG. Bežná zvuková príloha dostane len textovú odpoveď. Ak je reč odmietnutá alebo zlyhá, textová odpoveď zostane.
Plugin poskytuje štruktúrované nástroje pre informácie o serveri, kanály, vlákna, členov, roly, pripnuté správy a správy. Keď potrebujete ID kanála alebo vlákna, začnite nástrojom DiscordListChannels; ID správ nájdete nástrojom DiscordReadChannel. DiscordApi je nízkoúrovňový spôsob volania API Discordu a môže vykonať nevratné zmeny. Platia pravidlá nástrojov aj oprávnenia bota.