chore(i18n): refresh uk translations

2026-05-02 07:31:59 +00:00 · 2026-05-02 07:31:59 +00:00 · 884ae5891b
commit 884ae5891b
parent bb2fc03e68
2 changed files with 61 additions and 49 deletions
--- a/docs/uk/tools/brave-search.md
+++ b/docs/uk/tools/brave-search.md
@ -1,14 +1,14 @@
 ---
 read_when:
    - Ви хочете використовувати Brave Search для web_search
-    - Потрібен BRAVE_API_KEY або відомості про план
+    - Потрібен BRAVE_API_KEY або відомості про тарифний план
 summary: Налаштування Brave Search API для web_search
 title: Пошук Brave
 x-i18n:
-    generated_at: "2026-05-02T06:53:23Z"
+    generated_at: "2026-05-02T07:31:27Z"
    model: gpt-5.5
    provider: openai
-    source_hash: 06cfef368f01d0af91ddb4e8adc13b7699019cbf662783b88c573049bfb77e18
+    source_hash: b1ecb9e3e5475bb26f4058311429b558f49cdd1df907a622f93f297ac6569d65
    source_path: tools/brave-search.md
    workflow: 16
 ---
@ -20,8 +20,8 @@ OpenClaw підтримує Brave Search API як провайдера `web_sear
 ## Отримання API-ключа

 1. Створіть обліковий запис Brave Search API на [https://brave.com/search/api/](https://brave.com/search/api/)
-2. На панелі керування виберіть тариф **Search** і згенеруйте API-ключ.
-3. Збережіть ключ у конфігурації або задайте `BRAVE_API_KEY` у середовищі Gateway.
+2. У панелі керування виберіть план **Search** і згенеруйте API-ключ.
+3. Збережіть ключ у конфігурації або встановіть `BRAVE_API_KEY` у середовищі Gateway.

 ## Приклад конфігурації

@ -34,6 +34,7 @@ OpenClaw підтримує Brave Search API як провайдера `web_sear
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
+            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
@ -52,12 +53,18 @@ OpenClaw підтримує Brave Search API як провайдера `web_sear
 ```

 Специфічні для провайдера налаштування пошуку Brave тепер розміщені в `plugins.entries.brave.config.webSearch.*`.
-Застарілий `tools.web.search.apiKey` досі завантажується через сумісний прошарок, але це більше не канонічний шлях конфігурації.
+Застарілий `tools.web.search.apiKey` досі завантажується через shim сумісності, але більше не є канонічним шляхом конфігурації.

 `webSearch.mode` керує транспортом Brave:

 - `web` (за замовчуванням): звичайний вебпошук Brave із заголовками, URL-адресами та фрагментами
- `llm-context`: Brave LLM Context API із попередньо витягнутими текстовими фрагментами та джерелами для обґрунтування
+- `llm-context`: Brave LLM Context API із заздалегідь витягнутими текстовими фрагментами та джерелами для обґрунтування
+
+`webSearch.baseUrl` може спрямовувати запити Brave до довіреного Brave-сумісного проксі
+або gateway. OpenClaw додає `/res/v1/web/search` або `/res/v1/llm/context` до
+налаштованої базової URL-адреси й зберігає базову URL-адресу в ключі кешу. Публічні
+кінцеві точки мають використовувати `https://`; `http://` приймається лише для довірених loopback
+або проксі-хостів приватної мережі.

 ## Параметри інструмента

