Pluginy pre chatovacie platformy
Pluginy Discord, Telegram a WhatsApp prepájajú Elowen s týmito chatovacími platformami. Nainštalujte ich 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álov nájdete v častiach Discord, Telegram alebo WhatsApp. Microsoft Teams je opísaný v časti Microsoft Teams & Microsoft 365.
Všetky tri vyžadujú Elowen 0.30.7 alebo novší a zdieľané API verzie 14. Aktuálnu verziu každého pluginu nájdete v registri.
Tieto pluginy môže inštalovať, zapínať a konfigurovať iba administrátor. Tokeny botov Discord a Telegram sa ukladajú ako tajné hodnoty; ich nastavenia ukazujú len to, či je token nastavený, nie jeho hodnotu. WhatsApp používa uloženú reláciu prepojeného zariadenia. Discord a Telegram zaregistrujú svoje nástroje, keď je nastavený token bota, a nástroje WhatsAppu potrebujú spárované zariadenie, aby sa dostali k platforme.
Ako funguje prístup k platformám
O tom, komu bot odpovedá, rozhoduje zásada rolí pri Discorde a Telegrame alebo zásada odosielateľa pri WhatsAppu; môže tiež pridať pokyny pre zdieľanú miestnosť. Nastavte aspoň jednu zásadu. Platí prvá zodpovedajúca pomenovaná zásada a pravidlo * pre všetkých sa vyhodnocuje až po pomenovaných pravidlách, nech je jeho poradie akékoľvek. Odosielateľ, ktorý nezodpovedá žiadnej zásade, sa ignoruje. Zásada nenahrádza identitu: odosielateľ tiež potrebuje prepojený účet Elowen, ktorého prístup k Projektom a oprávnenia nástrojov platia pre dané kolo.
Každý chat alebo kanál má vlastnú konverzáciu a môže mať vlastný model a nastavenia zobrazenia. Novú konverzáciu tam začnete príkazom /new. Príkaz /context môže do chatu platformy priniesť jednu z vašich konverzácií. Obrázky sa posielajú nastavenému modelu pre obrázky; na ostatné prílohy platia limity médií pluginu. Adaptéry vedia zobrazovať priebeh nástrojov a stavové reakcie podľa platformy a jej nastavení.
Príkazy /compact, /fast a /restart v miestnosti sa zaznamenajú do konverzácie daného chatu, takže agent vidí, že prebehli, a odpoveď na neúspešný príkaz uvádza skutočnú chybu. Pluginy zdieľajú toto spracovanie príkazov cez pomocníkov platformy v Elowen.
Nastavte cieľ oznámení, aby ste dostávali proaktívne správy, napríklad výsledky naplánovaných úloh. Ak pole necháte prázdne, tieto správy sa vypnú.
Stránky pluginov
- Discord: nastavenia bota, pripojenia a prístupu, odpovede a zobrazenie, limity konverzácie a médií, hlas a 25 nástrojov servera.
- Telegram: nastavenia bota, pripojenia a prístupu, odpovede a médiá, hlas a 16 chatových nástrojov.
- WhatsApp: párovanie zariadenia, zásady odosielateľov, odpovede a médiá, hlas a šesť nástrojov:
WhatsappSenda päť skupinových nástrojov.
Limity správ a príloh
Adaptéry platforiem delia dlhé odpovede na správy s najviac 1 990 znakmi na Discorde, 4 000 na Telegrame a 4 000 na WhatsAppu. Popisy fotografií a dokumentov na Telegrame a WhatsAppu sú obmedzené na 1 024 znakov. Každá platforma povoľuje najviac štyri zdieľané súbory na odpoveď. Zvuk do 25 MiB na Discorde, Telegrame a WhatsAppu používa zdieľanú hlasovú službu Elowen. Natívna hlasová správa dostane textovú odpoveď a za ňou hlasovú odpoveď OGG/Opus; bežné zvukové prílohy na Discorde a Telegrame dostanú iba text. Hlas musí byť zapnutý a oprávnenia a limity útraty patria prepojenému účtu. Odmietnutý alebo neúspešný prepis zachová poznámku o prílohe; odmietnutá alebo neúspešná reč ponechá textovú odpoveď.
Číslované ponuky Telegramu a WhatsAppu, napríklad /model, predvolene vypršia po šiestich minútach; zmeníte to v Časový limit ponuky. Otázky, ktoré agent položí, zostávajú otvorené, kým ich niekto nezodpovie alebo ich Elowen neuzavrie. Platforma môže akciu odmietnuť aj vtedy, keď bot alebo spárovaný účet nemá oprávnenie. Discord ignoruje priame správy a skupinové DM. Nástroje Telegramu potrebujú pripojeného bota a nástroje WhatsAppu spárované zariadenie.
Spoločný runtime adaptérov
Discord, Telegram a WhatsApp importujú spracovanie otázok a projekciu zoradených odpovedí z elowen-plugin-shared/ask. WhatsApp napríklad odovzdá aktuálnu otázku do parseQuestionReply(text, question) a potom premietne čakajúce voľby pomocou collectQuestionAnswers(questions, selected, other). Prázdny alebo nepovolený text nevráti žiadnu odpoveď. Spracovanie prechádza odoslané voľby; projekcia prechádza každú otázku. Ovládanie prenosu, autorizácia odosielateľa a čakajúci stav zostávajú v adaptéri.
Discord a Telegram používajú DISPLAY_AXES z elowen-plugin-shared/display na validáciu konfigurácie a na voľby príkazu zobrazenia. Popisy platforiem a ovládanie obnovenia zostávajú lokálne. Výber modelu používa resolveActiveModel, modelReasoningLevels a supportsReasoningChoice z elowen-plugin-shared/modelIdentity. Bez prepisu pre chat použijú predvolenú značku katalógu a potom jeho prvú položku. Zmiznutý výslovný prepis nevyberie iný model. Potvrdenie znova skontroluje aktuálny deskriptor vrátane obnovenia predvolenej hodnoty; model bez volieb uvažovania ho nemôže prijať. Tieto pomocníky používajú dodaný katalóg a neposielajú žiadne sieťové požiadavky.