ربات‌ها
حساب‌هایی روی سرور شما که کاری انجام می‌دهند: با هوش مصنوعی پاسخ می‌دهند، یادآوری می‌کنند، میز پشتیبانی راه می‌اندازند و ارسال‌کنندگان هرزنامه را دور نگه می‌دارند.
روش افزودن هر یک: مؤلفه‌ها.
ربات‌ها نیز مانند بریج‌ها روی دامنه‌ی اصلی شما قرار دارند: @baibot:example.org،
نه …:matrix.example.org. گذرواژه‌ی ربات‌ها به‌طور خودکار ساخته می‌شود؛ ctrl+r
در Settings آن‌ها را نشان می‌دهد.
دریافت توکن دسترسی یک ربات، که برخی از ربات‌ها به آن نیاز دارند: (پس از
نخستین استقرار) با Manage › Add a user (a) حساب آن را بسازید، در Element
با آن وارد شوید (یک پنجره‌ی خصوصی مرورگر مفید است)، توکن را از Settings › Help
& About › Advanced › Access Token کپی کنید و سپس پنجره را بدون خروج از
حساب ببندید: خروج از حساب توکن را باطل می‌کند. Draupnir استثناست؛ پایین‌تر را
ببینید.
ربات هوش مصنوعی (baibot)
گفتگو با مدل‌های هوش مصنوعی (OpenAI، Anthropic، Groq، Mistral، یک Ollama محلی و…) در هر اتاقی: متن، تصویر، تبدیل گفتار به متن و برعکس.
ربات: @baibot:example.org
تنظیمات: یک bot password، یک recovery passphrase و دو encryption key که همگی به‌طور خودکار ساخته می‌شوند؛ آن‌ها را نگه دارید، زیرا داده‌های رمزنگاری‌شده‌ی ربات به آن‌ها نیاز دارد.
استفاده: ربات را به یک اتاق دعوت کنید؛ خودش را معرفی می‌کند. !bai help را
بفرستید. پیش از آنکه بتواند پاسخ دهد، مدیر آن (حساب مدیر شما) باید یک agent
اضافه کند: یک سرویس هوش مصنوعی با کلید API خودتان. !bai agent را بفرستید و
دستورالعمل ربات را دنبال کنید؛
راهنمای agentها
سرویس‌ها را فهرست کرده است. به‌طور پیش‌فرض همه‌ی کاربران سرور شما می‌توانند از آن
استفاده کنند.
مستندات ·
مستندات baibot
ربات یادآوری (matrix-reminder-bot)
ربات: @bot.matrix-reminder-bot:example.org
تنظیمات: یک bot password (به‌طور خودکار ساخته می‌شود) و منطقه‌ی زمانی
شما (timezone)، برای نمونه Asia/Tehran.
استفاده: با آن گفتگو را آغاز کنید یا آن را به یک اتاق دعوت کنید و
!remindme in 2 hours; call mum را بفرستید. !help reminders باقی فرمان‌ها،
از جمله یادآوری‌های تکرارشونده و هشدارها، را فهرست می‌کند.
مستندات
میزبان افزونه‌ها (maubot)
میزبانی برای ربات‌های افزونه‌ای: تاس، نظرسنجی، RSS، ترجمه، گیت‌هاب، امتیازدهی و بسیاری دیگر.
تنظیمات:
- گذرواژه‌ی ربات (Bot password): برای حساب
@bot.maubot:example.org، به‌طور خودکار ساخته می‌شود. - مدیران پنل (Management UI admins): کسانی که می‌توانند وارد رابط وب شوند، به
شکل
- username: password. مقدارCHANGE_MEرا حتماً به یک گذرواژه‌ی واقعی تغییر دهید.
استفاده: نشانی https://matrix.example.org/_matrix/maubot/ را باز کنید و با
همان نام کاربری و گذرواژه وارد شوید. سپس:
۱. بخش Clients، دکمه‌ی +: حساب ماتریکسی که ربات به نام آن سخن می‌گوید.
@bot.maubot با توکن دسترسی‌اش (بالا را ببینید) آماده‌ی استفاده است.
۲. بخش Plugins، دکمه‌ی +: فایل .mbp یک افزونه را بارگذاری کنید.
۳. بخش Instances، دکمه‌ی +: یک کلاینت و یک افزونه را با هم ترکیب کنید. ربات
همین است.
مستندات ·
مستندات maubot
میز پشتیبانی با Honoroit
کاربران به ربات پیام می‌دهند؛ هر گفتگو به یک رشته در اتاق تیم شما تبدیل می‌شود و پاسخ‌های تیم به آن‌ها بازگردانده می‌شود.
تنظیمات:
- گذرواژه‌ی ربات (Bot password): به‌طور خودکار ساخته می‌شود.
- شناسه‌ی اتاق پشتیبانی (Helpdesk room ID): ابتدا اتاق تیم را بسازید، سپس
شناسه‌ی آن را از Room settings › Advanced کپی کنید (شبیه
!abc123:example.orgاست).
استفاده: @honoroit:example.org را به آن اتاق دعوت کنید. هر کسی به ربات پیام
دهد، یک رشته در آنجا باز می‌کند. !ho help فرمان‌ها را فهرست می‌کند.
مستندات
ربات نظارت Draupnir
یک ربات نظارت: ارسال‌کنندگان هرزنامه را به‌طور هم‌زمان از همه‌ی اتاق‌های شما مسدود می‌کند، فهرست‌های مسدودی انجمن‌ها را دنبال می‌کند و محافظت‌هایی دارد، مانند قفل کردن اتاق هنگام ورود ناگهانی تعداد زیادی حساب.
به یک حساب و توکن دسترسی نیاز دارد، بنابراین آن را پس از نخستین استقرار اضافه کنید:
۱. از Manage › Add a user (a): bot.draupnir، بدون دسترسی مدیر.
۲. توکن آن را با curl دریافت کنید، نه از Element (Draupnir توکنی را که با
رمزنگاری سروکار داشته است نمی‌پذیرد). روی رایانه‌ی خود:
curl -X POST https://matrix.example.org/_matrix/client/v3/login \
-d '{"type":"m.login.password","identifier":{"type":"m.id.user","user":"bot.draupnir"},"password":"THE_PASSWORD"}'
مقدار access_token را از پاسخ کپی کنید.
۳. گزینه‌ی Draupnir را انتخاب کنید و Initial manager MXID (خودتان،
@admin:example.org) و Bot access token را پر کنید. استقرار را اجرا کنید.
استفاده: ربات یک management room می‌سازد و شما را دعوت می‌کند؛ از آنجا
به آن فرمان می‌دهید. برای هر اتاقی که باید محافظت شود: ربات را دعوت کنید، به آن
سطح Administrator بدهید و در اتاق مدیریت
!draupnir rooms add !ROOMID:example.org را بفرستید. برای دنبال کردن یک فهرست
مسدودی انجمن از !draupnir watch #community-moderation-effort-bl:neko.dev
استفاده کنید؛ مسدود کردن با !draupnir ban @spammer:example.com my-bans spam
انجام می‌شود (پس از !draupnir list create my-bans my-bans-bl). باقی موارد در
!draupnir help آمده است.
مستندات ·
مستندات Draupnir
دراپنیر برای همه (Draupnir for all، D4A)
دراپنیر به‌صورت سرویس: یک نصب، به هر انجمنی که درخواست کند یک Draupnir جداگانه می‌دهد. هنوز در مرحله‌ی آلفاست؛ برای یک انجمن، همان Draupnir ساده‌تر است.
تنظیمات: Initial manager MXID: خودتان.
استفاده: ربات شما را به اتاق مدیریت خود دعوت می‌کند. با
/plain !admin allow @alice:example.org (یا @*:example.org برای همه‌ی کاربران)
به کسی اجازه دهید، سپس با !admin provision @alice:example.org یک ربات به او
بدهید.
مستندات
ربات نظارت Mjolnir
ربات نظارت قدیمی‌تری که Draupnir از آن منشعب شده است. برای سرور جدید Draupnir را انتخاب کنید.
تنظیمات:
- توکن ربات (Bot access token): حساب
bot.mjolnirرا با Add a user بسازید و توکن آن را به روشی که در بالا آمد دریافت کنید. - شناسه‌ی اتاق مدیریت (Management room ID): یک اتاق خصوصی بسازید، ربات را دعوت کنید و شناسه‌ی اتاق را از Room settings › Advanced کپی کنید.
استفاده: در اتاق مدیریت، !mjolnir help. در اتاق‌هایی که از آن‌ها محافظت
می‌کند، به ربات سطح Administrator بدهید.
مستندات ·
شروع سریع Mjolnir
ربات نظارت Meowlnir
یک ربات نظارت از سازندگان mautrix که همان فهرست‌های مسدودی Draupnir و Mjolnir را می‌خواند و اجازه می‌دهد فهرست خودتان بر فهرست انجمن اولویت داشته باشد.
تنظیمات: ربات‌ها (Bots): نمونه‌ی آن یک ربات @meowlnir_bot و اتاق مدیریت
آن را می‌سازد و حساب مدیر شما را به آنجا دعوت می‌کند؛ می‌تواند بدون تغییر بماند.
استفاده: دعوت را بپذیرید. در اتاق مدیریت،
!lists subscribe #community-moderation-effort-bl:neko.dev cme یک فهرست مسدودی
را دنبال می‌کند. برای محافظت از یک اتاق، ربات را دعوت کنید، سطح دسترسی 100
به آن بدهید و سپس !rooms protect !ROOMID:example.org را بفرستید.
مستندات ·
مستندات Meowlnir
فرم وب‌سایت با Buscarron
آنچه کاربران از طریق یک فرم در وب‌سایت شما می‌فرستند را در یک اتاق ماتریکس منتشر می‌کند.
رکورد DNS: buscarron.example.org.
تنظیمات:
- گذرواژه‌ی ربات (Bot password): به‌طور خودکار ساخته می‌شود.
- فرم‌ها (Forms): برای هر فرم یک بلوک.
nameنشانی فرم است (https://buscarron.example.org/contact)،roomشناسه‌ی اتاقی که در آن منتشر می‌کند وredirectصفحه‌ای که بازدیدکننده پس از آن به آن هدایت می‌شود.
استفاده: @bot.buscarron:example.org را به اتاق دعوت کنید و فرم خود را به آن
متصل کنید: <form method="POST" action="https://buscarron.example.org/contact">.
برای جلوگیری از هرزنامه، هر کسی را که صفحه‌ی اصلی آن را باز کند یا به فرم
نادرستی ارسال کند مسدود می‌کند؛ آن را به این روش آزمایش نکنید.
مستندات