overmind
/
matrix-docker-ansible-deploy
镜像来自 https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
複製 0
程式碼 問題管理 0 版本發佈 0 Wiki Activity
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.
8820 Commit
5 分支
418 MiB
 
 
 
目錄樹: c51e771d1a
分支列表 標籤列表
${ item.name }
Create branch ${ searchTerm }
from 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-bot-ba...

689 line
24 KiB
原始文件 Blame 文件歷史 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community

  3. # members

  4. # This file is distributed under the same license as the

  5. # matrix-docker-ansible-deploy package.

  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.

  7. #

  8. #, fuzzy

  9. msgid ""

  10. msgstr ""

  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  12. "Report-Msgid-Bugs-To: \n"

  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"

  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  16. "Language: bg\n"

  17. "Language-Team: bg <LL@li.org>\n"

  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  19. "MIME-Version: 1.0\n"

  20. "Content-Type: text/plain; charset=utf-8\n"

  21. "Content-Transfer-Encoding: 8bit\n"

  22. "Generated-By: Babel 2.16.0\n"

  23. 

  24. #: ../../../docs/configuring-playbook-bot-baibot.md:1

  25. msgid "Setting up baibot (optional)"

  26. msgstr ""

  27. 

  28. #: ../../../docs/configuring-playbook-bot-baibot.md:8

  29. msgid ""

  30. "🤖 [baibot](https://github.com/etkecc/baibot) (pronounced bye-bot) is a "

  31. "[Matrix](https://matrix.org/) bot developed by "

  32. "[etke.cc](https://etke.cc/) that exposes the power of "

  33. "[AI](https://en.wikipedia.org/wiki/Artificial_intelligence) / [Large "

  34. "Language Models](https://en.wikipedia.org/wiki/Large_language_model) to "

  35. "you. 🤖"

  36. msgstr ""

  37. 

  38. #: ../../../docs/configuring-playbook-bot-baibot.md:10

  39. msgid ""

  40. "It supports [OpenAI](https://openai.com/)'s "

  41. "[ChatGPT](https://openai.com/blog/chatgpt/) models, as many well as other"

  42. " [☁️ "

  43. "providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."

  44. msgstr ""

  45. 

  46. #: ../../../docs/configuring-playbook-bot-baibot.md:12

  47. msgid ""

  48. "It's designed as a more private and [✨ "

  49. "featureful](https://github.com/etkecc/baibot/?tab=readme-ov-"

  50. "file#-features) alternative to [matrix-chatgpt-bot](./configuring-"

  51. "playbook-bot-chatgpt.md). See the "

  52. "[baibot](https://github.com/etkecc/baibot) project and its documentation "

  53. "for more information."

  54. msgstr ""

  55. 

  56. #: ../../../docs/configuring-playbook-bot-baibot.md:14

  57. msgid "Prerequisites"

  58. msgstr ""

  59. 

  60. #: ../../../docs/configuring-playbook-bot-baibot.md:16

  61. msgid ""

  62. "API access to one or more LLM [☁️ "

  63. "providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)."

  64. msgstr ""

  65. 

  66. #: ../../../docs/configuring-playbook-bot-baibot.md:18

  67. msgid "Adjusting the playbook configuration"

  68. msgstr ""

  69. 

  70. #: ../../../docs/configuring-playbook-bot-baibot.md:20

  71. msgid ""

  72. "There are **a lot of configuration options** (some required, some "

  73. "possibly required, some optional), so they're **split into multiple "

  74. "sections below**:"

  75. msgstr ""

  76. 

  77. #: ../../../docs/configuring-playbook-bot-baibot.md:23

  78. msgid "[Base configuration](#base-configuration)"

  79. msgstr ""

  80. 

  81. #: ../../../docs/configuring-playbook-bot-baibot.md:24

  82. msgid "[👮‍♂️ Administrator configuration](#️-administrator-configuration)"

  83. msgstr ""

  84. 

  85. #: ../../../docs/configuring-playbook-bot-baibot.md:25

  86. msgid "[👥 Initial users configuration](#-initial-users-configuration)"

  87. msgstr ""

  88. 

  89. #: ../../../docs/configuring-playbook-bot-baibot.md:26

  90. msgid "[🤖 Configuring agents via Ansible](#-configuring-agents-via-ansible)"

  91. msgstr ""

  92. 

  93. #: ../../../docs/configuring-playbook-bot-baibot.md:27

  94. msgid ""

  95. "[🤝 Configuring initial default handlers](#-configuring-initial-default-"

  96. "handlers)"

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-bot-baibot.md:29

  100. msgid ""

  101. "Depending on your current `vars.yml` file and desired configuration, "

  102. "**you may require more than just the [base configuration](#base-"

  103. "configuration)**."

  104. msgstr ""

  105. 

  106. #: ../../../docs/configuring-playbook-bot-baibot.md:31

  107. msgid "Base configuration"

  108. msgstr ""

  109. 

  110. #: ../../../docs/configuring-playbook-bot-baibot.md:33

  111. msgid ""

  112. "Add the following configuration to your "

  113. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  114. msgstr ""

  115. 

  116. #: ../../../docs/configuring-playbook-bot-baibot.md:71

  117. msgid ""

  118. "As mentioned above, **this may not be enough**. Continue with the "

  119. "configuration sections below."

  120. msgstr ""

  121. 

  122. #: ../../../docs/configuring-playbook-bot-baibot.md:73

  123. msgid "👮‍♂️ Administrator configuration"

  124. msgstr ""

  125. 

  126. #: ../../../docs/configuring-playbook-bot-baibot.md:75

  127. #: ../../../docs/configuring-playbook-bot-baibot.md:99

  128. msgid "This is an addition to the [base configuration](#base-configuration)."

  129. msgstr ""

  130. 

  131. #: ../../../docs/configuring-playbook-bot-baibot.md:77

  132. msgid ""

  133. "To specify who is considered a bot [👮‍♂️ "

  134. "Administrator](https://github.com/etkecc/baibot/blob/main/docs/access.md#administrators),"

  135. " you either need to specify "

  136. "`matrix_bot_baibot_config_access_admin_patterns` or `matrix_admin`. The "

  137. "latter is a single variable which affects all bridges and bots."

  138. msgstr ""

  139. 

  140. #: ../../../docs/configuring-playbook-bot-baibot.md:79

  141. msgid ""

  142. "If `matrix_admin` is already configured in your `vars.yml` configuration,"

  143. " you can skip this section."

  144. msgstr ""

  145. 

  146. #: ../../../docs/configuring-playbook-bot-baibot.md:81

  147. #: ../../../docs/configuring-playbook-bot-baibot.md:110

  148. msgid ""

  149. "**If necessary**, add the following configuration to your "

  150. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  151. msgstr ""

  152. 

  153. #: ../../../docs/configuring-playbook-bot-baibot.md:95

  154. msgid "👥 Initial users configuration"

  155. msgstr ""

  156. 

  157. #: ../../../docs/configuring-playbook-bot-baibot.md:97

  158. msgid ""

  159. "By default, **all users on your homeserver are considered allowed "

  160. "users**. If that's OK, you can skip this section."

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-bot-baibot.md:101

  164. msgid ""

  165. "To specify who is considered a bot [👥 "

  166. "User](https://github.com/etkecc/baibot/blob/main/docs/access.md#user), "

  167. "you may:"

  168. msgstr ""

  169. 

  170. #: ../../../docs/configuring-playbook-bot-baibot.md:103

  171. msgid ""

  172. "define an **initial** value for "

  173. "`matrix_bot_baibot_config_initial_global_config_user_patterns` Ansible "

  174. "variable, as shown below"

  175. msgstr ""

  176. 

  177. #: ../../../docs/configuring-playbook-bot-baibot.md:104

  178. msgid ""

  179. "configure the list at runtime via the bot's `!bai access set-users "

  180. "SPACE_SEPARATED_PATTERNS` command"

  181. msgstr ""

  182. 

  183. #: ../../../docs/configuring-playbook-bot-baibot.md:106

  184. msgid ""

  185. "Configuring "

  186. "`matrix_bot_baibot_config_initial_global_config_user_patterns` is "

  187. "optional, but it can be useful to pre-configure the bot with a list of "

  188. "users who should have access to the bot's features."

  189. msgstr ""

  190. 

  191. #: ../../../docs/configuring-playbook-bot-baibot.md:108

  192. msgid ""

  193. "**Note**: Once initially configured, the allowed users list **cannot be "

  194. "managed via Ansible anymore**. It can only be managed subsequently via "

  195. "bot commands."

  196. msgstr ""

  197. 

  198. #: ../../../docs/configuring-playbook-bot-baibot.md:122

  199. msgid "🤖 Configuring agents via Ansible"

  200. msgstr ""

  201. 

  202. #: ../../../docs/configuring-playbook-bot-baibot.md:124

  203. msgid ""

  204. "You are **not required** to define agents "

  205. "[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"

  206. "#static-configuration) via Ansible. **To get started quickly**, you can "

  207. "**skip this section and define agents at runtime via chat commands** "

  208. "(following the bot's guidance)."

  209. msgstr ""

  210. 

  211. #: ../../../docs/configuring-playbook-bot-baibot.md:126

  212. msgid ""

  213. "Privileged users (like the [👮‍♂️ Administrator](#️-administrator-"

  214. "configuration), but potentially others too - see the upstream [🔒 "

  215. "access](https://github.com/etkecc/baibot/blob/main/docs/access.md) "

  216. "documentation) can **define agents dynamically at any time** via chat "

  217. "commands."

  218. msgstr ""

  219. 

  220. #: ../../../docs/configuring-playbook-bot-baibot.md:128

  221. msgid ""

  222. "The Ansible role includes preset variables for easily enabling some [🤖 "

  223. "agents](https://github.com/etkecc/baibot/blob/main/docs/agents.md) on "

  224. "various [☁️ "

  225. "providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md) "

  226. "(e.g. OpenAI, etc)."

  227. msgstr ""

  228. 

  229. #: ../../../docs/configuring-playbook-bot-baibot.md:130

  230. msgid ""

  231. "Besides the presets, the Ansible role also includes support for "

  232. "configuring additional statically-defined agents via the "

  233. "`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "

  234. "variable."

  235. msgstr ""

  236. 

  237. #: ../../../docs/configuring-playbook-bot-baibot.md:132

  238. msgid ""

  239. "Agents defined statically and those created dynamically (via chat) are "

  240. "named differently, so **conflict cannot arise**."

  241. msgstr ""

  242. 

  243. #: ../../../docs/configuring-playbook-bot-baibot.md:134

  244. msgid ""

  245. "Depending on your propensity for "

  246. "[GitOps](https://en.wikipedia.org/wiki/DevOps#GitOps), you may prefer to "

  247. "define agents statically via Ansible, or you may wish to do it "

  248. "dynamically via chat."

  249. msgstr ""

  250. 

  251. #: ../../../docs/configuring-playbook-bot-baibot.md:136

  252. msgid ""

  253. "Before proceeding, we recommend reading the upstream documentation on "

  254. "[How to choose a "

  255. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md"

  256. "#how-to-choose-a-provider). In short, it's probably best to go with "

  257. "[OpenAI](#openai)."

  258. msgstr ""

  259. 

  260. #: ../../../docs/configuring-playbook-bot-baibot.md:138

  261. msgid "Anthropic"

  262. msgstr ""

  263. 

  264. #: ../../../docs/configuring-playbook-bot-baibot.md:140

  265. msgid ""

  266. "You can statically-define a single [🤖 "

  267. "agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "

  268. "instance powered by the [Anthropic "

  269. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#anthropic)"

  270. " with the help of the playbook's preset variables."

  271. msgstr ""

  272. 

  273. #: ../../../docs/configuring-playbook-bot-baibot.md:142

  274. #: ../../../docs/configuring-playbook-bot-baibot.md:168

  275. #: ../../../docs/configuring-playbook-bot-baibot.md:201

  276. #: ../../../docs/configuring-playbook-bot-baibot.md:231

  277. msgid "Here's an example **addition** to your `vars.yml` file:"

  278. msgstr ""

  279. 

  280. #: ../../../docs/configuring-playbook-bot-baibot.md:160

  281. #: ../../../docs/configuring-playbook-bot-baibot.md:193

  282. #: ../../../docs/configuring-playbook-bot-baibot.md:221

  283. #: ../../../docs/configuring-playbook-bot-baibot.md:251

  284. msgid ""

  285. "If you'd like to use more than one model, take a look at the [Configuring"

  286. " additional agents (without a preset)](#configuring-additional-agents-"

  287. "without-a-preset) section below."

  288. msgstr ""

  289. 

  290. #: ../../../docs/configuring-playbook-bot-baibot.md:162

  291. #: ../../../docs/configuring-playbook-bot-baibot.md:195

  292. #: ../../../docs/configuring-playbook-bot-baibot.md:223

  293. #: ../../../docs/configuring-playbook-bot-baibot.md:253

  294. msgid ""

  295. "💡 You may also wish to use this new agent for [🤝 Configuring initial "

  296. "default handlers](#-configuring-initial-default-handlers)."

  297. msgstr ""

  298. 

  299. #: ../../../docs/configuring-playbook-bot-baibot.md:164

  300. msgid "Groq"

  301. msgstr ""

  302. 

  303. #: ../../../docs/configuring-playbook-bot-baibot.md:166

  304. msgid ""

  305. "You can statically-define a single [🤖 "

  306. "agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "

  307. "instance powered by the [Groq "

  308. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#groq)"

  309. " with the help of the playbook's preset variables."

  310. msgstr ""

  311. 

  312. #: ../../../docs/configuring-playbook-bot-baibot.md:191

  313. msgid ""

  314. "Because this is a "

  315. "[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"

  316. "#static-configuration)-defined agent, it will be given a `static/` ID "

  317. "prefix and will be named `static/groq`."

  318. msgstr ""

  319. 

  320. #: ../../../docs/configuring-playbook-bot-baibot.md:197

  321. msgid "Mistral"

  322. msgstr ""

  323. 

  324. #: ../../../docs/configuring-playbook-bot-baibot.md:199

  325. msgid ""

  326. "You can statically-define a single [🤖 "

  327. "agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "

  328. "instance powered by the [🇫🇷 Mistral "

  329. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#mistral)"

  330. " with the help of the playbook's preset variables."

  331. msgstr ""

  332. 

  333. #: ../../../docs/configuring-playbook-bot-baibot.md:219

  334. msgid ""

  335. "Because this is a "

  336. "[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"

  337. "#static-configuration)-defined agent, it will be given a `static/` ID "

  338. "prefix and will be named `static/mistral`."

  339. msgstr ""

  340. 

  341. #: ../../../docs/configuring-playbook-bot-baibot.md:225

  342. msgid "OpenAI"

  343. msgstr ""

  344. 

  345. #: ../../../docs/configuring-playbook-bot-baibot.md:227

  346. msgid ""

  347. "You can statically-define a single [🤖 "

  348. "agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "

  349. "instance powered by the [OpenAI "

  350. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openai)"

  351. " with the help of the playbook's preset variables."

  352. msgstr ""

  353. 

  354. #: ../../../docs/configuring-playbook-bot-baibot.md:229

  355. msgid ""

  356. "The OpenAI provider is **only meant to be used with OpenAI's official "

  357. "API** and compatibility with other services (which do not fully adhere to"

  358. " the OpenAI API spec completely) is limited. **If you're targeting an "

  359. "OpenAI-compatible service**, use the [OpenAI Compatible](#openai-"

  360. "compatible) provider instead."

  361. msgstr ""

  362. 

  363. #: ../../../docs/configuring-playbook-bot-baibot.md:249

  364. msgid ""

  365. "Because this is a "

  366. "[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"

  367. "#static-configuration)-defined agent, it will be given a `static/` ID "

  368. "prefix and will be named `static/openai`."

  369. msgstr ""

  370. 

  371. #: ../../../docs/configuring-playbook-bot-baibot.md:255

  372. msgid "OpenAI Compatible"

  373. msgstr ""

  374. 

  375. #: ../../../docs/configuring-playbook-bot-baibot.md:257

  376. msgid ""

  377. "You can statically-define a single [🤖 "

  378. "agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md) "

  379. "instance powered by the [OpenAI Compatible "

  380. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md"

  381. "#openai-compatible) with the help of the playbook's preset variables."

  382. msgstr ""

  383. 

  384. #: ../../../docs/configuring-playbook-bot-baibot.md:259

  385. msgid ""

  386. "This provider allows you to use OpenAI-compatible API services like "

  387. "[OpenRouter](https://github.com/etkecc/baibot/blob/main/docs/providers.md#openrouter),"

  388. " [Together "

  389. "AI](https://github.com/etkecc/baibot/blob/main/docs/providers.md"

  390. "#together-ai), etc."

  391. msgstr ""

  392. 

  393. #: ../../../docs/configuring-playbook-bot-baibot.md:261

  394. msgid ""

  395. "Some of these popular services already have **shortcut** providers (see "

  396. "[supported "

  397. "providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md"

  398. "#supported-providers) leading to this one behind the scenes - this make "

  399. "it easier to get started."

  400. msgstr ""

  401. 

  402. #: ../../../docs/configuring-playbook-bot-baibot.md:263

  403. msgid ""

  404. "As of this moment, the playbook does not include presets for any of these"

  405. " services, so you'll need to [Configuring additional agents (without a "

  406. "preset)](#configuring-additional-agents-without-a-preset)."

  407. msgstr ""

  408. 

  409. #: ../../../docs/configuring-playbook-bot-baibot.md:265

  410. msgid "Configuring additional agents (without a preset)"

  411. msgstr ""

  412. 

  413. #: ../../../docs/configuring-playbook-bot-baibot.md:267

  414. msgid ""

  415. "The Ansible role may be lacking preset variables for some [☁️ "

  416. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md), "

  417. "or you may wish to statically-define an agent on the same provider twice "

  418. "(or more) with different configuration."

  419. msgstr ""

  420. 

  421. #: ../../../docs/configuring-playbook-bot-baibot.md:269

  422. msgid ""

  423. "It's possible to inject your own agent configuration using the "

  424. "`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "

  425. "variable."

  426. msgstr ""

  427. 

  428. #: ../../../docs/configuring-playbook-bot-baibot.md:271

  429. msgid ""

  430. "You can also define providers at runtime, by chatting with the bot, so "

  431. "using Ansible is not a requirement."

  432. msgstr ""

  433. 

  434. #: ../../../docs/configuring-playbook-bot-baibot.md:273

  435. msgid ""

  436. "Below is an an **example** demonstrating **statically-defining agents via"

  437. " Ansible without using presets**:"

  438. msgstr ""

  439. 

  440. #: ../../../docs/configuring-playbook-bot-baibot.md:312

  441. msgid ""

  442. "Because these are "

  443. "[statically](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md"

  444. "#static-configuration)-defined agents, they will be given a `static/` ID "

  445. "prefix and will be named `static/my-openai-gpt-3.5-turbo-agent` and "

  446. "`static/my-ollama-agent`, respectively."

  447. msgstr ""

  448. 

  449. #: ../../../docs/configuring-playbook-bot-baibot.md:314

  450. msgid ""

  451. "💡 To figure out what to put in the `config` section, refer to the [☁️ "

  452. "provider](https://github.com/etkecc/baibot/blob/main/docs/providers.md) "

  453. "page, which contains **sample configuration YAML for each provider**."

  454. msgstr ""

  455. 

  456. #: ../../../docs/configuring-playbook-bot-baibot.md:316

  457. msgid ""

  458. "As with any [🤖 "

  459. "agent](https://github.com/etkecc/baibot/blob/main/docs/agents.md), "

  460. "defining them means they exist. To actually make use of them, they need "

  461. "to be configured as handlers globally or in a specific room - see [Mixing"

  462. " & matching "

  463. "models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing"

  464. "--matching-models)."

  465. msgstr ""

  466. 

  467. #: ../../../docs/configuring-playbook-bot-baibot.md:318

  468. msgid ""

  469. "💡 You may also wish to use these new agents for [🤝 Configuring initial "

  470. "default handlers](#-configuring-initial-default-handlers)."

  471. msgstr ""

  472. 

  473. #: ../../../docs/configuring-playbook-bot-baibot.md:320

  474. msgid "🤝 Configuring initial default handlers"

  475. msgstr ""

  476. 

  477. #: ../../../docs/configuring-playbook-bot-baibot.md:322

  478. msgid ""

  479. "This section is only useful if you're [🤖 Configuring agents via Ansible"

  480. "](#-configuring-agents-via-ansible), as it lets you put these agents to "

  481. "use as soon as the bot starts (by adjusting the bot's **initial global "

  482. "configuration**)."

  483. msgstr ""

  484. 

  485. #: ../../../docs/configuring-playbook-bot-baibot.md:324

  486. msgid "If you're not configuring agents via Ansible, you can skip this section."

  487. msgstr ""

  488. 

  489. #: ../../../docs/configuring-playbook-bot-baibot.md:326

  490. msgid ""

  491. "This section is only useful the first time around. **Once initially "

  492. "configured the global configuration cannot be managed Ansible**, but only"

  493. " via bot commands."

  494. msgstr ""

  495. 

  496. #: ../../../docs/configuring-playbook-bot-baibot.md:328

  497. msgid ""

  498. "baibot supports [various "

  499. "purposes](https://github.com/etkecc/baibot/blob/main/docs/features.md):"

  500. msgstr ""

  501. 

  502. #: ../../../docs/configuring-playbook-bot-baibot.md:330

  503. msgid ""

  504. "[💬 text-"

  505. "generation](https://github.com/etkecc/baibot/blob/main/docs/features.md"

  506. "#-text-generation): communicating with you via text"

  507. msgstr ""

  508. 

  509. #: ../../../docs/configuring-playbook-bot-baibot.md:332

  510. msgid ""

  511. "[🦻 speech-to-"

  512. "text](https://github.com/etkecc/baibot/blob/main/docs/features.md"

  513. "#-speech-to-text): turning your voice messages into text"

  514. msgstr ""

  515. 

  516. #: ../../../docs/configuring-playbook-bot-baibot.md:334

  517. msgid ""

  518. "[🗣️ text-to-"

  519. "speech](https://github.com/etkecc/baibot/blob/main/docs/features.md"

  520. "#-text-to-speech): turning bot or users text messages into voice messages"

  521. msgstr ""

  522. 

  523. #: ../../../docs/configuring-playbook-bot-baibot.md:336

  524. msgid ""

  525. "[🖌️ image-"

  526. "generation](https://github.com/etkecc/baibot/blob/main/docs/features.md"

  527. "#-image-generation): generating images based on instructions"

  528. msgstr ""

  529. 

  530. #: ../../../docs/configuring-playbook-bot-baibot.md:338

  531. msgid ""

  532. "❓ catch-all: special purposes, indicating use as a fallback (when no "

  533. "specific handler is configured)"

  534. msgstr ""

  535. 

  536. #: ../../../docs/configuring-playbook-bot-baibot.md:340

  537. msgid ""

  538. "[Mixing & matching "

  539. "models](https://github.com/etkecc/baibot/blob/main/docs/features.md#mixing"

  540. "--matching-models) is made possible by the bot's ability to have "

  541. "different [🤝 "

  542. "handlers](https://github.com/etkecc/baibot/blob/main/docs/configuration/handlers.md)"

  543. " configured for different purposes."

  544. msgstr ""

  545. 

  546. #: ../../../docs/configuring-playbook-bot-baibot.md:342

  547. msgid ""

  548. "This configuration can be done as a global fallback, or per-room. Both of"

  549. " these [🛠️ "

  550. "configurations](https://github.com/etkecc/baibot/blob/main/docs/configuration/README.md)"

  551. " are managed at runtime (viat chat), but **the global configuration can "

  552. "have some initial defaults configured via Ansible**."

  553. msgstr ""

  554. 

  555. #: ../../../docs/configuring-playbook-bot-baibot.md:344

  556. msgid ""

  557. "You can configure the **initial values** for these via Ansible, via the "

  558. "`matrix_bot_baibot_config_initial_global_config_handler_*` variables."

  559. msgstr ""

  560. 

  561. #: ../../../docs/configuring-playbook-bot-baibot.md:346

  562. msgid "Example **additional** `vars.yml` configuration:"

  563. msgstr ""

  564. 

  565. #: ../../../docs/configuring-playbook-bot-baibot.md:363

  566. msgid ""

  567. "**Note**: these are initial defaults for the bot's global configuration. "

  568. "As such, changing any of these values subsequently has no effect on the "

  569. "bot's behavior. **Once initially configured the global configuration "

  570. "cannot be managed Ansible**, but only via bot commands."

  571. msgstr ""

  572. 

  573. #: ../../../docs/configuring-playbook-bot-baibot.md:365

  574. msgid "Installing"

  575. msgstr ""

  576. 

  577. #: ../../../docs/configuring-playbook-bot-baibot.md:367

  578. msgid ""

  579. "After configuring the playbook, run it with [playbook tags](playbook-"

  580. "tags.md) as below:"

  581. msgstr ""

  582. 

  583. #: ../../../docs/configuring-playbook-bot-baibot.md:374

  584. msgid "**Notes**:"

  585. msgstr ""

  586. 

  587. #: ../../../docs/configuring-playbook-bot-baibot.md:376

  588. msgid ""

  589. "The `ensure-matrix-users-created` playbook tag makes the playbook "

  590. "automatically create the bot's user account."

  591. msgstr ""

  592. 

  593. #: ../../../docs/configuring-playbook-bot-baibot.md:378

  594. msgid ""

  595. "The shortcut commands with the [`just` program](just.md) are also "

  596. "available: `just install-all` or `just setup-all`"

  597. msgstr ""

  598. 

  599. #: ../../../docs/configuring-playbook-bot-baibot.md:380

  600. msgid ""

  601. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "

  602. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"

  603. "runtime) than `just setup-all`) when its components remain unchanged. If "

  604. "you adjust your `vars.yml` to remove other components, you'd need to run "

  605. "`just setup-all`, or these components will still remain installed."

  606. msgstr ""

  607. 

  608. #: ../../../docs/configuring-playbook-bot-baibot.md:382

  609. msgid ""

  610. "If you change the bot password (`matrix_bot_baibot_config_user_password` "

  611. "in your `vars.yml` file) subsequently, the bot user's credentials on the "

  612. "homeserver won't be updated automatically. If you'd like to change the "

  613. "bot user's password, use a tool like [synapse-admin](configuring-"

  614. "playbook-synapse-admin.md) to change it, and then update "

  615. "`matrix_bot_baibot_config_user_password` to let the bot know its new "

  616. "password."

  617. msgstr ""

  618. 

  619. #: ../../../docs/configuring-playbook-bot-baibot.md:384

  620. msgid "Usage"

  621. msgstr ""

  622. 

  623. #: ../../../docs/configuring-playbook-bot-baibot.md:386

  624. msgid "To use the bot, invite the `@baibot:example.com` bot user into a room."

  625. msgstr ""

  626. 

  627. #: ../../../docs/configuring-playbook-bot-baibot.md:388

  628. msgid ""

  629. "If you're an allowed bot [👥 "

  630. "user](https://github.com/etkecc/baibot/blob/main/docs/access.md#user) "

  631. "(see [👥 Initial users configuration](#-initial-users-configuration)), the"

  632. " bot will accept your invitation and join the room."

  633. msgstr ""

  634. 

  635. #: ../../../docs/configuring-playbook-bot-baibot.md:390

  636. msgid ""

  637. "After joining, the bot will introduce itself and show information about "

  638. "the [✨ "

  639. "features](https://github.com/etkecc/baibot/blob/main/docs/features.md) "

  640. "that are enabled for it."

  641. msgstr ""

  642. 

  643. #: ../../../docs/configuring-playbook-bot-baibot.md:392

  644. msgid ""

  645. "If you've [🤖 configured one or more agents via Ansible](#-configuring-"

  646. "agents-via-ansible) and have [🤝 configured initial default handlers"

  647. "](#configuring-initial-default-handlers), the bot will immediately be "

  648. "able to make use of these agents for this new room. Otherwise, you will "

  649. "need to configure agents and/or handlers via chat commands."

  650. msgstr ""

  651. 

  652. #: ../../../docs/configuring-playbook-bot-baibot.md:394

  653. msgid ""

  654. "Send `!bai help` to the room at any time to see the bot's help menu for "

  655. "additional commands."

  656. msgstr ""

  657. 

  658. #: ../../../docs/configuring-playbook-bot-baibot.md:396

  659. msgid ""

  660. "You can also refer to the upstream "

  661. "[baibot](https://github.com/etkecc/baibot) project's documentation."

  662. msgstr ""

  663. 

  664. #: ../../../docs/configuring-playbook-bot-baibot.md:398

  665. msgid "Debugging"

  666. msgstr ""

  667. 

  668. #: ../../../docs/configuring-playbook-bot-baibot.md:400

  669. msgid ""

  670. "As with all other services, you can find service logs in [systemd-"

  671. "journald](https://www.freedesktop.org/software/systemd/man/systemd-"

  672. "journald.service.html) by running something like `journalctl -fu matrix-"

  673. "bot-baibot`"

  674. msgstr ""

  675. 

  676. #: ../../../docs/configuring-playbook-bot-baibot.md:402

  677. msgid ""

  678. "The default logging level for this service is `info`, but you can "

  679. "increase it to `debug` (or even `trace`) with the following additional "

  680. "configuration:"

  681. msgstr ""

  682. 

  683. #: ../../../docs/configuring-playbook-bot-baibot.md:416

  684. msgid ""

  685. "**Alternatively**, you can use a single variable to set the logging level"

  686. " for all of the above (bot + all libraries):"

  687. msgstr ""