Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 

449 line
24 KiB

  1. # SOME DESCRIPTIVE TITLE.
  2. # Copyright (C) 2018-2026, Slavi Pantaleev, Aine Etke, MDAD community members
  3. # This file is distributed under the same license as the matrix-docker-ansible-deploy package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: matrix-docker-ansible-deploy \n"
  10. "Report-Msgid-Bugs-To: \n"
  11. "POT-Creation-Date: 2026-02-13 10:32+0000\n"
  12. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  13. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  14. "Language-Team: LANGUAGE <LL@li.org>\n"
  15. "MIME-Version: 1.0\n"
  16. "Content-Type: text/plain; charset=UTF-8\n"
  17. "Content-Transfer-Encoding: 8bit\n"
  18. #: ../../../docs/configuring-playbook-bot-baibot.md:8
  19. msgid "Setting up baibot (optional)"
  20. msgstr ""
  21. #: ../../../docs/configuring-playbook-bot-baibot.md:15
  22. msgid "🤖 [baibot](https://github.com/etkecc/baibot) (pronounced bye-bot) is a [Matrix](https://matrix.org/) bot developed by [etke.cc](https://etke.cc/) that exposes the power of [AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large Language Models](https://en.wikipedia.org/wiki/Large_language_model) to you. 🤖"
  23. msgstr ""
  24. #: ../../../docs/configuring-playbook-bot-baibot.md:17
  25. msgid "It supports [OpenAI](https://openai.com/)'s [ChatGPT](https://openai.com/blog/chatgpt/) models, as many well as other [☁️ providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
  26. msgstr ""
  27. #: ../../../docs/configuring-playbook-bot-baibot.md:19
  28. msgid "It's designed as a more private and [✨ featureful](https://github.com/etkecc/baibot/?tab=readme-ov-file#-features) alternative to [matrix-chatgpt-bot](./configuring-playbook-bot-chatgpt.md). See the [baibot](https://github.com/etkecc/baibot) project and its documentation for more information."
  29. msgstr ""
  30. #: ../../../docs/configuring-playbook-bot-baibot.md:21
  31. msgid "Prerequisites"
  32. msgstr ""
  33. #: ../../../docs/configuring-playbook-bot-baibot.md:23
  34. msgid "API access to one or more LLM [☁️ providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."
  35. msgstr ""
  36. #: ../../../docs/configuring-playbook-bot-baibot.md:25
  37. msgid "Adjusting the playbook configuration"
  38. msgstr ""
  39. #: ../../../docs/configuring-playbook-bot-baibot.md:27
  40. msgid "There are **a lot of configuration options** (some required, some possibly required, some optional), so they're **split into multiple sections below**:"
  41. msgstr ""
  42. #: ../../../docs/configuring-playbook-bot-baibot.md:30
  43. msgid "[Base configuration](#base-configuration)"
  44. msgstr ""
  45. #: ../../../docs/configuring-playbook-bot-baibot.md:31
  46. msgid "[👮‍♂️ Administrator configuration](#️-administrator-configuration)"
  47. msgstr ""
  48. #: ../../../docs/configuring-playbook-bot-baibot.md:32
  49. msgid "[👥 Initial users configuration](#-initial-users-configuration)"
  50. msgstr ""
  51. #: ../../../docs/configuring-playbook-bot-baibot.md:33
  52. msgid "[🤖 Configuring agents via Ansible](#-configuring-agents-via-ansible)"
  53. msgstr ""
  54. #: ../../../docs/configuring-playbook-bot-baibot.md:34
  55. msgid "[🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)"
  56. msgstr ""
  57. #: ../../../docs/configuring-playbook-bot-baibot.md:36
  58. msgid "Depending on your current `vars.yml` file and desired configuration, **you may require more than just the [base configuration](#base-configuration)**."
  59. msgstr ""
  60. #: ../../../docs/configuring-playbook-bot-baibot.md:38
  61. msgid "Base configuration"
  62. msgstr ""
  63. #: ../../../docs/configuring-playbook-bot-baibot.md:40
  64. msgid "To enable the bot, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
  65. msgstr ""
  66. #: ../../../docs/configuring-playbook-bot-baibot.md:78
  67. msgid "As mentioned above, **this may not be enough**. Continue with the configuration sections below."
  68. msgstr ""
  69. #: ../../../docs/configuring-playbook-bot-baibot.md:80
  70. msgid "👮‍♂️ Administrator configuration"
  71. msgstr ""
  72. #: ../../../docs/configuring-playbook-bot-baibot.md:82
  73. #: ../../../docs/configuring-playbook-bot-baibot.md:106
  74. msgid "This is an addition to the [base configuration](#base-configuration)."
  75. msgstr ""
  76. #: ../../../docs/configuring-playbook-bot-baibot.md:84
  77. msgid "To specify who is considered a bot [👮‍♂️ Administrator](https://github.com/etkecc/baibot/blob/main/docs/access.md#administrators), you either need to specify `matrix_bot_baibot_config_access_admin_patterns` or `matrix_admin`. The latter is a single variable which affects all bridges and bots."
  78. msgstr ""
  79. #: ../../../docs/configuring-playbook-bot-baibot.md:86
  80. msgid "If `matrix_admin` is already configured in your `vars.yml` configuration, you can skip this section."
  81. msgstr ""
  82. #: ../../../docs/configuring-playbook-bot-baibot.md:88
  83. #: ../../../docs/configuring-playbook-bot-baibot.md:117
  84. msgid "**If necessary**, add the following configuration to your `vars.yml` file:"
  85. msgstr ""
  86. #: ../../../docs/configuring-playbook-bot-baibot.md:102
  87. msgid "👥 Initial users configuration"
  88. msgstr ""
  89. #: ../../../docs/configuring-playbook-bot-baibot.md:104
  90. msgid "By default, **all users on your homeserver are considered allowed users**. If that's OK, you can skip this section."
  91. msgstr ""
  92. #: ../../../docs/configuring-playbook-bot-baibot.md:108
  93. msgid "To specify who is considered a bot [👥 User](https://github.com/etkecc/baibot/blob/main/docs/access.md#user), you may:"
  94. msgstr ""
  95. #: ../../../docs/configuring-playbook-bot-baibot.md:110
  96. msgid "define an **initial** value for `matrix_bot_baibot_config_initial_global_config_user_patterns` Ansible variable, as shown below"
  97. msgstr ""
  98. #: ../../../docs/configuring-playbook-bot-baibot.md:111
  99. msgid "configure the list at runtime via the bot's `!bai access set-users SPACE_SEPARATED_PATTERNS` command"
  100. msgstr ""
  101. #: ../../../docs/configuring-playbook-bot-baibot.md:113
  102. msgid "Configuring `matrix_bot_baibot_config_initial_global_config_user_patterns` is optional, but it can be useful to pre-configure the bot with a list of users who should have access to the bot's features."
  103. msgstr ""
  104. #: ../../../docs/configuring-playbook-bot-baibot.md:115
  105. msgid "**Note**: Once initially configured, the allowed users list **cannot be managed via Ansible anymore**. It can only be managed subsequently via bot commands."
  106. msgstr ""
  107. #: ../../../docs/configuring-playbook-bot-baibot.md:129
  108. msgid "🤖 Configuring agents via Ansible"
  109. msgstr ""
  110. #: ../../../docs/configuring-playbook-bot-baibot.md:131
  111. msgid "You are **not required** to define agents [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration) via Ansible. **To get started quickly**, you can **skip this section and define agents at runtime via chat commands** (following the bot's guidance)."
  112. msgstr ""
  113. #: ../../../docs/configuring-playbook-bot-baibot.md:133
  114. msgid "Privileged users (like the [👮‍♂️ Administrator](#️-administrator-configuration), but potentially others too — see the upstream [🔒 access](https://github.com/etkecc/baibot/blob/main/docs/access.md) documentation) can **define agents dynamically at any time** via chat commands."
  115. msgstr ""
  116. #: ../../../docs/configuring-playbook-bot-baibot.md:135
  117. msgid "The Ansible role includes preset variables for easily enabling some [🤖 agents](https://github.com/etkecc/baibot/blob/main/docs/agents.md) on various [☁️ providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md) (e.g. OpenAI, etc)."
  118. msgstr ""
  119. #: ../../../docs/configuring-playbook-bot-baibot.md:137
  120. msgid "Besides the presets, the Ansible role also includes support for configuring additional statically-defined agents via the `matrix_bot_baibot_config_agents_static_definitions_custom` Ansible variable."
  121. msgstr ""
  122. #: ../../../docs/configuring-playbook-bot-baibot.md:139
  123. msgid "Agents defined statically and those created dynamically (via chat) are named differently, so **conflict cannot arise**."
  124. msgstr ""
  125. #: ../../../docs/configuring-playbook-bot-baibot.md:141
  126. msgid "Depending on your propensity for [GitOps](https://en.wikipedia.org/wiki/DevOps#GitOps), you may prefer to define agents statically via Ansible, or you may wish to do it dynamically via chat."
  127. msgstr ""
  128. #: ../../../docs/configuring-playbook-bot-baibot.md:143
  129. msgid "Before proceeding, we recommend reading the upstream documentation on [How to choose a provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#how-to-choose-a-provider). In short, it's probably best to go with [OpenAI](#openai)."
  130. msgstr ""
  131. #: ../../../docs/configuring-playbook-bot-baibot.md:145
  132. msgid "Anthropic"
  133. msgstr ""
  134. #: ../../../docs/configuring-playbook-bot-baibot.md:147
  135. msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [Anthropic provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#anthropic) with the help of the playbook's preset variables."
  136. msgstr ""
  137. #: ../../../docs/configuring-playbook-bot-baibot.md:149
  138. #: ../../../docs/configuring-playbook-bot-baibot.md:173
  139. #: ../../../docs/configuring-playbook-bot-baibot.md:204
  140. #: ../../../docs/configuring-playbook-bot-baibot.md:232
  141. msgid "Here's an example **addition** to your `vars.yml` file:"
  142. msgstr ""
  143. #: ../../../docs/configuring-playbook-bot-baibot.md:165
  144. #: ../../../docs/configuring-playbook-bot-baibot.md:196
  145. #: ../../../docs/configuring-playbook-bot-baibot.md:222
  146. #: ../../../docs/configuring-playbook-bot-baibot.md:256
  147. msgid "If you'd like to use more than one model, take a look at the [Configuring additional agents (without a preset)](#configuring-additional-agents-without-a-preset) section below."
  148. msgstr ""
  149. #: ../../../docs/configuring-playbook-bot-baibot.md:167
  150. #: ../../../docs/configuring-playbook-bot-baibot.md:198
  151. #: ../../../docs/configuring-playbook-bot-baibot.md:224
  152. #: ../../../docs/configuring-playbook-bot-baibot.md:258
  153. msgid "💡 You may also wish to use this new agent for [🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)."
  154. msgstr ""
  155. #: ../../../docs/configuring-playbook-bot-baibot.md:169
  156. msgid "Groq"
  157. msgstr ""
  158. #: ../../../docs/configuring-playbook-bot-baibot.md:171
  159. msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [Groq provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#groq) with the help of the playbook's preset variables."
  160. msgstr ""
  161. #: ../../../docs/configuring-playbook-bot-baibot.md:194
  162. msgid "Because this is a [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agent, it will be given a `static/` ID prefix and will be named `static/groq`."
  163. msgstr ""
  164. #: ../../../docs/configuring-playbook-bot-baibot.md:200
  165. msgid "Mistral"
  166. msgstr ""
  167. #: ../../../docs/configuring-playbook-bot-baibot.md:202
  168. msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [🇫🇷 Mistral provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#mistral) with the help of the playbook's preset variables."
  169. msgstr ""
  170. #: ../../../docs/configuring-playbook-bot-baibot.md:220
  171. msgid "Because this is a [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agent, it will be given a `static/` ID prefix and will be named `static/mistral`."
  172. msgstr ""
  173. #: ../../../docs/configuring-playbook-bot-baibot.md:226
  174. msgid "OpenAI"
  175. msgstr ""
  176. #: ../../../docs/configuring-playbook-bot-baibot.md:228
  177. msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [OpenAI provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openai) with the help of the playbook's preset variables."
  178. msgstr ""
  179. #: ../../../docs/configuring-playbook-bot-baibot.md:230
  180. msgid "The OpenAI provider is **only meant to be used with OpenAI's official API** and compatibility with other services (which do not fully adhere to the OpenAI API spec completely) is limited. **If you're targeting an OpenAI-compatible service**, use the [OpenAI Compatible](#openai-compatible) provider instead."
  181. msgstr ""
  182. #: ../../../docs/configuring-playbook-bot-baibot.md:254
  183. msgid "Because this is a [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agent, it will be given a `static/` ID prefix and will be named `static/openai`."
  184. msgstr ""
  185. #: ../../../docs/configuring-playbook-bot-baibot.md:260
  186. msgid "OpenAI Compatible"
  187. msgstr ""
  188. #: ../../../docs/configuring-playbook-bot-baibot.md:262
  189. msgid "You can statically-define a single [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) instance powered by the [OpenAI Compatible provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openai-compatible) with the help of the playbook's preset variables."
  190. msgstr ""
  191. #: ../../../docs/configuring-playbook-bot-baibot.md:264
  192. msgid "This provider allows you to use OpenAI-compatible API services like [OpenRouter](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openrouter), [Together AI](https://github.com/etkecc/baibot/blob/main/docs/providers.md#together-ai), etc."
  193. msgstr ""
  194. #: ../../../docs/configuring-playbook-bot-baibot.md:266
  195. msgid "Some of these popular services already have **shortcut** providers (see [supported providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md#supported-providers) leading to this one behind the scenes — this make it easier to get started."
  196. msgstr ""
  197. #: ../../../docs/configuring-playbook-bot-baibot.md:268
  198. msgid "As of this moment, the playbook does not include presets for any of these services, so you'll need to [Configuring additional agents (without a preset)](#configuring-additional-agents-without-a-preset)."
  199. msgstr ""
  200. #: ../../../docs/configuring-playbook-bot-baibot.md:270
  201. msgid "Configuring additional agents (without a preset)"
  202. msgstr ""
  203. #: ../../../docs/configuring-playbook-bot-baibot.md:272
  204. msgid "The Ansible role may be lacking preset variables for some [☁️ provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md), or you may wish to statically-define an agent on the same provider twice (or more) with different configuration."
  205. msgstr ""
  206. #: ../../../docs/configuring-playbook-bot-baibot.md:274
  207. msgid "It's possible to inject your own agent configuration using the `matrix_bot_baibot_config_agents_static_definitions_custom` Ansible variable."
  208. msgstr ""
  209. #: ../../../docs/configuring-playbook-bot-baibot.md:276
  210. msgid "You can also define providers at runtime, by chatting with the bot, so using Ansible is not a requirement."
  211. msgstr ""
  212. #: ../../../docs/configuring-playbook-bot-baibot.md:278
  213. msgid "Below is an an **example** demonstrating **statically-defining agents via Ansible without using presets**:"
  214. msgstr ""
  215. #: ../../../docs/configuring-playbook-bot-baibot.md:317
  216. msgid "Because these are [statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md#static-configuration)-defined agents, they will be given a `static/` ID prefix and will be named `static/my-openai-gpt-3.5-turbo-agent` and `static/my-ollama-agent`, respectively."
  217. msgstr ""
  218. #: ../../../docs/configuring-playbook-bot-baibot.md:319
  219. msgid "💡 To figure out what to put in the `config` section, refer to the [☁️ provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md) page, which contains **sample configuration YAML for each provider**."
  220. msgstr ""
  221. #: ../../../docs/configuring-playbook-bot-baibot.md:321
  222. msgid "As with any [🤖 agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md), defining them means they exist. To actually make use of them, they need to be configured as handlers globally or in a specific room — see [Mixing & matching models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing--matching-models)."
  223. msgstr ""
  224. #: ../../../docs/configuring-playbook-bot-baibot.md:323
  225. msgid "💡 You may also wish to use these new agents for [🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)."
  226. msgstr ""
  227. #: ../../../docs/configuring-playbook-bot-baibot.md:325
  228. msgid "🤝 Configuring initial default handlers"
  229. msgstr ""
  230. #: ../../../docs/configuring-playbook-bot-baibot.md:327
  231. msgid "This section is only useful if you're [🤖 Configuring agents via Ansible](#-configuring-agents-via-ansible), as it lets you put these agents to use as soon as the bot starts (by adjusting the bot's **initial global configuration**)."
  232. msgstr ""
  233. #: ../../../docs/configuring-playbook-bot-baibot.md:329
  234. msgid "If you're not configuring agents via Ansible, you can skip this section."
  235. msgstr ""
  236. #: ../../../docs/configuring-playbook-bot-baibot.md:331
  237. msgid "This section is only useful the first time around. **Once initially configured the global configuration cannot be managed Ansible**, but only via bot commands."
  238. msgstr ""
  239. #: ../../../docs/configuring-playbook-bot-baibot.md:333
  240. msgid "baibot supports [various purposes](https://github.com/etkecc/baibot/blob/main/docs/features.md):"
  241. msgstr ""
  242. #: ../../../docs/configuring-playbook-bot-baibot.md:335
  243. msgid "[💬 text-generation](https://github.com/etkecc/baibot/blob/main/docs/features.md#-text-generation): communicating with you via text"
  244. msgstr ""
  245. #: ../../../docs/configuring-playbook-bot-baibot.md:337
  246. msgid "[🦻 speech-to-text](https://github.com/etkecc/baibot/blob/main/docs/features.md#-speech-to-text): turning your voice messages into text"
  247. msgstr ""
  248. #: ../../../docs/configuring-playbook-bot-baibot.md:339
  249. msgid "[🗣️ text-to-speech](https://github.com/etkecc/baibot/blob/main/docs/features.md#-text-to-speech): turning bot or users text messages into voice messages"
  250. msgstr ""
  251. #: ../../../docs/configuring-playbook-bot-baibot.md:341
  252. msgid "[🖌️ image-generation](https://github.com/etkecc/baibot/blob/main/docs/features.md#-image-generation): generating images based on instructions"
  253. msgstr ""
  254. #: ../../../docs/configuring-playbook-bot-baibot.md:343
  255. msgid "❓ catch-all: special purposes, indicating use as a fallback (when no specific handler is configured)"
  256. msgstr ""
  257. #: ../../../docs/configuring-playbook-bot-baibot.md:345
  258. msgid "[Mixing & matching models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing--matching-models) is made possible by the bot's ability to have different [🤝 handlers](https://github.com/etkecc/baibot/blob/main/docs/configuration/handlers.md) configured for different purposes."
  259. msgstr ""
  260. #: ../../../docs/configuring-playbook-bot-baibot.md:347
  261. msgid "This configuration can be done as a global fallback, or per-room. Both of these [🛠️ configurations](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md) are managed at runtime (viat chat), but **the global configuration can have some initial defaults configured via Ansible**."
  262. msgstr ""
  263. #: ../../../docs/configuring-playbook-bot-baibot.md:349
  264. msgid "You can configure the **initial values** for these via Ansible, via the `matrix_bot_baibot_config_initial_global_config_handler_*` variables."
  265. msgstr ""
  266. #: ../../../docs/configuring-playbook-bot-baibot.md:351
  267. msgid "Example **additional** `vars.yml` configuration:"
  268. msgstr ""
  269. #: ../../../docs/configuring-playbook-bot-baibot.md:368
  270. msgid "**Note**: these are initial defaults for the bot's global configuration. As such, changing any of these values subsequently has no effect on the bot's behavior. **Once initially configured the global configuration cannot be managed Ansible**, but only via bot commands."
  271. msgstr ""
  272. #: ../../../docs/configuring-playbook-bot-baibot.md:370
  273. msgid "Extending the configuration"
  274. msgstr ""
  275. #: ../../../docs/configuring-playbook-bot-baibot.md:372
  276. msgid "There are some additional things you may wish to configure about the bot."
  277. msgstr ""
  278. #: ../../../docs/configuring-playbook-bot-baibot.md:374
  279. msgid "Take a look at:"
  280. msgstr ""
  281. #: ../../../docs/configuring-playbook-bot-baibot.md:376
  282. msgid "`roles/custom/matrix-bot-baibot/defaults/main.yml` for some variables that you can customize via your `vars.yml` file"
  283. msgstr ""
  284. #: ../../../docs/configuring-playbook-bot-baibot.md:377
  285. msgid "`roles/custom/matrix-bot-baibot/templates/config.yaml.j2` for the bot's default configuration. You can override settings (even those that don't have dedicated playbook variables) using the `matrix_bot_baibot_configuration_extension_yaml` variable"
  286. msgstr ""
  287. #: ../../../docs/configuring-playbook-bot-baibot.md:379
  288. msgid "Installing"
  289. msgstr ""
  290. #: ../../../docs/configuring-playbook-bot-baibot.md:381
  291. msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
  292. msgstr ""
  293. #: ../../../docs/configuring-playbook-bot-baibot.md:388
  294. msgid "**Notes**:"
  295. msgstr ""
  296. #: ../../../docs/configuring-playbook-bot-baibot.md:390
  297. msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account."
  298. msgstr ""
  299. #: ../../../docs/configuring-playbook-bot-baibot.md:392
  300. msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
  301. msgstr ""
  302. #: ../../../docs/configuring-playbook-bot-baibot.md:394
  303. msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed."
  304. msgstr ""
  305. #: ../../../docs/configuring-playbook-bot-baibot.md:396
  306. msgid "If you change the bot password (`matrix_bot_baibot_config_user_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_bot_baibot_config_user_password` to let the bot know its new password."
  307. msgstr ""
  308. #: ../../../docs/configuring-playbook-bot-baibot.md:398
  309. msgid "Usage"
  310. msgstr ""
  311. #: ../../../docs/configuring-playbook-bot-baibot.md:400
  312. msgid "To use the bot, invite it to any existing Matrix room (`/invite @baibot:example.com` where `example.com` is your base domain, not the `matrix.` domain)."
  313. msgstr ""
  314. #: ../../../docs/configuring-playbook-bot-baibot.md:402
  315. msgid "If you're an allowed bot [👥 user](https://github.com/etkecc/baibot/blob/main/docs/access.md#user) (see [👥 Initial users configuration](#-initial-users-configuration)), the bot will accept your invitation and join the room."
  316. msgstr ""
  317. #: ../../../docs/configuring-playbook-bot-baibot.md:404
  318. msgid "After joining, the bot will introduce itself and show information about the [✨ features](https://github.com/etkecc/baibot/blob/main/docs/features.md) that are enabled for it."
  319. msgstr ""
  320. #: ../../../docs/configuring-playbook-bot-baibot.md:406
  321. msgid "If you've [🤖 configured one or more agents via Ansible](#-configuring-agents-via-ansible) and have [🤝 configured initial default handlers](#configuring-initial-default-handlers), the bot will immediately be able to make use of these agents for this new room. Otherwise, you will need to configure agents and/or handlers via chat commands."
  322. msgstr ""
  323. #: ../../../docs/configuring-playbook-bot-baibot.md:408
  324. msgid "Send `!bai help` to the bot in the room to see the available commands."
  325. msgstr ""
  326. #: ../../../docs/configuring-playbook-bot-baibot.md:410
  327. msgid "You can also refer to the upstream [baibot](https://github.com/etkecc/baibot) project's documentation."
  328. msgstr ""
  329. #: ../../../docs/configuring-playbook-bot-baibot.md:412
  330. msgid "Troubleshooting"
  331. msgstr ""
  332. #: ../../../docs/configuring-playbook-bot-baibot.md:414
  333. msgid "As with all other services, you can find the logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by logging in to the server with SSH and running `journalctl -fu matrix-bot-baibot`."
  334. msgstr ""
  335. #: ../../../docs/configuring-playbook-bot-baibot.md:416
  336. msgid "Increase logging verbosity"
  337. msgstr ""
  338. #: ../../../docs/configuring-playbook-bot-baibot.md:418
  339. msgid "The default logging level for this service is `info`. If you want to increase the verbosity to `debug` (or even `trace`), add the following configuration to your `vars.yml` file and re-run the playbook:"
  340. msgstr ""
  341. #: ../../../docs/configuring-playbook-bot-baibot.md:432
  342. msgid "**Alternatively**, you can use a single variable to set the logging level for all of the above (bot + all libraries):"
  343. msgstr ""