Discord

Připojte bota Discord ke kanálům serveru a vláknům. Přímé zprávy a skupinové DM se ignorují, protože neposkytují kontext člena serveru. Ignorují se i systémové zprávy, zprávy botů a zprávy ze serveru vyloučeného nastavením pluginu. O sdílené identitě a přístupu se dočtete v článku Kanály.

Připojení bota

1. Vytvořte aplikaci v Discord Developer Portal.
2. Vytvořte bota a zkopírujte jeho token. V části Privileged Gateway Intents zapněte Message Content Intent.
3. Pozvěte bota na svůj server s oprávněním číst a odesílat zprávy a používat příkazy aplikace. Udělte i další oprávnění Discordu, která bot pro své akce potřebuje.
4. V Elowen otevřete Nastavení → Dostupné pluginy, nainstalujte Discord a potom zadejte token bota v Nastavení → Přístupy → Discord.
5. Přidejte pravidlo role a plugin zapněte.

Server Members Intent zapněte také, pokud potřebujete nástroj DiscordListMembers.

Komu bot odpovídá

V Nastavení → Pluginy → Discord → Pravidla rolí přidejte ID rolí Discordu, které smějí bota používat. Pravidla se kontrolují v pořadí a použije se první shoda; členové bez shody jsou ignorováni. Pomocí pravidla * vpusťte všechny členy serveru a dejte ho za pojmenované role. Pravidlo může obsahovat i prompt pro konkrétní místnost.

Volbou Přístup administrátora u pravidla povolíte ovládání společného kanálu, například /model, /reasoning, /context a /display, i operátorské příkazy jako /restart. Pravidlo role nenahrazuje propojení identity odesílatele na Discordu s účtem Elowen. Přístup k Projektům a nástrojům pochází z propojeného účtu a akce na Discordu navíc vyžadují oprávnění bota v Discordu.

Omezení odpovědí a oznámení

V Nastavení → Pluginy → Discord:

• Odpovídat bez zmínky je ve výchozím nastavení zapnuté. Vypnutím vynutíte @zmínku.
• ID serveru omezí odpovědi na jeden server. Necháte-li pole prázdné, bot odpovídá na všech serverech, kde je nainstalovaný.
• Povolená vlákna omezí odpovědi na uvedená ID vláken. Je-li seznam prázdný, bot může odpovídat v kterémkoli jinak povoleném kanálu nebo vlákně.
• Cíl oznámení zvolí kanál nebo aktivní vlákno pro proaktivní zprávy, například naplánované výsledky a upozornění. Ponecháte-li ho prázdné, tyto zprávy se vypnou.

Výběr cíle potřebuje token bota i ID serveru. Nabízí textové kanály a aktivní vlákna; kategorie, hlasové, oznamovací, stage, fórum či mediální kanály ani archivovaná vlákna ne.

Příkazy a zobrazení

Discord zobrazuje dostupné příkazy jako slash příkazy, výběrové nabídky a tlačítka. Nabídku určuje běžící nastavení. Mezi běžné příkazy patří /new, /stop, /stats, /compact, /fast a /help. Společné ovládání /model, /reasoning, /context a /display vyžaduje pravidlo administrátora, stejně jako příkazy místnosti /stop, /stats a /compact. /restart restartuje Elowen pro všechny a vyžaduje pravidlo administrátora.

Otázky od Elowen se zobrazují jako tlačítka nebo nabídky a u promptu s více otázkami se jimi prochází jedna po druhé. Odpovědět může kterýkoli člen vpuštěný pravidly rolí. Člen, kterého nevpustí žádné pravidlo, dostane soukromé oznámení.

Výchozí hodnoty nastavte v nastavení pluginu nebo použijte /display v kanálu, kde máte oprávnění:

• Aktivita nástrojů: Vypnuto, Živý stav, nebo Živý výstup.
• Doručení odpovědi: Jen finální odpověď, nebo Průběžně zobrazovat odpověď.
• Detail výstupu nástrojů: Jen stav, Krátké shrnutí, nebo Poslední část výstupu.
• Rozložení zpráv nástrojů: Jedna živá zpráva, nebo Jedna zpráva na nástroj.
• Nahradit průběh práce odpovědí: ve výchozím nastavení vypnuto. Po zapnutí se zpráva s průběhem nahradí finální odpovědí. Přepíše se průběžné zobrazování odpovědi i rozložení po nástrojích.

Reakce během zpracování a Stavový řádek (malý řádek s modelem a procentem kontextu pod finální odpovědí) jsou ve výchozím nastavení zapnuté. Zobrazit uvažování je ve výchozím nastavení vypnuté a vyžaduje model, který podporuje rozšířené uvažování. Jazyk služebních zpráv ovládá vlastní zprávy bota a nabízí angličtinu, češtinu a slovenštinu.

Historie konverzace, obrázky a soubory

Počet zpráv z historie kanálu je ve výchozím nastavení 0. Nastavte ho v rozsahu 0 až 100, aby nová konverzace v kanálu zahrnula tolik posledních zpráv Discordu. Stávající konverzace historii znovu nenačítají. Pokud Discord historii nenačte, konverzace začne bez ní.

Ke zpracování obrázků je potřeba model s podporou zraku. Volitelný Model pro obrázky vybere model pro zprávy s obrázkem; je-li prázdný, použije se obvyklý model kanálu. Ve výchozím nastavení platí Max. velikost příchozího obrázku 5 MiB na příchozí obrázek a Max. obrázků na zprávu čtyři obrázky na zprávu. Ostatní soubory omezuje Max. velikost souboru (ve výchozím nastavení 25 MiB) a Max. souborů na zprávu (ve výchozím nastavení pět). Příliš velké a nadbytečné přílohy se jen zaznamenají, nestahují se. Max. obrázků na odpověď určuje, kolik obrázků může agent připojit k jedné odpovědi nástrojem ShareImage; výchozí hodnota jsou čtyři. Přepis zvuku se řeší samostatně a je omezen na 25 MiB na klip.

Hlasové zprávy a nástroje Discordu

Hlasové zprávy používají hlasový režim core, který se nastavuje v Nastavení → Hlasový režim. Pro propojený účet s oprávněním k hlasu Elowen přepíše zvukovou přílohu. Hlasový režim musí být zapnutý a účet musí mít prostor v rámci limitu útraty. Pokud je přepis odmítnut nebo selže, příloha se označí jako nepřepsaný záznam.

Nativní hlasová zpráva Discordu dostane textovou odpověď a za ní hlasovou odpověď v OGG. Běžná zvuková příloha dostane jen textovou odpověď. Pokud je řeč odmítnuta nebo selže, textová odpověď zůstane.

Plugin poskytuje strukturované nástroje pro informace o serveru, kanály, vlákna, členy, role, připnuté zprávy a zprávy. Když potřebujete ID kanálu nebo vlákna, začněte nástrojem DiscordListChannels; ID zpráv najdete nástrojem DiscordReadChannel. DiscordApi je nízkoúrovňový způsob volání API Discordu a může provést nevratné změny. Platí pravidla nástrojů i oprávnění bota.

Další: Telegram