Plugin Telegram
Plugin Telegram propojuje Elowen s Telegramem. Nainstalujte ho v Nastavení → Pluginy → Dostupné pluginy. Detail pluginu obsahuje jeho nastavení. Instalace, zapnutí nebo vypnutí pluginu se projeví po restartu Elowen; některá nastavení a přepisy pro jednotlivé chaty platí okamžitě. Každodenní příkazy a chování kanálu najdete v části Telegram. Společné pojmy pro všechny chatovací platformy jsou v přehledu Pluginy pro chatovací platformy.
V manifestu pluginu a v tržišti ověřte, které vydání jádra plugin obsahuje. Adaptér vyžaduje jádro Elowen 0.30.7 se sdíleným API verze 14 a exporty sdílených otázek a servisních zpráv jádra.
Plugin může instalovat, zapínat a konfigurovat jen administrátor. Token bota se ukládá jako tajná hodnota; jeho nastavení ukazuje jen to, zda je token nastavený, ne jeho hodnotu. Bez tokenu bota plugin nezaregistruje žádné nástroje. S tokenem jeho nástroje vracejí chybu, dokud se bot nepřipojí.
Instalace a připojení
Vytvořte bota přes @BotFather a zkopírujte jeho token. Pokud má přijímat všechny zprávy ve skupinách, vypněte v BotFather nastavení Group Privacy. Nainstalujte plugin a zapněte ho; jeho přihlašovací údaje jdou upravit až po zapnutí. Zadejte token v Nastavení → Přístupy → Telegram, nastavte alespoň jedno pravidlo role a volitelně povolené chaty a oznamovací chat. Bot se připojí při restartu, který si uložení těchto nastavení vyžádá. Používá dlouhé dotazování, takže nepotřebuje veřejný webhook. Jeho příkazy zahrnují /model, /reasoning, /display, /new a /help. Po připojení publikuje nabídku s nejvýše 100 příkazy. Názvy, které Telegram odmítne (cokoli jiného než malá písmena, číslice a podtržítka, nebo delší než 32 znaků), se vynechají, popisy se zkrátí na 256 znaků a příkazy démona jen pro operátora se nepublikují, i když po napsání fungují. /display se publikuje vždy a při spuštění kontroluje příznak operátora. /help zůstává poslední.
Pravidlo role rozhoduje, komu bot odpovídá, a může přidat pokyny pro sdílenou místnost. Nastavte alespoň jedno pravidlo. Platí první odpovídající pojmenované pravidlo a pravidlo * pro všechny se vyhodnocuje po pojmenovaných pravidlech bez ohledu na jeho pořadí. Odesílatel, který neodpovídá žádnému pravidlu, se ignoruje. Pravidlo nenahrazuje identitu: odesílatel také potřebuje propojený účet Elowen, jehož přístup k Projektům a oprávnění nástrojů platí pro dané kolo. Záznam s nastaveným admin zpřístupní sdílené výběry /model, /reasoning, /display a /context a ovládání místnosti /stop, /stats, /compact a /restart. /restart restartuje démona pro všechny.
Každý chat má vlastní konverzaci a může mít vlastní model a nastavení zobrazení. Příkazem /new tam začnete novou konverzaci. /context umožní operátorovi pokračovat v chatu v některé z jeho vlastních konverzací. /project přepne konverzaci do jednoho z vašich Projektů a nekontroluje operátora. Obrázky se posílají nastavenému modelu pro obrázky.
Příchozí hlasové zprávy a nahrané zvukové soubory se při streamování omezují na 25 MiB, a to i tehdy, když uvedená velikost chybí nebo je podhodnocená. Zvuk v tomto limitu se přepíše na text přes hlasovou službu Elowen, pokud je hlas zapnutý a odesílatel má propojený účet, oprávnění k hlasu a dostupný rozpočet. Hlasová zpráva dostane textovou odpověď a hlasovou odpověď OGG/Opus. Pokud je přepis odmítnut nebo selže, poznámka o příloze zůstane; pokud je odmítnut nebo selže hlas, textová odpověď zůstane. Nastavení hlasu a spotřeba patří Elowen a účtu odesílatele.
Zadejte oznamovací chat, pokud chcete dostávat proaktivní zprávy, například výsledky naplánovaných úloh. Nechte ho prázdný, chcete-li tyto zprávy vypnout.
Připojení a přístup
| Nastavení | Co dělá |
|---|---|
| Token bota | Povinná tajná hodnota od @BotFather. |
| Povolené chaty | Volitelná číselná ID uživatelských nebo skupinových chatů; prázdné pole nepřidá žádný seznam povolených. |
| ID oznamovacího chatu | Číselné ID chatu nebo @channelusername pro proaktivní zprávy; prázdné je vypne. |
| Pravidla rolí | Přiřadí Telegram ID uživatele, @username nebo ID celého chatu k přístupu a pokynům pro místnost. ID celého chatu pustí dovnitř všechny v tomto chatu. Pravidlo * platí po pojmenovaných pravidlech. |
Klíče polí v pořadí tabulky jsou botToken, allowedChatIds, notifyChatId a rolePolicies.
Odpovědi a média
| Nastavení | Výchozí | Co dělá |
|---|---|---|
| Odpovídat bez zmínky | Zapnuto | Odpovídat ve skupinách na každou zprávu od přiřazeného odesílatele; vypněte, chcete-li vyžadovat zmínku nebo odpověď. Přímé chaty dostanou odpověď vždy. |
| Aktivita nástrojů | Živý stav | Zvolte Vypnuto, Živý stav nebo Živý výstup. Přepis pro chat nastavíte příkazem /display. |
| Doručení odpovědi | Jen finální odpověď | Pošle jednu úplnou odpověď, nebo ji zobrazuje průběžně, jak se píše. |
| Detail výstupu nástrojů | Krátké shrnutí | Zvolte Jen stav, Krátké shrnutí nebo Poslední část výstupu; celý původní výstup se neposílá. |
| Rozložení zpráv nástrojů | Jedna živá zpráva | Ponechá jednu zprávu, nebo použije jednu zprávu pro každý nástroj. |
| Nahradit průběh nástrojů odpovědí | Vypnuto | Nahradí zprávu s průběhem finální odpovědí. Přepíše živou odpověď i rozložení po nástrojích. |
| Reakce během zpracování | Zapnuto | Zobrazuje stav pomocí podporovaných reakcí. |
| Stavový řádek | Zapnuto | Přidá pod odpověď model a využití kontextu. |
| Zobrazit uvažování | Vypnuto | Zobrazí výstup rozšířeného uvažování, pokud ho model podporuje. |
| Jazyk služebních zpráv | Angličtina | Jazyk služebních zpráv: angličtina, čeština nebo slovenština. |
| Model pro obrázky | Nenastaveno | Model pro zprávy s obrázkem; prázdné pole použije obvyklý model chatu. |
| Max. velikost příchozího obrázku | 5 MiB | Limit stahování od 1 do 20 MiB; větší obrázky se jen zaznamenají. |
| Max. obrázků ve zprávě | 4 | Počet obrázků poslaných k rozpoznání, od 1 do 10. |
| Max. obrázků v odpovědi | 4 | Obrázky sdílené přes ShareImage připojené k jedné odpovědi, od 1 do 10. |
| Časový limit nabídky | 6 minut | Doba na výběr z interaktivní nabídky, od 30 sekund do 30 minut v krocích po 30 sekundách. |
Klíče v pořadí tabulky jsou respondWithoutMention, toolActivity, answerMode, toolOutput, toolMessageMode, deleteToolActivityAfterTurn, reactions, runtimeFooter, showReasoning, language, visionModel, maxImageBytes, maxImages, maxUploadImages a askTimeoutMs.
Soubory, které agent sdílí přes ShareFile, se posílají jako dokumenty Telegramu, nejvýše čtyři na odpověď, a zachovají si názvy. Sdílený soubor je omezen na 25 MiB. Odmítnuté nahrání zastaví zbývající soubory a nahradí odpověď zprávou o selhání doručení.
Nástroje a oprávnění
Plugin poskytuje 16 nástrojů. Bot potřebuje v chatu příslušná práva, aby mohl připínat nebo mazat zprávy, spravovat členy nebo měnit údaje chatu. Nemůže spravovat zakladatele chatu a může udělit jen práva, která má sám. Bot API umí vrátit počet členů, ale neuvádí všechny členy skupiny. Zprávy se posílají jako prostý text. Mazání cizích zpráv může být omezeno na prvních 48 hodin podle typu chatu. Povýšení někoho nahradí jeho administrátorská práva právy, která určíte. Názvy chatů mohou mít až 128 znaků a popisy až 255.
Nástroje: TelegramChatInfo, TelegramGetMembersCount, TelegramMemberInfo, TelegramSend, TelegramPinMessage, TelegramUnpinMessage, TelegramDeleteMessage, TelegramBanMember, TelegramUnbanMember, TelegramPromoteMember, TelegramSetChatTitle, TelegramSetChatDescription, TelegramCreateForumTopic, TelegramEditForumTopic, TelegramCloseForumTopic a TelegramApi.
TelegramApi umí zavolat libovolnou metodu Bot API s objektem parametrů JSON; použijte ho jen tehdy, když úlohu nepokrývá žádný specializovaný nástroj. Jeho výstup je omezen na 4 000 znaků. Dlouhé odpovědi se dělí na zprávy do 4 000 znaků a popisky fotek jsou omezeny na 1 024 znaků.