overmind
/
matrix-docker-ansible-deploy
镜像来自 https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
複製 0
程式碼 問題 0 版本發佈 0 Wiki 活動
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 提交
5 分支
409 MiB
 
 
 
目錄樹: c51e771d1a
分支列表 標籤
${ item.name }
建立分支 ${ searchTerm }
從 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-bot-ba...

688 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: jp\n"

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

  18. "MIME-Version: 1.0\n"

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

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

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

  22. 

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

  24. msgid "Setting up baibot (optional)"

  25. msgstr ""

  26. 

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

  28. msgid ""

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

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

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

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

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

  34. "you. 🤖"

  35. msgstr ""

  36. 

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

  38. msgid ""

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

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

  41. " [☁️ "

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

  43. msgstr ""

  44. 

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

  46. msgid ""

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

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

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

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

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

  52. "for more information."

  53. msgstr ""

  54. 

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

  56. msgid "Prerequisites"

  57. msgstr ""

  58. 

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

  60. msgid ""

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

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

  63. msgstr ""

  64. 

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

  66. msgid "Adjusting the playbook configuration"

  67. msgstr ""

  68. 

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

  70. msgid ""

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

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

  73. "sections below**:"

  74. msgstr ""

  75. 

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

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

  78. msgstr ""

  79. 

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

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

  82. msgstr ""

  83. 

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

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

  86. msgstr ""

  87. 

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

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

  90. msgstr ""

  91. 

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

  93. msgid ""

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

  95. "handlers)"

  96. msgstr ""

  97. 

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

  99. msgid ""

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

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

  102. "configuration)**."

  103. msgstr ""

  104. 

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

  106. msgid "Base configuration"

  107. msgstr ""

  108. 

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

  110. msgid ""

  111. "Add the following configuration to your "

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

  113. msgstr ""

  114. 

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

  116. msgid ""

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

  118. "configuration sections below."

  119. msgstr ""

  120. 

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

  122. msgid "👮‍♂️ Administrator configuration"

  123. msgstr ""

  124. 

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

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

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

  128. msgstr ""

  129. 

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

  131. msgid ""

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

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

  134. " you either need to specify "

  135. "`matrix_bot_baibot_config_access_admin_patterns` or `matrix_admin`. The "

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

  137. msgstr ""

  138. 

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

  140. msgid ""

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

  142. " you can skip this section."

  143. msgstr ""

  144. 

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

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

  147. msgid ""

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

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

  150. msgstr ""

  151. 

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

  153. msgid "👥 Initial users configuration"

  154. msgstr ""

  155. 

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

  157. msgid ""

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

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

  160. msgstr ""

  161. 

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

  163. msgid ""

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

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

  166. "you may:"

  167. msgstr ""

  168. 

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

  170. msgid ""

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

  172. "`matrix_bot_baibot_config_initial_global_config_user_patterns` Ansible "

  173. "variable, as shown below"

  174. msgstr ""

  175. 

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

  177. msgid ""

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

  179. "SPACE_SEPARATED_PATTERNS` command"

  180. msgstr ""

  181. 

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

  183. msgid ""

  184. "Configuring "

  185. "`matrix_bot_baibot_config_initial_global_config_user_patterns` is "

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

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

  188. msgstr ""

  189. 

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

  191. msgid ""

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

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

  194. "bot commands."

  195. msgstr ""

  196. 

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

  198. msgid "🤖 Configuring agents via Ansible"

  199. msgstr ""

  200. 

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

  202. msgid ""

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

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

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

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

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

  208. msgstr ""

  209. 

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

  211. msgid ""

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

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

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

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

  216. "commands."

  217. msgstr ""

  218. 

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

  220. msgid ""

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

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

  223. "various [☁️ "

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

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

  226. msgstr ""

  227. 

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

  229. msgid ""

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

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

  232. "`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "

  233. "variable."

  234. msgstr ""

  235. 

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

  237. msgid ""

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

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

  240. msgstr ""

  241. 

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

  243. msgid ""

  244. "Depending on your propensity for "

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

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

  247. "dynamically via chat."

  248. msgstr ""

  249. 

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

  251. msgid ""

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

  253. "[How to choose a "

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

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

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

  257. msgstr ""

  258. 

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

  260. msgid "Anthropic"

  261. msgstr ""

  262. 

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

  264. msgid ""

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

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

  267. "instance powered by the [Anthropic "

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

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

  270. msgstr ""

  271. 

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

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

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

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

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

  277. msgstr ""

  278. 

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

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

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

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

  283. msgid ""

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

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

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

  287. msgstr ""

  288. 

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

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

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

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

  293. msgid ""

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

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

  296. msgstr ""

  297. 

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

  299. msgid "Groq"

  300. msgstr ""

  301. 

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

  303. msgid ""

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

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

  306. "instance powered by the [Groq "

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

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

  309. msgstr ""

  310. 

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

  312. msgid ""

  313. "Because this is a "

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

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

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

  317. msgstr ""

  318. 

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

  320. msgid "Mistral"

  321. msgstr ""

  322. 

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

  324. msgid ""

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

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

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

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

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

  330. msgstr ""

  331. 

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

  333. msgid ""

  334. "Because this is a "

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

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

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

  338. msgstr ""

  339. 

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

  341. msgid "OpenAI"

  342. msgstr ""

  343. 

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

  345. msgid ""

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

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

  348. "instance powered by the [OpenAI "

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

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

  351. msgstr ""

  352. 

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

  354. msgid ""

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

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

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

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

  359. "compatible) provider instead."

  360. msgstr ""

  361. 

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

  363. msgid ""

  364. "Because this is a "

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

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

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

  368. msgstr ""

  369. 

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

  371. msgid "OpenAI Compatible"

  372. msgstr ""

  373. 

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

  375. msgid ""

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

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

  378. "instance powered by the [OpenAI Compatible "

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

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

  381. msgstr ""

  382. 

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

  384. msgid ""

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

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

  387. " [Together "

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

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

  390. msgstr ""

  391. 

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

  393. msgid ""

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

  395. "[supported "

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

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

  398. "it easier to get started."

  399. msgstr ""

  400. 

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

  402. msgid ""

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

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

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

  406. msgstr ""

  407. 

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

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

  410. msgstr ""

  411. 

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

  413. msgid ""

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

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

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

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

  418. msgstr ""

  419. 

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

  421. msgid ""

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

  423. "`matrix_bot_baibot_config_agents_static_definitions_custom` Ansible "

  424. "variable."

  425. msgstr ""

  426. 

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

  428. msgid ""

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

  430. "using Ansible is not a requirement."

  431. msgstr ""

  432. 

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

  434. msgid ""

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

  436. " Ansible without using presets**:"

  437. msgstr ""

  438. 

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

  440. msgid ""

  441. "Because these are "

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

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

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

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

  446. msgstr ""

  447. 

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

  449. msgid ""

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

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

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

  453. msgstr ""

  454. 

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

  456. msgid ""

  457. "As with any [🤖 "

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

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

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

  461. " & matching "

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

  463. "--matching-models)."

  464. msgstr ""

  465. 

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

  467. msgid ""

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

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

  470. msgstr ""

  471. 

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

  473. msgid "🤝 Configuring initial default handlers"

  474. msgstr ""

  475. 

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

  477. msgid ""

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

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

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

  481. "configuration**)."

  482. msgstr ""

  483. 

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

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

  486. msgstr ""

  487. 

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

  489. msgid ""

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

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

  492. " via bot commands."

  493. msgstr ""

  494. 

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

  496. msgid ""

  497. "baibot supports [various "

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

  499. msgstr ""

  500. 

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

  502. msgid ""

  503. "[💬 text-"

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

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

  506. msgstr ""

  507. 

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

  509. msgid ""

  510. "[🦻 speech-to-"

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

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

  513. msgstr ""

  514. 

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

  516. msgid ""

  517. "[🗣️ text-to-"

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

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

  520. msgstr ""

  521. 

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

  523. msgid ""

  524. "[🖌️ image-"

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

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

  527. msgstr ""

  528. 

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

  530. msgid ""

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

  532. "specific handler is configured)"

  533. msgstr ""

  534. 

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

  536. msgid ""

  537. "[Mixing & matching "

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

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

  540. "different [🤝 "

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

  542. " configured for different purposes."

  543. msgstr ""

  544. 

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

  546. msgid ""

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

  548. " these [🛠️ "

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

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

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

  552. msgstr ""

  553. 

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

  555. msgid ""

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

  557. "`matrix_bot_baibot_config_initial_global_config_handler_*` variables."

  558. msgstr ""

  559. 

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

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

  562. msgstr ""

  563. 

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

  565. msgid ""

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

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

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

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

  570. msgstr ""

  571. 

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

  573. msgid "Installing"

  574. msgstr ""

  575. 

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

  577. msgid ""

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

  579. "tags.md) as below:"

  580. msgstr ""

  581. 

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

  583. msgid "**Notes**:"

  584. msgstr ""

  585. 

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

  587. msgid ""

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

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

  590. msgstr ""

  591. 

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

  593. msgid ""

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

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

  596. msgstr ""

  597. 

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

  599. msgid ""

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

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

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

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

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

  605. msgstr ""

  606. 

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

  608. msgid ""

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

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

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

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

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

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

  615. "password."

  616. msgstr ""

  617. 

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

  619. msgid "Usage"

  620. msgstr ""

  621. 

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

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

  624. msgstr ""

  625. 

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

  627. msgid ""

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

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

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

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

  632. msgstr ""

  633. 

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

  635. msgid ""

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

  637. "the [✨ "

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

  639. "that are enabled for it."

  640. msgstr ""

  641. 

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

  643. msgid ""

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

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

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

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

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

  649. msgstr ""

  650. 

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

  652. msgid ""

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

  654. "additional commands."

  655. msgstr ""

  656. 

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

  658. msgid ""

  659. "You can also refer to the upstream "

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

  661. msgstr ""

  662. 

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

  664. msgid "Debugging"

  665. msgstr ""

  666. 

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

  668. msgid ""

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

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

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

  672. "bot-baibot`"

  673. msgstr ""

  674. 

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

  676. msgid ""

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

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

  679. "configuration:"

  680. msgstr ""

  681. 

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

  683. msgid ""

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

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

  686. msgstr ""