mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-23 21:15:45 +00:00
688 lines
24 KiB
Plaintext
688 lines
24 KiB
Plaintext
|
# 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 <EMAIL@ADDRESS>, 2024.
|
|||
|
|
#
|
|||
|
|
#, fuzzy
|
|||
|
|
msgid ""
|
|||
|
|
msgstr ""
|
|||
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|||
|
|
"Report-Msgid-Bugs-To: \n"
|
|||
|
|
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
|
|||
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|||
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|||
|
|
"Language: jp\n"
|
|||
|
|
"Language-Team: jp <LL@li.org>\n"
|
|||
|
|
"MIME-Version: 1.0\n"
|
|||
|
|
"Content-Type: text/plain; charset=utf-8\n"
|
|||
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|||
|
|
"Generated-By: Babel 2.16.0\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 ""
|
|||
|
|
|