Telegram

Připojte Elowen k Telegramu pomocí bota. Plugin se připojuje průběžným dotazováním, takže nemusíte vystavovat veřejný webhook. O sdílené identitě a pravidlech přístupu se dočtete v článku Kanály.

Vytvoření a připojení bota

1. V Telegramu otevřete @BotFather, pošlete /newbot a zkopírujte token.
2. Pokud má bot dostávat všechny zprávy ve skupině, otevřete BotFather → Bot Settings → Group Privacy a soukromí skupin vypněte. Jinak Telegram omezuje, které zprávy ze skupin bot dostane.
3. V Elowen otevřete Nastavení → Dostupné pluginy, nainstalujte Telegram a potom zadejte token v Nastavení → Přístupy → Telegram → Token bota.
4. Přidejte pravidlo role a plugin zapněte. Bot se při startu připojí a zveřejní svou nabídku příkazů.

Kdo smí bota používat

Otevřete Nastavení → Pluginy → Telegram → Pravidla rolí. Do pole ID role přidejte číselné ID uživatele Telegramu, @username nebo ID chatu, čímž vpustíte člověka nebo celou skupinu. ID skupin mohou být záporná, například -1001234567890. Použije se první odpovídající pravidlo; odesílatelé bez shody jsou ignorováni. Pravidlo * pro všechny dejte za konkrétní pravidla.

Odesílatel také musí propojit svou identitu v Telegramu s účtem Elowen. Oprávnění k Projektům a nástrojům dodává propojený účet; odpovídající pravidlo v Telegramu je samo neuděluje. Volbou Přístup administrátora u pravidla povolíte společné ovládání jako /model, /reasoning, /context a /display i operátorské příkazy jako /stop, /stats, /compact a /restart.

Omezení odpovědí a oznámení

V Nastavení → Pluginy → Telegram:

• Odpovídat bez zmínky je ve výchozím nastavení zapnuté. Ve skupinách ho vypněte, chcete-li vynutit @zmínku nebo odpověď botovi. Přímé chaty odpovědi dostávají dál.
• Povolené chaty je doplňkový seznam číselných ID uživatelů nebo chatů. Necháte-li ho prázdný, rozhodují jen pravidla rolí.
• ID oznamovacího chatu určuje, kam se posílají proaktivní zprávy. Použijte číselné ID uživatele, skupiny nebo kanálu, případně veřejný @channelusername. Ponecháte-li prázdné, proaktivní zprávy se vypnou.

Příkazy a zobrazení

Telegram zobrazuje dostupné příkazy ve své nabídce a pro volby používá inline klávesnice. Nabídka obsahuje /new, /stop, /stats, /compact, /fast, /project, /display a /help a dále výběrové a režimové příkazy /model, /reasoning, /context, /plan, /build a /workflow; pluginy mohou přidat další. Příkazy, které vyžadují administrátora, ostatním odpoví odmítnutím. /restart administrátorům funguje, ale v nabídce se nezobrazuje.

Společné ovládání /model, /reasoning, /context a /display vyžaduje pravidlo administrátora.

Volby modelu, konverzace a Projektu fungují jen u poslední nabídky v daném chatu. Otevření další nabídky nahradí předchozí; starší tlačítka konverzaci nezmění ani novější nabídku nezavřou. Pokud nabídka vypršela, otevřete příkaz znovu.

Výchozí zobrazení nastavte v Nastavení → Pluginy → Telegram nebo použijte /display v chatu, 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 pro každý nástroj.

Reakce během zpracování a Stavový řádek (řádek s modelem a kontextem pod odpovědí) jsou ve výchozím nastavení zapnuté. Reakce během zpracování ukazují stav bota na Vaší zprávě: 👀, když ji uviděl, 👍, když je hotový, a 👎, když selhal. 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.

Otázky, obrázky, soubory a hlas

Otázky se zobrazují jako inline tlačítka. Kliknutí odpoví na otázku s jednou volbou; prompty s více volbami nebo s více otázkami potřebují Odeslat. Kde otázka povoluje vlastní odpověď, zvolte Jiné a pošlete textovou odpověď. Odpovědět může jen oslovený odesílatel nebo administrátor. Odpovědi na otázky zůstávají dostupné, dokud je Elowen nepřijme nebo čekající otázku nevyřeší. Interaktivní nabídky příkazů, například /model, ve výchozím nastavení vyprší po šesti minutách; jejich časový limit nastavíte v nastavení pluginu v rozsahu 30 sekund až 30 minut. Toto nastavení neurčuje jinou lhůtu pro otázky.

Ke zpracování obrázků je potřeba model s podporou zraku. Volitelný Model pro obrázky vybere model; je-li prázdný, Elowen použije obvyklý model chatu. Výchozí hodnoty jsou 5 MiB na obrázek (Max. velikost příchozího obrázku) a čtyři obrázky na zprávu (Max. obrázků na zprávu). K jedné odpovědi lze připojit až čtyři obrázky sdílené nástrojem ShareImage (Max. obrázků na odpověď). V odpovědi lze poslat i až čtyři sdílené soubory. Telegram dlouhé zprávy rozdělí podle svých limitů. Přepis zvuku je samostatný a podporuje klipy do 25 MiB.

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 zprávu přepíše a odpoví textem a hlasovou zprávou v OGG/Opus. 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, Elowen ponechá místo přepisu poznámku o příloze, například [Attachment: voice.ogg (audio/ogg)], a textová odpověď přesto odejde.

Plugin Telegram obsahuje nástroje pro odesílání zpráv a správu chatů, členů, zpráv a témat. Tyto nástroje používají oprávnění propojeného účtu a stále potřebují příslušná práva bota v Telegramu. Samostatný nástroj TelegramApi volá surové metody Telegram Bot API bez dalšího potvrzení, takže ho používejte jen tehdy, když specializované nástroje nestačí.

Další: Microsoft Teams