From 884ae5891b70fc76b5de980fe6a7de1053b75e58 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 2 May 2026 07:31:59 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/tools/brave-search.md | 43 ++++++++++++--------- docs/uk/tools/searxng-search.md | 67 +++++++++++++++++---------------- 2 files changed, 61 insertions(+), 49 deletions(-) diff --git a/docs/uk/tools/brave-search.md b/docs/uk/tools/brave-search.md index 8abbb5b48..711e4bdde 100644 --- 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) -- нейронний пошук із витягуванням вмісту diff --git a/docs/uk/tools/searxng-search.md b/docs/uk/tools/searxng-search.md index f693b4ac5..d294ad862 100644 --- 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 ## Налаштування - + ```bash docker run -d -p 8888:8080 searxng/searxng ``` Або використайте будь-яке наявне розгортання SearXNG, до якого маєте доступ. Див. - [документацію SearXNG](https://docs.searxng.org/) щодо налаштування для production. + [документацію SearXNG](https://docs.searxng.org/) для налаштування у продакшені. - + ```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` + перед поверненням порожнього набору результатів Щоб JSON API SearXNG працював, переконайтеся, що у вашому екземплярі SearXNG увімкнено формат `json` - у `settings.yml` у розділі `search.formats`. + у його `settings.yml` у розділі `search.formats`. -## Пов’язане +## Пов'язане -- [Огляд вебпошуку](/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) -- структуровані результати з безкоштовним рівнем