Pluginy pro chatovací platformy

Pluginy Discord, Telegram a WhatsApp propojují Elowen s těmito chatovacími platformami. Nainstalujte je 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álů najdete v částech Discord, Telegram nebo WhatsApp. Microsoft Teams je popsaný v části Microsoft Teams & Microsoft 365.

Všechny tři vyžadují Elowen 0.30.7 nebo novější a sdílené API verze 14. Aktuální verzi každého pluginu najdete v registru.

Tyto pluginy může instalovat, zapínat a konfigurovat jen administrátor. Tokeny botů Discord a Telegram se ukládají jako tajné hodnoty; jejich nastavení ukazují jen to, zda je token nastavený, ne jeho hodnotu. WhatsApp používá uloženou relaci propojeného zařízení. Discord a Telegram zaregistrují své nástroje, jakmile je nastavený token bota, a nástroje WhatsAppu potřebují spárované zařízení, aby se k platformě dostaly.

Jak funguje přístup k platformám

O tom, komu bot odpovídá, rozhoduje zásada rolí u Discordu a Telegramu nebo zásada odesílatele u WhatsAppu; může také dodat pokyny pro sdílenou místnost. Nastavte alespoň jednu zásadu. Platí první odpovídající pojmenovaná zásada a pravidlo * pro všechny se vyhodnocuje až po pojmenovaných pravidlech, ať je jeho pořadí jakékoli. Odesílatel, který neodpovídá žádné zásadě, se ignoruje. Zásada 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.

Každý chat nebo kanál má vlastní konverzaci a může mít vlastní model a nastavení zobrazení. Novou konverzaci tam začnete příkazem /new. Příkaz /context může do chatu platformy přinést jednu z vašich konverzací. Obrázky se posílají nastavenému modelu pro obrázky; na ostatní přílohy platí limity médií pluginu. Adaptéry umí zobrazovat průběh nástrojů a stavové reakce podle platformy a jejího nastavení.

Příkazy /compact, /fast a /restart v místnosti se zaznamenají do konverzace daného chatu, takže agent vidí, že proběhly, a odpověď na neúspěšný příkaz uvádí skutečnou chybu. Pluginy sdílejí toto zpracování příkazů přes pomocníky platformy v Elowen.

Nastavte cíl oznámení, abyste dostávali proaktivní zprávy, například výsledky naplánovaných úloh. Ponecháte-li pole prázdné, tyto zprávy se vypnou.

Stránky pluginů

• Discord: nastavení bota, připojení a přístupu, odpovědi a zobrazení, limity konverzace a médií, hlas a 25 nástrojů serveru.
• Telegram: nastavení bota, připojení a přístupu, odpovědi a média, hlas a 16 chatovacích nástrojů.
• WhatsApp: párování zařízení, zásady odesílatelů, odpovědi a média, hlas a šest nástrojů: WhatsappSend a pět skupinových nástrojů.

Limity zpráv a příloh

Adaptéry platforem dělí dlouhé odpovědi na zprávy o nejvýše 1 990 znacích na Discordu, 4 000 na Telegramu a 4 000 na WhatsAppu. Popisky fotografií a dokumentů na Telegramu a WhatsAppu jsou omezené na 1 024 znaků. Každá platforma povoluje nejvýše čtyři sdílené soubory na odpověď. Zvuk do 25 MiB na Discordu, Telegramu a WhatsAppu používá sdílenou hlasovou službu Elowen. Nativní hlasová zpráva dostane textovou odpověď a za ní hlasovou odpověď OGG/Opus; běžné zvukové přílohy na Discordu a Telegramu dostanou jen text. Hlas musí být zapnutý a oprávnění a limity útraty patří propojenému účtu. Odmítnutý nebo neúspěšný přepis zachová poznámku o příloze; odmítnutá nebo neúspěšná řeč ponechá textovou odpověď.

Číslované nabídky Telegramu a WhatsAppu, například /model, ve výchozím stavu vyprší po šesti minutách; změníte to v Časový limit nabídky. Otázky, které agent položí, zůstávají otevřené, dokud je někdo nezodpoví nebo je Elowen neuzavře. Platforma může akci odmítnout i tehdy, když bot nebo spárovaný účet nemá oprávnění. Discord ignoruje přímé zprávy a skupinové DM. Nástroje Telegramu potřebují připojeného bota a nástroje WhatsAppu spárované zařízení.

Společný runtime adaptérů

Discord, Telegram a WhatsApp importují zpracování otázek a projekci seřazených odpovědí z elowen-plugin-shared/ask. WhatsApp například předá aktuální otázku do parseQuestionReply(text, question) a potom promítne čekající volby pomocí collectQuestionAnswers(questions, selected, other). Prázdný nebo nepovolený text nevrátí žádnou odpověď. Zpracování prochází odeslané volby; projekce prochází každou otázku. Ovládání přenosu, autorizace odesílatele a čekající stav zůstávají v adaptéru.

Discord a Telegram používají DISPLAY_AXES z elowen-plugin-shared/display pro validaci konfigurace a pro volby příkazu zobrazení. Popisky platforem a ovládání obnovení zůstávají lokální. Výběr modelu používá resolveActiveModel, modelReasoningLevels a supportsReasoningChoice z elowen-plugin-shared/modelIdentity. Bez přepisu pro chat použijí výchozí značku katalogu a pak jeho první položku. Zmizelý výslovný přepis nevybere jiný model. Potvrzení znovu zkontroluje aktuální deskriptor, včetně obnovení výchozí hodnoty; model bez voleb uvažování ho nemůže přijmout. Tyto pomocníky používají dodaný katalog a neposílají žádné síťové požadavky.

Další: Discord