Plugin Telegram
Plugin Telegram prepája Elowen s Telegramom. Nainštalujte ho v Nastavenia → Pluginy → Dostupné pluginy. Detail pluginu obsahuje jeho nastavenia. Inštalácia, zapnutie alebo vypnutie pluginu sa prejaví po reštarte Elowen; niektoré nastavenia a prepisy pre jednotlivé chaty platia okamžite. Každodenné príkazy a správanie kanála nájdete v časti Telegram. Spoločné pojmy pre všetky chatovacie platformy sú v prehľade Pluginy pre chatovacie platformy.
V manifeste pluginu a v trhovisku overte, ktoré vydanie jadra plugin obsahuje. Adaptér vyžaduje jadro Elowen 0.30.7 so zdieľaným API verzie 14 a exporty zdieľaných otázok a servisných správ jadra.
Plugin môže inštalovať, zapínať a konfigurovať len administrátor. Token bota sa ukladá ako tajná hodnota; jeho nastavenie ukazuje len to, či je token nastavený, nie jeho hodnotu. Bez tokenu bota plugin nezaregistruje žiadne nástroje. S tokenom jeho nástroje vracajú chybu, kým sa bot nepripojí.
Inštalácia a pripojenie
Vytvorte bota cez @BotFather a skopírujte jeho token. Ak má prijímať všetky správy v skupinách, vypnite v BotFather nastavenie Group Privacy. Nainštalujte plugin a zapnite ho; jeho prihlasovacie údaje sa dajú upraviť až po zapnutí. Zadajte token v Nastavenia → Prístupy → Telegram, nastavte aspoň jedno pravidlo roly a voliteľne povolené chaty a oznamovací chat. Bot sa pripojí pri reštarte, ktorý si uloženie týchto nastavení vyžiada. Používa dlhé dopytovanie, takže nepotrebuje verejný webhook. Jeho príkazy zahŕňajú /model, /reasoning, /display, /new a /help. Po pripojení publikuje ponuku s najviac 100 príkazmi. Názvy, ktoré Telegram odmietne (čokoľvek iné ako malé písmená, číslice a podčiarkovníky, alebo dlhšie ako 32 znakov), sa vynechajú, popisy sa skrátia na 256 znakov a príkazy démona len pre operátora sa nepublikujú, aj keď po napísaní fungujú. /display sa publikuje vždy a pri spustení kontroluje príznak operátora. /help zostáva posledný.
Pravidlo roly rozhoduje, komu bot odpovedá, a môže pridať pokyny pre zdieľanú miestnosť. Nastavte aspoň jedno pravidlo. Platí prvé zodpovedajúce pomenované pravidlo a pravidlo * pre všetkých sa vyhodnocuje po pomenovaných pravidlách bez ohľadu na jeho poradie. Odosielateľ, ktorý nezodpovedá žiadnemu pravidlu, sa ignoruje. Pravidlo nenahrádza identitu: odosielateľ tiež potrebuje prepojený účet Elowen, ktorého prístup k Projektom a oprávnenia nástrojov platia pre dané kolo. Záznam s nastaveným admin sprístupní zdieľané výbery /model, /reasoning, /display a /context a ovládanie miestnosti /stop, /stats, /compact a /restart. /restart reštartuje démona pre všetkých.
Každý chat má vlastnú konverzáciu a môže mať vlastný model a nastavenia zobrazenia. Príkazom /new tam začnete novú konverzáciu. /context umožní operátorovi pokračovať v chate v niektorej z jeho vlastných konverzácií. /project prepne konverzáciu do jedného z vašich Projektov a nekontroluje operátora. Obrázky sa posielajú nastavenému modelu pre obrázky.
Prichádzajúce hlasové správy a nahraté zvukové súbory sa pri streamovaní obmedzujú na 25 MiB, a to aj vtedy, keď uvedená veľkosť chýba alebo je podhodnotená. Zvuk v tomto limite sa prepíše na text cez hlasovú službu Elowen, ak je hlas zapnutý a odosielateľ má prepojený účet, oprávnenie k hlasu a dostupný rozpočet. Hlasová správa dostane textovú odpoveď a hlasovú odpoveď OGG/Opus. Ak je prepis odmietnutý alebo zlyhá, poznámka o prílohe zostane; ak je odmietnutý alebo zlyhá hlas, textová odpoveď zostane. Nastavenia hlasu a spotreba patria Elowen a účtu odosielateľa.
Zadajte oznamovací chat, ak chcete dostávať proaktívne správy, napríklad výsledky naplánovaných úloh. Nechajte ho prázdny, ak chcete tieto správy vypnúť.
Pripojenie a prístup
| Nastavenie | Čo robí |
|---|---|
| Token bota | Povinná tajná hodnota od @BotFather. |
| Povolené chaty | Voliteľné číselné ID používateľských alebo skupinových chatov; prázdne pole nepridá žiadny zoznam povolených. |
| ID oznamovacieho chatu | Číselné ID chatu alebo @channelusername pre proaktívne správy; prázdne ich vypne. |
| Pravidlá rolí | Priradí Telegram ID používateľa, @username alebo ID celého chatu k prístupu a pokynom pre miestnosť. ID celého chatu pustí dnu všetkých v tomto chate. Pravidlo * platí po pomenovaných pravidlách. |
Kľúče polí v poradí tabuľky sú botToken, allowedChatIds, notifyChatId a rolePolicies.
Odpovede a médiá
| Nastavenie | Predvolené | Čo robí |
|---|---|---|
| Odpovedať bez zmienky | Zapnuté | Odpovedať v skupinách na každú správu od priradeného odosielateľa; vypnite, ak chcete vyžadovať zmienku alebo odpoveď. Priame chaty dostanú odpoveď vždy. |
| Aktivita nástrojov | Živý stav | Zvoľte Vypnuté, Živý stav alebo Živý výstup. Prepis pre chat nastavíte príkazom /display. |
| Doručenie odpovede | Len finálna odpoveď | Pošle jednu úplnú odpoveď alebo ju zobrazuje priebežne, ako sa píše. |
| Detail výstupu nástrojov | Krátke zhrnutie | Zvoľte Len stav, Krátke zhrnutie alebo Posledná časť výstupu; celý pôvodný výstup sa neposiela. |
| Rozloženie správ nástrojov | Jedna živá správa | Ponechá jednu správu alebo použije jednu správu pre každý nástroj. |
| Nahradiť priebeh nástrojov odpoveďou | Vypnuté | Nahradí správu s priebehom finálnou odpoveďou. Prepíše živú odpoveď aj rozloženie po nástrojoch. |
| Reakcie počas spracovania | Zapnuté | Zobrazuje stav pomocou podporovaných reakcií. |
| Stavový riadok | Zapnuté | Pridá pod odpoveď model a využitie kontextu. |
| Zobraziť uvažovanie | Vypnuté | Zobrazí výstup rozšíreného uvažovania, ak ho model podporuje. |
| Jazyk služobných správ | Angličtina | Jazyk služobných správ: angličtina, čeština alebo slovenčina. |
| Model pre obrázky | Nenastavené | Model pre správy s obrázkom; prázdne pole použije obvyklý model chatu. |
| Max. veľkosť prichádzajúceho obrázka | 5 MiB | Limit sťahovania od 1 do 20 MiB; väčšie obrázky sa len zaznamenajú. |
| Max. obrázkov v správe | 4 | Počet obrázkov poslaných na rozpoznanie, od 1 do 10. |
| Max. obrázkov v odpovedi | 4 | Obrázky zdieľané cez ShareImage pripojené k jednej odpovedi, od 1 do 10. |
| Časový limit ponuky | 6 minút | Čas na výber z interaktívnej ponuky, od 30 sekúnd do 30 minút v krokoch po 30 sekundách. |
Kľúče v poradí tabuľky sú respondWithoutMention, toolActivity, answerMode, toolOutput, toolMessageMode, deleteToolActivityAfterTurn, reactions, runtimeFooter, showReasoning, language, visionModel, maxImageBytes, maxImages, maxUploadImages a askTimeoutMs.
Súbory, ktoré agent zdieľa cez ShareFile, sa posielajú ako dokumenty Telegramu, najviac štyri na odpoveď, a zachovajú si názvy. Zdieľaný súbor je obmedzený na 25 MiB. Odmietnuté nahratie zastaví zostávajúce súbory a nahradí odpoveď správou o zlyhaní doručenia.
Nástroje a oprávnenia
Plugin poskytuje 16 nástrojov. Bot potrebuje v chate príslušné práva, aby mohol pripínať alebo mazať správy, spravovať členov alebo meniť údaje chatu. Nemôže spravovať zakladateľa chatu a môže udeliť len práva, ktoré má sám. Bot API vie vrátiť počet členov, ale neuvádza všetkých členov skupiny. Správy sa posielajú ako prostý text. Mazanie cudzích správ môže byť obmedzené na prvých 48 hodín podľa typu chatu. Povýšenie niekoho nahradí jeho administrátorské práva právami, ktoré určíte. Názvy chatov môžu mať až 128 znakov a popisy až 255.
Nástroje: TelegramChatInfo, TelegramGetMembersCount, TelegramMemberInfo, TelegramSend, TelegramPinMessage, TelegramUnpinMessage, TelegramDeleteMessage, TelegramBanMember, TelegramUnbanMember, TelegramPromoteMember, TelegramSetChatTitle, TelegramSetChatDescription, TelegramCreateForumTopic, TelegramEditForumTopic, TelegramCloseForumTopic a TelegramApi.
TelegramApi vie zavolať ľubovoľnú metódu Bot API s objektom parametrov JSON; použite ho len vtedy, keď úlohu nepokrýva žiadny špecializovaný nástroj. Jeho výstup je obmedzený na 4 000 znakov. Dlhé odpovede sa delia na správy do 4 000 znakov a popisy fotiek sú obmedzené na 1 024 znakov.