# SOME DESCRIPTIVE TITLE. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community members # This file is distributed under the same license as the matrix-docker-ansible-deploy package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-12-20 07:23+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../../../docs/configuring-playbook-bot-baibot.md:1 msgid "Setting up baibot (optional)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:8 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. 🤖" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:10 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)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:12 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:14 msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:16 msgid "API access to one or more LLM [☁ī¸ providers](https://github.com/etkecc/baibot/blob/main/docs/providers.md)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:18 msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:20 msgid "There are **a lot of configuration options** (some required, some possibly required, some optional), so they're **split into multiple sections below**:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:23 msgid "[Base configuration](#base-configuration)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:24 msgid "[👮‍♂ī¸ Administrator configuration](#ī¸-administrator-configuration)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:25 msgid "[đŸ‘Ĩ Initial users configuration](#-initial-users-configuration)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:26 msgid "[🤖 Configuring agents via Ansible](#-configuring-agents-via-ansible)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:27 msgid "[🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:29 msgid "Depending on your current `vars.yml` file and desired configuration, **you may require more than just the [base configuration](#base-configuration)**." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:31 msgid "Base configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:33 msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:71 msgid "As mentioned above, **this may not be enough**. Continue with the configuration sections below." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:73 msgid "👮‍♂ī¸ Administrator configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:75 #: ../../../docs/configuring-playbook-bot-baibot.md:99 msgid "This is an addition to the [base configuration](#base-configuration)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md: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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:79 msgid "If `matrix_admin` is already configured in your `vars.yml` configuration, you can skip this section." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:81 #: ../../../docs/configuring-playbook-bot-baibot.md:110 msgid "**If necessary**, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:95 msgid "đŸ‘Ĩ Initial users configuration" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:97 msgid "By default, **all users on your homeserver are considered allowed users**. If that's OK, you can skip this section." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:101 msgid "To specify who is considered a bot [đŸ‘Ĩ User](https://github.com/etkecc/baibot/blob/main/docs/access.md#user), you may:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:103 msgid "define an **initial** value for `matrix_bot_baibot_config_initial_global_config_user_patterns` Ansible variable, as shown below" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:104 msgid "configure the list at runtime via the bot's `!bai access set-users SPACE_SEPARATED_PATTERNS` command" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:106 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:108 msgid "**Note**: Once initially configured, the allowed users list **cannot be managed via Ansible anymore**. It can only be managed subsequently via bot commands." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:122 msgid "🤖 Configuring agents via Ansible" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:124 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)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:126 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:128 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)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:130 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:132 msgid "Agents defined statically and those created dynamically (via chat) are named differently, so **conflict cannot arise**." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:134 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:136 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)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:138 msgid "Anthropic" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:140 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:142 #: ../../../docs/configuring-playbook-bot-baibot.md:168 #: ../../../docs/configuring-playbook-bot-baibot.md:201 #: ../../../docs/configuring-playbook-bot-baibot.md:231 msgid "Here's an example **addition** to your `vars.yml` file:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:160 #: ../../../docs/configuring-playbook-bot-baibot.md:193 #: ../../../docs/configuring-playbook-bot-baibot.md:221 #: ../../../docs/configuring-playbook-bot-baibot.md:251 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:162 #: ../../../docs/configuring-playbook-bot-baibot.md:195 #: ../../../docs/configuring-playbook-bot-baibot.md:223 #: ../../../docs/configuring-playbook-bot-baibot.md:253 msgid "💡 You may also wish to use this new agent for [🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:164 msgid "Groq" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:166 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:191 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`." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:197 msgid "Mistral" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:199 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:219 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`." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:225 msgid "OpenAI" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:227 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:229 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:249 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`." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:255 msgid "OpenAI Compatible" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:257 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:259 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:261 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:263 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)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:265 msgid "Configuring additional agents (without a preset)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:267 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:269 msgid "It's possible to inject your own agent configuration using the `matrix_bot_baibot_config_agents_static_definitions_custom` Ansible variable." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:271 msgid "You can also define providers at runtime, by chatting with the bot, so using Ansible is not a requirement." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:273 msgid "Below is an an **example** demonstrating **statically-defining agents via Ansible without using presets**:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:312 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:314 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**." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:316 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)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:318 msgid "💡 You may also wish to use these new agents for [🤝 Configuring initial default handlers](#-configuring-initial-default-handlers)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:320 msgid "🤝 Configuring initial default handlers" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:322 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**)." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:324 msgid "If you're not configuring agents via Ansible, you can skip this section." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:326 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:328 msgid "baibot supports [various purposes](https://github.com/etkecc/baibot/blob/main/docs/features.md):" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:330 msgid "[đŸ’Ŧ text-generation](https://github.com/etkecc/baibot/blob/main/docs/features.md#-text-generation): communicating with you via text" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:332 msgid "[đŸĻģ speech-to-text](https://github.com/etkecc/baibot/blob/main/docs/features.md#-speech-to-text): turning your voice messages into text" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:334 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" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:336 msgid "[🖌ī¸ image-generation](https://github.com/etkecc/baibot/blob/main/docs/features.md#-image-generation): generating images based on instructions" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:338 msgid "❓ catch-all: special purposes, indicating use as a fallback (when no specific handler is configured)" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:340 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:342 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**." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:344 msgid "You can configure the **initial values** for these via Ansible, via the `matrix_bot_baibot_config_initial_global_config_handler_*` variables." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:346 msgid "Example **additional** `vars.yml` configuration:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:363 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:365 msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:367 msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:374 msgid "**Notes**:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:376 msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the bot's user account." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:378 msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:380 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:382 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:384 msgid "Usage" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:386 msgid "To use the bot, invite the `@baibot:example.com` bot user into a room." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:388 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:390 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:392 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." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:394 msgid "Send `!bai help` to the room at any time to see the bot's help menu for additional commands." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:396 msgid "You can also refer to the upstream [baibot](https://github.com/etkecc/baibot) project's documentation." msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:398 msgid "Debugging" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:400 msgid "As with all other services, you can find service logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by running something like `journalctl -fu matrix-bot-baibot`" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:402 msgid "The default logging level for this service is `info`, but you can increase it to `debug` (or even `trace`) with the following additional configuration:" msgstr "" #: ../../../docs/configuring-playbook-bot-baibot.md:416 msgid "**Alternatively**, you can use a single variable to set the logging level for all of the above (bot + all libraries):" msgstr ""