@ -123,17 +130,19 @@ await web_search({

 ## Примітки

- OpenClaw використовує тариф Brave **Search**. Якщо у вас застаріла підписка (наприклад, початковий тариф Free з 2 000 запитів на місяць), вона залишається чинною, але не включає новіші функції, як-от LLM Context або вищі ліміти швидкості.
- Кожен тариф Brave включає **\$5/місяць безкоштовного кредиту** (з поновленням). Тариф Search коштує \$5 за 1 000 запитів, тож кредит покриває 1 000 запитів на місяць. Задайте ліміт використання на панелі керування Brave, щоб уникнути неочікуваних витрат. Актуальні тарифи дивіться на [порталі Brave API](https://brave.com/search/api/).
- Тариф Search включає кінцеву точку LLM Context і права на AI-інференс. Зберігання результатів для навчання або донавчання моделей потребує тарифу з явними правами на зберігання. Дивіться Brave [Умови надання послуг](https://api-dashboard.search.brave.com/terms-of-service).
- Режим `llm-context` повертає обґрунтовані записи джерел замість звичайної форми фрагментів вебпошуку.
- Режим `llm-context` підтримує `freshness` і обмежені діапазони `date_after` + `date_before`. Він не підтримує `ui_lang`; `date_before` без `date_after` відхиляється, оскільки Brave вимагає, щоб власні діапазони свіжості містили і дату початку, і дату завершення.
- `ui_lang` має містити регіональний підтеґ, наприклад `en-US`.
- Результати кешуються на 15 хвилин за замовчуванням (налаштовується через `cacheTtlMinutes`).
- Увімкніть діагностичний прапорець `brave.http`, щоб під час усунення несправностей журналювати URL-адреси/параметри запитів Brave, статус/час відповіді та події влучання/промаху/запису пошукового кешу. Прапорець ніколи не журналює API-ключ або тіла відповідей, але пошукові запити можуть бути чутливими.
+- OpenClaw використовує план Brave **Search**. Якщо у вас є застаріла підписка (наприклад, початковий план Free із 2 000 запитів/місяць), вона залишається чинною, але не включає новіші можливості, як-от LLM Context або вищі ліміти частоти запитів.
+- Кожен план Brave включає **\$5/місяць безкоштовного кредиту** (з поновленням). План Search коштує \$5 за 1 000 запитів, тому кредит покриває 1 000 запитів/місяць. Установіть ліміт використання в панелі керування Brave, щоб уникнути неочікуваних витрат. Поточні плани див. на [порталі Brave API](https://brave.com/search/api/).
+- План Search включає кінцеву точку LLM Context і права на AI-виведення. Зберігання результатів для навчання або налаштування моделей потребує плану з явними правами на зберігання. Див. Brave [Умови надання послуг](https://api-dashboard.search.brave.com/terms-of-service).
+- Режим `llm-context` повертає обґрунтовані записи джерел замість звичайної структури фрагментів вебпошуку.
+- Режим `llm-context` підтримує `freshness` і обмежені діапазони `date_after` + `date_before`. Він не підтримує `ui_lang`; `date_before` без `date_after` відхиляється, оскільки Brave вимагає, щоб користувацькі діапазони актуальності містили і початкову, і кінцеву дати.
+- `ui_lang` має містити регіональний підтег, наприклад `en-US`.
+- Результати за замовчуванням кешуються на 15 хвилин (налаштовується через `cacheTtlMinutes`).
+- Користувацькі значення `webSearch.baseUrl` включаються в ідентичність кешу Brave, тому
+  відповіді, специфічні для проксі, не конфліктують.
+- Увімкніть діагностичний прапорець `brave.http`, щоб під час усунення несправностей реєструвати URL-адреси/параметри запитів Brave, статус/час відповіді та події влучання/промаху/запису кешу пошуку. Прапорець ніколи не записує API-ключ або тіла відповідей, але пошукові запити можуть бути чутливими.

 ## Пов’язане

- [Огляд Web Search](/uk/tools/web) -- усі провайдери та автовиявлення
- [Perplexity Search](/uk/tools/perplexity-search) -- структуровані результати з фільтрацією за доменами
+- [Огляд Web Search](/uk/tools/web) -- усі провайдери та автоматичне виявлення
+- [Perplexity Search](/uk/tools/perplexity-search) -- структуровані результати з фільтруванням за доменами
 - [Exa Search](/uk/tools/exa-search) -- нейронний пошук із витягуванням вмісту
--- a/docs/uk/tools/searxng-search.md
+++ b/docs/uk/tools/searxng-search.md
@ -1,42 +1,42 @@
 ---
 read_when:
-    - Вам потрібен самостійно розміщений провайдер вебпошуку
+    - Вам потрібен самостійно розгорнутий постачальник вебпошуку
    - Ви хочете використовувати SearXNG для web_search
-    - Вам потрібен орієнтований на приватність або ізольований від мережі варіант пошуку
-summary: Вебпошук SearXNG -- самостійно розгорнутий постачальник метапошуку без ключів
+    - Вам потрібен варіант пошуку, орієнтований на конфіденційність або ізольований від мережі
+summary: Вебпошук SearXNG -- самостійно розгорнутий провайдер метапошуку без ключа
 title: Пошук SearXNG
 x-i18n:
-    generated_at: "2026-05-02T06:00:49Z"
+    generated_at: "2026-05-02T07:31:33Z"
    model: gpt-5.5
    provider: openai
-    source_hash: 8743325d4d4fdccad04956154bb87b1bd7f7155fb063a09cee3733a73e8d0c30
+    source_hash: b9be62f7398379e1672ea7e934a571a529cac07dc5d880ac74e51f8445594034
    source_path: tools/searxng-search.md
    workflow: 16
 ---

 OpenClaw підтримує [SearXNG](https://docs.searxng.org/) як **самостійно розгорнутий,
-безключовий** провайдер `web_search`. SearXNG — це open-source метапошуковий рушій,
+без ключа** провайдер `web_search`. SearXNG — це метапошуковий рушій із відкритим кодом,
 який агрегує результати з Google, Bing, DuckDuckGo та інших джерел.

 Переваги:

- **Безкоштовно та без обмежень** -- не потрібні API-ключ або комерційна підписка
- **Приватність / ізоляція** -- запити ніколи не залишають вашу мережу
- **Працює всюди** -- немає регіональних обмежень комерційних пошукових API
+- **Безкоштовно й без обмежень** -- не потрібен API-ключ або комерційна підписка
+- **Конфіденційність / ізоляція мережі** -- запити ніколи не залишають вашу мережу
+- **Працює будь-де** -- немає регіональних обмежень комерційних пошукових API

 ## Налаштування

 <Steps>
-  <Step title="Запустіть екземпляр SearXNG">
+  <Step title="Run a SearXNG instance">
    ```bash
    docker run -d -p 8888:8080 searxng/searxng
    ```

    Або використайте будь-яке наявне розгортання SearXNG, до якого маєте доступ. Див.
-    [документацію SearXNG](https://docs.searxng.org/) щодо налаштування для production.
+    [документацію SearXNG](https://docs.searxng.org/) для налаштування у продакшені.

  </Step>
-  <Step title="Налаштуйте">
+  <Step title="Configure">
    ```bash
    openclaw configure --section web
    # Select "searxng" as the provider
@ -85,15 +85,15 @@ OpenClaw підтримує [SearXNG](https://docs.searxng.org/) як **само
 }
 ```

-Поле `baseUrl` також приймає об’єкти SecretRef.
+Поле `baseUrl` також приймає об'єкти SecretRef.

 Правила транспорту:

 - `https://` працює для публічних або приватних хостів SearXNG
- `http://` приймається лише для довірених хостів приватної мережі або loopback-хостів
+- `http://` приймається лише для довірених хостів приватної мережі або loopback
 - публічні хости SearXNG мають використовувати `https://`
- приватні/внутрішні хости використовують мережевий захист для самостійно розгорнутих сервісів; публічні хости `https://`
-  залишаються на суворому захисті вебпошуку й не можуть переспрямовувати на приватні
+- приватні/внутрішні хости використовують мережевий захист для самостійно розгорнутих середовищ; публічні хости `https://`
+  залишаються під суворим захистом вебпошуку й не можуть переспрямовувати на приватні
  адреси

 ## Змінна середовища
@ -104,42 +104,45 @@ OpenClaw підтримує [SearXNG](https://docs.searxng.org/) як **само
 export SEARXNG_BASE_URL="http://localhost:8888"
 ```

-Коли `SEARXNG_BASE_URL` задано й явного провайдера не налаштовано, автовиявлення
-автоматично вибирає SearXNG (із найнижчим пріоритетом -- будь-який API-провайдер із
+Коли `SEARXNG_BASE_URL` задано й явний провайдер не налаштовано, автовиявлення
+автоматично вибирає SearXNG (з найнижчим пріоритетом -- будь-який API-backed провайдер із
 ключем перемагає першим).

-## Довідка з конфігурації Plugin
+## Довідник конфігурації Plugin

 | Поле         | Опис                                                               |
 | ------------ | ------------------------------------------------------------------ |
-| `baseUrl`    | Базова URL-адреса вашого екземпляра SearXNG (обов’язково)          |
+| `baseUrl`    | Базовий URL вашого екземпляра SearXNG (обов'язково)                |
 | `categories` | Категорії, розділені комами, як-от `general`, `news` або `science` |
 | `language`   | Код мови для результатів, як-от `en`, `de` або `fr`                |

 ## Примітки

 - **JSON API** -- використовує нативну кінцеву точку SearXNG `format=json`, а не HTML-скрейпінг
- **URL-адреси результатів зображень** -- результати категорії зображень включають `img_src`, коли SearXNG
-  повертає пряму URL-адресу зображення
+- **URL результатів із зображеннями** -- результати категорії зображень містять `img_src`, коли SearXNG
+  повертає прямий URL зображення
 - **Без API-ключа** -- працює з будь-яким екземпляром SearXNG одразу
- **Перевірка базової URL-адреси** -- `baseUrl` має бути дійсною URL-адресою `http://` або `https://`;
+- **Перевірка базового URL** -- `baseUrl` має бути дійсним URL `http://` або `https://`;
  публічні хости мають використовувати `https://`
 - **Мережевий захист** -- приватні/внутрішні кінцеві точки SearXNG явно вмикають
  доступ до приватної мережі; публічні кінцеві точки SearXNG `https://` зберігають суворий
  захист від SSRF
- **Порядок автовиявлення** -- SearXNG перевіряється останнім (порядок 200) в
-  автовиявленні. API-провайдери з налаштованими ключами запускаються першими, потім
+- **Порядок автовиявлення** -- SearXNG перевіряється останнім (порядок 200) під час
+  автовиявлення. API-backed провайдери з налаштованими ключами запускаються першими, потім
  DuckDuckGo (порядок 100), потім Ollama Web Search (порядок 110)
- **Самостійно розгорнутий** -- ви контролюєте екземпляр, запити та upstream-пошукові рушії
- **Категорії** за замовчуванням мають значення `general`, якщо їх не налаштовано
+- **Самостійне розгортання** -- ви контролюєте екземпляр, запити та upstream пошукові рушії
+- **Категорії** за замовчуванням мають значення `general`, якщо не налаштовані
+- **Резервна категорія** -- якщо запит категорії, відмінної від `general`, успішний, але
+  повертає нуль результатів, OpenClaw повторює той самий запит один раз із `general`
+  перед поверненням порожнього набору результатів

 <Tip>
  Щоб JSON API SearXNG працював, переконайтеся, що у вашому екземплярі SearXNG увімкнено формат `json`
-  у `settings.yml` у розділі `search.formats`.
+  у його `settings.yml` у розділі `search.formats`.
 </Tip>

-## Пов’язане
+## Пов'язане

- [Огляд вебпошуку](/uk/tools/web) -- усі провайдери й автовиявлення
- [Пошук DuckDuckGo](/uk/tools/duckduckgo-search) -- ще один безключовий резервний варіант
- [Пошук Brave](/uk/tools/brave-search) -- структуровані результати з безкоштовним рівнем
+- [Огляд Web Search](/uk/tools/web) -- усі провайдери й автовиявлення
+- [Пошук DuckDuckGo](/uk/tools/duckduckgo-search) -- ще один резервний варіант без ключа
+- [Brave Search](/uk/tools/brave-search) -- структуровані результати з безкоштовним рівнем