chore(i18n): refresh uk translations
This commit is contained in:
parent
a4c25732aa
commit
7090383902
@ -2,50 +2,49 @@
|
||||
read_when:
|
||||
- Ви хочете ввімкнути або налаштувати web_search
|
||||
- Ви хочете ввімкнути або налаштувати x_search
|
||||
- Вам потрібно вибрати провайдера пошуку
|
||||
- Ви хочете зрозуміти автовизначення і fallback провайдера
|
||||
- Вам потрібно вибрати постачальника пошуку
|
||||
- Ви хочете зрозуміти автоматичне виявлення та резервне перемикання постачальника
|
||||
sidebarTitle: Web Search
|
||||
summary: web_search, x_search і web_fetch — пошук у вебі, пошук дописів у X або отримання вмісту сторінки
|
||||
title: Вебпошук
|
||||
title: Пошук у вебі
|
||||
x-i18n:
|
||||
generated_at: "2026-04-21T20:38:29Z"
|
||||
generated_at: "2026-04-22T21:50:11Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: ec2517d660465f850b1cfdd255fbf512dc5c828b1ef22e3b24cec6aab097ebd5
|
||||
source_hash: 3e568670e1e15f195dbac1a249723a2ad873d6c49217575959b8eea2cb14ef75
|
||||
source_path: tools/web.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Вебпошук
|
||||
# Пошук у вебі
|
||||
|
||||
Інструмент `web_search` виконує пошук у вебі за допомогою налаштованого вами провайдера і
|
||||
Інструмент `web_search` шукає у вебі за допомогою налаштованого постачальника та
|
||||
повертає результати. Результати кешуються за запитом на 15 хвилин (це можна налаштувати).
|
||||
|
||||
OpenClaw також містить `x_search` для дописів у X (раніше Twitter) і
|
||||
`web_fetch` для легкого отримання URL. На цьому етапі `web_fetch` залишається
|
||||
локальним, тоді як `web_search` і `x_search` можуть під капотом використовувати xAI Responses.
|
||||
`web_fetch` для полегшеного отримання URL. На цьому етапі `web_fetch` залишається
|
||||
локальним, тоді як `web_search` і `x_search` можуть використовувати xAI Responses під капотом.
|
||||
|
||||
<Info>
|
||||
`web_search` — це легкий HTTP-інструмент, а не автоматизація браузера. Для
|
||||
`web_search` — це полегшений HTTP-інструмент, а не автоматизація браузера. Для
|
||||
сайтів із важким JS або входом в обліковий запис використовуйте [Web Browser](/uk/tools/browser). Для
|
||||
отримання конкретного URL використовуйте [Web Fetch](/uk/tools/web-fetch).
|
||||
</Info>
|
||||
|
||||
## Швидкий старт
|
||||
## Швидкий початок
|
||||
|
||||
<Steps>
|
||||
<Step title="Виберіть провайдера">
|
||||
Виберіть провайдера і виконайте всі необхідні кроки налаштування. Деякі провайдери
|
||||
не потребують ключів, тоді як інші використовують API-ключі. Докладніше
|
||||
дивіться на сторінках провайдерів нижче.
|
||||
<Step title="Виберіть постачальника">
|
||||
Виберіть постачальника та виконайте всі потрібні кроки налаштування. Деякі постачальники
|
||||
не потребують ключа, тоді як інші використовують API-ключі. Докладніше дивіться на сторінках постачальників нижче.
|
||||
</Step>
|
||||
<Step title="Налаштуйте">
|
||||
```bash
|
||||
openclaw configure --section web
|
||||
```
|
||||
Це збереже провайдера та всі потрібні облікові дані. Ви також можете встановити env
|
||||
var (наприклад, `BRAVE_API_KEY`) і пропустити цей крок для провайдерів,
|
||||
що працюють через API.
|
||||
Це збереже постачальника та всі потрібні облікові дані. Ви також можете задати змінну середовища
|
||||
(наприклад, `BRAVE_API_KEY`) і пропустити цей крок для постачальників
|
||||
на основі API.
|
||||
</Step>
|
||||
<Step title="Використовуйте">
|
||||
Тепер агент може викликати `web_search`:
|
||||
@ -63,75 +62,79 @@ OpenClaw також містить `x_search` для дописів у X (ран
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Вибір провайдера
|
||||
## Вибір постачальника
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Brave Search" icon="shield" href="/uk/tools/brave-search">
|
||||
Структуровані результати зі сніпетами. Підтримує режим `llm-context`, фільтри країни/мови. Є безкоштовний тариф.
|
||||
Структуровані результати зі сніпетами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безкоштовний тариф.
|
||||
</Card>
|
||||
<Card title="DuckDuckGo" icon="bird" href="/uk/tools/duckduckgo-search">
|
||||
Fallback без ключа. API-ключ не потрібен. Неофіційна інтеграція на основі HTML.
|
||||
Безключовий резервний варіант. API-ключ не потрібен. Неофіційна інтеграція на основі HTML.
|
||||
</Card>
|
||||
<Card title="Exa" icon="brain" href="/uk/tools/exa-search">
|
||||
Нейронний + ключовий пошук із витягуванням вмісту (підсвічування, текст, підсумки).
|
||||
Нейронний + ключовий пошук із витягуванням вмісту (виділення, текст, підсумки).
|
||||
</Card>
|
||||
<Card title="Firecrawl" icon="flame" href="/uk/tools/firecrawl">
|
||||
Структуровані результати. Найкраще поєднується з `firecrawl_search` і `firecrawl_scrape` для глибокого витягування.
|
||||
</Card>
|
||||
<Card title="Gemini" icon="sparkles" href="/uk/tools/gemini-search">
|
||||
Відповіді, синтезовані ШІ, з цитуваннями через Google Search grounding.
|
||||
Відповіді, синтезовані ШІ, із цитуваннями через Google Search grounding.
|
||||
</Card>
|
||||
<Card title="Grok" icon="zap" href="/uk/tools/grok-search">
|
||||
Відповіді, синтезовані ШІ, з цитуваннями через xAI web grounding.
|
||||
Відповіді, синтезовані ШІ, із цитуваннями через xAI web grounding.
|
||||
</Card>
|
||||
<Card title="Kimi" icon="moon" href="/uk/tools/kimi-search">
|
||||
Відповіді, синтезовані ШІ, з цитуваннями через Moonshot web search.
|
||||
Відповіді, синтезовані ШІ, із цитуваннями через веб-пошук Moonshot.
|
||||
</Card>
|
||||
<Card title="MiniMax Search" icon="globe" href="/uk/tools/minimax-search">
|
||||
Структуровані результати через API пошуку MiniMax Coding Plan.
|
||||
</Card>
|
||||
<Card title="Ollama Web Search" icon="globe" href="/uk/tools/ollama-search">
|
||||
Пошук без ключа через ваш налаштований хост Ollama. Потрібен `ollama signin`.
|
||||
Безключовий пошук через ваш налаштований хост Ollama. Потрібна команда `ollama signin`.
|
||||
</Card>
|
||||
<Card title="Perplexity" icon="search" href="/uk/tools/perplexity-search">
|
||||
Структуровані результати з керуванням витягуванням вмісту та фільтрацією доменів.
|
||||
</Card>
|
||||
<Card title="SearXNG" icon="server" href="/uk/tools/searxng-search">
|
||||
Самохостинговий метапошук. API-ключ не потрібен. Агрегує Google, Bing, DuckDuckGo та інші.
|
||||
Самостійно розгорнутий метапошук. API-ключ не потрібен. Агрегує Google, Bing, DuckDuckGo та інші.
|
||||
</Card>
|
||||
<Card title="Tavily" icon="globe" href="/uk/tools/tavily">
|
||||
Структуровані результати з глибиною пошуку, фільтрацією тем і `tavily_extract` для витягування URL.
|
||||
Структуровані результати з глибиною пошуку, фільтрацією за темою та `tavily_extract` для витягування URL.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
### Порівняння провайдерів
|
||||
### Порівняння постачальників
|
||||
|
||||
| Провайдер | Стиль результатів | Фільтри | API-ключ |
|
||||
| Постачальник | Стиль результатів | Фільтри | API-ключ |
|
||||
| ----------------------------------------- | -------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------- |
|
||||
| [Brave](/uk/tools/brave-search) | Структуровані сніпети | Країна, мова, час, режим `llm-context` | `BRAVE_API_KEY` |
|
||||
| [DuckDuckGo](/uk/tools/duckduckgo-search) | Структуровані сніпети | -- | None (без ключа) |
|
||||
| [DuckDuckGo](/uk/tools/duckduckgo-search) | Структуровані сніпети | -- | Немає (без ключа) |
|
||||
| [Exa](/uk/tools/exa-search) | Структуровані + витягнуті | Нейронний/ключовий режим, дата, витягування вмісту | `EXA_API_KEY` |
|
||||
| [Firecrawl](/uk/tools/firecrawl) | Структуровані сніпети | Через інструмент `firecrawl_search` | `FIRECRAWL_API_KEY` |
|
||||
| [Gemini](/uk/tools/gemini-search) | Синтезовані ШІ + цитування | -- | `GEMINI_API_KEY` |
|
||||
| [Grok](/uk/tools/grok-search) | Синтезовані ШІ + цитування | -- | `XAI_API_KEY` |
|
||||
| [Kimi](/uk/tools/kimi-search) | Синтезовані ШІ + цитування | -- | `KIMI_API_KEY` / `MOONSHOT_API_KEY` |
|
||||
| [MiniMax Search](/uk/tools/minimax-search) | Структуровані сніпети | Регіон (`global` / `cn`) | `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` |
|
||||
| [Ollama Web Search](/uk/tools/ollama-search) | Структуровані сніпети | -- | None типово; потрібен `ollama signin`, можна повторно використати bearer auth провайдера Ollama |
|
||||
| [Ollama Web Search](/uk/tools/ollama-search) | Структуровані сніпети | -- | За замовчуванням немає; потрібна `ollama signin`, можна повторно використовувати bearer-автентифікацію постачальника Ollama |
|
||||
| [Perplexity](/uk/tools/perplexity-search) | Структуровані сніпети | Країна, мова, час, домени, ліміти вмісту | `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` |
|
||||
| [SearXNG](/uk/tools/searxng-search) | Структуровані сніпети | Категорії, мова | None (самохостинг) |
|
||||
| [SearXNG](/uk/tools/searxng-search) | Структуровані сніпети | Категорії, мова | Немає (самостійно розгорнутий) |
|
||||
| [Tavily](/uk/tools/tavily) | Структуровані сніпети | Через інструмент `tavily_search` | `TAVILY_API_KEY` |
|
||||
|
||||
## Автовизначення
|
||||
## Автоматичне виявлення
|
||||
|
||||
## Нативний вебпошук Codex
|
||||
## Власний веб-пошук OpenAI
|
||||
|
||||
Моделі з підтримкою Codex за бажанням можуть використовувати нативний інструмент Responses `web_search` від провайдера замість керованої функції `web_search` OpenClaw.
|
||||
Безпосередні моделі OpenAI Responses автоматично використовують розміщений OpenAI інструмент `web_search`, коли в OpenClaw увімкнено веб-пошук і не закріплено керований постачальник. Це поведінка, якою володіє постачальник, у вбудованому Plugin OpenAI і вона застосовується лише до нативного API-трафіку OpenAI, а не до сумісних з OpenAI проксі-базових URL або маршрутів Azure. Установіть `tools.web.search.provider` на іншого постачальника, наприклад `brave`, щоб зберегти керований інструмент `web_search` для моделей OpenAI, або встановіть `tools.web.search.enabled: false`, щоб вимкнути і керований пошук, і нативний пошук OpenAI.
|
||||
|
||||
## Власний веб-пошук Codex
|
||||
|
||||
Моделі з підтримкою Codex можуть за бажанням використовувати нативний інструмент Responses `web_search` постачальника замість керованої функції `web_search` OpenClaw.
|
||||
|
||||
- Налаштовується в `tools.web.search.openaiCodex`
|
||||
- Активується лише для моделей із підтримкою Codex (`openai-codex/*` або провайдерів, що використовують `api: "openai-codex-responses"`)
|
||||
- Активується лише для моделей із підтримкою Codex (`openai-codex/*` або постачальників, які використовують `api: "openai-codex-responses"`)
|
||||
- Керований `web_search` і далі застосовується до моделей без підтримки Codex
|
||||
- `mode: "cached"` — типове та рекомендоване налаштування
|
||||
- `tools.web.search.enabled: false` вимикає як керований, так і нативний пошук
|
||||
- `mode: "cached"` — значення за замовчуванням і рекомендоване налаштування
|
||||
- `tools.web.search.enabled: false` вимикає і керований, і нативний пошук
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -158,15 +161,15 @@ OpenClaw також містить `x_search` для дописів у X (ран
|
||||
|
||||
Якщо нативний пошук Codex увімкнено, але поточна модель не підтримує Codex, OpenClaw зберігає звичайну поведінку керованого `web_search`.
|
||||
|
||||
## Налаштування вебпошуку
|
||||
## Налаштування веб-пошуку
|
||||
|
||||
Списки провайдерів у документації та потоках налаштування впорядковано за абеткою. Автовизначення використовує
|
||||
Списки постачальників у документації та сценаріях налаштування подано в алфавітному порядку. Автоматичне виявлення використовує
|
||||
окремий порядок пріоритету.
|
||||
|
||||
Якщо `provider` не задано, OpenClaw перевіряє провайдерів у такому порядку і використовує
|
||||
Якщо `provider` не задано, OpenClaw перевіряє постачальників у такому порядку й використовує
|
||||
першого, який готовий до роботи:
|
||||
|
||||
Спочатку провайдери на основі API:
|
||||
Спочатку постачальники на основі API:
|
||||
|
||||
1. **Brave** -- `BRAVE_API_KEY` або `plugins.entries.brave.config.webSearch.apiKey` (порядок 10)
|
||||
2. **MiniMax Search** -- `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` або `plugins.entries.minimax.config.webSearch.apiKey` (порядок 15)
|
||||
@ -178,24 +181,24 @@ OpenClaw також містить `x_search` для дописів у X (ран
|
||||
8. **Exa** -- `EXA_API_KEY` або `plugins.entries.exa.config.webSearch.apiKey` (порядок 65)
|
||||
9. **Tavily** -- `TAVILY_API_KEY` або `plugins.entries.tavily.config.webSearch.apiKey` (порядок 70)
|
||||
|
||||
Після цього — fallback без ключа:
|
||||
Після цього — безключові резервні варіанти:
|
||||
|
||||
10. **DuckDuckGo** -- HTML fallback без ключа, без облікового запису чи API-ключа (порядок 100)
|
||||
11. **Ollama Web Search** -- fallback без ключа через ваш налаштований хост Ollama; вимагає, щоб Ollama був доступний і вхід було виконано через `ollama signin`, а також може повторно використовувати bearer auth провайдера Ollama, якщо хост його потребує (порядок 110)
|
||||
10. **DuckDuckGo** -- безключовий HTML-резервний варіант без облікового запису чи API-ключа (порядок 100)
|
||||
11. **Ollama Web Search** -- безключовий резервний варіант через ваш налаштований хост Ollama; потрібна доступність Ollama і виконаний вхід через `ollama signin`, а також можна повторно використовувати bearer-автентифікацію постачальника Ollama, якщо вона потрібна хосту (порядок 110)
|
||||
12. **SearXNG** -- `SEARXNG_BASE_URL` або `plugins.entries.searxng.config.webSearch.baseUrl` (порядок 200)
|
||||
|
||||
Якщо жодного провайдера не виявлено, використовується fallback до Brave (ви отримаєте помилку
|
||||
Якщо не виявлено жодного постачальника, використовується Brave як резервний варіант (ви отримаєте помилку
|
||||
про відсутній ключ із пропозицією налаштувати його).
|
||||
|
||||
<Note>
|
||||
Усі поля ключів провайдерів підтримують об’єкти SecretRef. SecretRef із областю plugin
|
||||
у `plugins.entries.<plugin>.config.webSearch.apiKey` розв’язуються для
|
||||
вбудованих провайдерів Exa, Firecrawl, Gemini, Grok, Kimi, Perplexity і Tavily
|
||||
незалежно від того, чи провайдера вибрано явно через `tools.web.search.provider`, чи
|
||||
через автовизначення. У режимі автовизначення OpenClaw розв’язує лише ключ
|
||||
вибраного провайдера — SecretRef невибраних провайдерів залишаються неактивними, тож ви можете
|
||||
тримати налаштованими кількох провайдерів без витрат на розв’язання для тих,
|
||||
яких ви не використовуєте.
|
||||
Усі поля ключів постачальників підтримують об’єкти SecretRef. SecretRef
|
||||
у межах Plugin під `plugins.entries.<plugin>.config.webSearch.apiKey` розв’язуються для
|
||||
вбудованих постачальників Exa, Firecrawl, Gemini, Grok, Kimi, Perplexity і Tavily
|
||||
незалежно від того, чи вибрано постачальника явно через `tools.web.search.provider`, чи
|
||||
через автоматичне виявлення. У режимі автоматичного виявлення OpenClaw розв’язує лише ключ
|
||||
вибраного постачальника — SecretRef невибраних постачальників залишаються неактивними, тож ви можете
|
||||
тримати налаштованими кілька постачальників, не оплачуючи витрати на розв’язання для тих,
|
||||
які ви не використовуєте.
|
||||
</Note>
|
||||
|
||||
## Конфігурація
|
||||
@ -205,8 +208,8 @@ OpenClaw також містить `x_search` для дописів у X (ран
|
||||
tools: {
|
||||
web: {
|
||||
search: {
|
||||
enabled: true, // типово: true
|
||||
provider: "brave", // або пропустіть для автовизначення
|
||||
enabled: true, // за замовчуванням: true
|
||||
provider: "brave", // або пропустіть для автоматичного виявлення
|
||||
maxResults: 5,
|
||||
timeoutSeconds: 30,
|
||||
cacheTtlMinutes: 15,
|
||||
@ -216,33 +219,34 @@ OpenClaw також містить `x_search` для дописів у X (ран
|
||||
}
|
||||
```
|
||||
|
||||
Специфічна для провайдера конфігурація (API-ключі, base URL, режими) міститься в
|
||||
`plugins.entries.<plugin>.config.webSearch.*`. Приклади дивіться на сторінках провайдерів.
|
||||
Конфігурація для конкретних постачальників (API-ключі, базові URL, режими) розміщується в
|
||||
`plugins.entries.<plugin>.config.webSearch.*`. Приклади дивіться на сторінках
|
||||
постачальників.
|
||||
|
||||
Вибір fallback-провайдера для `web_fetch` налаштовується окремо:
|
||||
Вибір резервного постачальника `web_fetch` налаштовується окремо:
|
||||
|
||||
- виберіть його через `tools.web.fetch.provider`
|
||||
- або пропустіть це поле і дозвольте OpenClaw автоматично визначити першого готового провайдера `web_fetch`
|
||||
з доступних облікових даних
|
||||
- на сьогодні вбудований провайдер `web_fetch` — це Firecrawl, який налаштовується в
|
||||
- або пропустіть це поле й дозвольте OpenClaw автоматично виявити першого готового постачальника
|
||||
`web_fetch` з доступних облікових даних
|
||||
- наразі вбудований постачальник `web_fetch` — це Firecrawl, що налаштовується в
|
||||
`plugins.entries.firecrawl.config.webFetch.*`
|
||||
|
||||
Коли ви вибираєте **Kimi** під час `openclaw onboard` або
|
||||
`openclaw configure --section web`, OpenClaw також може запитати:
|
||||
|
||||
- регіон API Moonshot (`https://api.moonshot.ai/v1` або `https://api.moonshot.cn/v1`)
|
||||
- типову модель вебпошуку Kimi (типово `kimi-k2.6`)
|
||||
- модель веб-пошуку Kimi за замовчуванням (типово `kimi-k2.6`)
|
||||
|
||||
Для `x_search` налаштуйте `plugins.entries.xai.config.xSearch.*`. Він використовує
|
||||
той самий fallback `XAI_API_KEY`, що й вебпошук Grok.
|
||||
Застаріла конфігурація `tools.web.x_search.*` автоматично мігрується через `openclaw doctor --fix`.
|
||||
той самий резервний варіант `XAI_API_KEY`, що й веб-пошук Grok.
|
||||
Застаріла конфігурація `tools.web.x_search.*` автоматично мігрується командою `openclaw doctor --fix`.
|
||||
Коли ви вибираєте Grok під час `openclaw onboard` або `openclaw configure --section web`,
|
||||
OpenClaw також може запропонувати додаткове налаштування `x_search` з тим самим ключем.
|
||||
Це окремий подальший крок усередині шляху Grok, а не окремий вибір провайдера
|
||||
вебпошуку верхнього рівня. Якщо ви виберете іншого провайдера, OpenClaw не
|
||||
OpenClaw також може запропонувати необов’язкове налаштування `x_search` з тим самим ключем.
|
||||
Це окремий подальший крок усередині сценарію Grok, а не окремий вибір постачальника
|
||||
веб-пошуку верхнього рівня. Якщо ви виберете іншого постачальника, OpenClaw не
|
||||
показуватиме запит для `x_search`.
|
||||
|
||||
### Збереження API-ключів
|
||||
### Зберігання API-ключів
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Файл конфігурації">
|
||||
@ -266,45 +270,45 @@ OpenClaw також може запропонувати додаткове на
|
||||
|
||||
</Tab>
|
||||
<Tab title="Змінна середовища">
|
||||
Встановіть env var провайдера в середовищі процесу Gateway:
|
||||
Задайте змінну середовища постачальника в середовищі процесу Gateway:
|
||||
|
||||
```bash
|
||||
export BRAVE_API_KEY="YOUR_KEY"
|
||||
```
|
||||
|
||||
Для встановлення Gateway додайте її в `~/.openclaw/.env`.
|
||||
Див. [Env vars](/uk/help/faq#env-vars-and-env-loading).
|
||||
Див. [Змінні середовища](/uk/help/faq#env-vars-and-env-loading).
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Параметри інструмента
|
||||
|
||||
| Параметр | Опис |
|
||||
| -------------------- | -------------------------------------------------------- |
|
||||
| `query` | Пошуковий запит (обов’язковий) |
|
||||
| `count` | Кількість результатів для повернення (1-10, типово: 5) |
|
||||
| `country` | 2-літерний код країни ISO (наприклад, "US", "DE") |
|
||||
| `language` | Код мови ISO 639-1 (наприклад, "en", "de") |
|
||||
| `search_lang` | Код мови пошуку (лише Brave) |
|
||||
| `freshness` | Фільтр часу: `day`, `week`, `month` або `year` |
|
||||
| `date_after` | Результати після цієї дати (YYYY-MM-DD) |
|
||||
| `date_before` | Результати до цієї дати (YYYY-MM-DD) |
|
||||
| `ui_lang` | Код мови UI (лише Brave) |
|
||||
| `domain_filter` | Масив allowlist/denylist доменів (лише Perplexity) |
|
||||
| `max_tokens` | Загальний бюджет вмісту, типово 25000 (лише Perplexity) |
|
||||
| `max_tokens_per_page`| Ліміт токенів на сторінку, типово 2048 (лише Perplexity) |
|
||||
| Параметр | Опис |
|
||||
| -------------------- | ------------------------------------------------------------ |
|
||||
| `query` | Пошуковий запит (обов’язково) |
|
||||
| `count` | Кількість результатів для повернення (1-10, типово: 5) |
|
||||
| `country` | 2-літерний код країни ISO (наприклад, "US", "DE") |
|
||||
| `language` | Код мови ISO 639-1 (наприклад, "en", "de") |
|
||||
| `search_lang` | Код мови пошуку (лише Brave) |
|
||||
| `freshness` | Фільтр часу: `day`, `week`, `month` або `year` |
|
||||
| `date_after` | Результати після цієї дати (YYYY-MM-DD) |
|
||||
| `date_before` | Результати до цієї дати (YYYY-MM-DD) |
|
||||
| `ui_lang` | Код мови інтерфейсу (лише Brave) |
|
||||
| `domain_filter` | Масив allowlist/denylist доменів (лише Perplexity) |
|
||||
| `max_tokens` | Загальний бюджет вмісту, типово 25000 (лише Perplexity) |
|
||||
| `max_tokens_per_page`| Ліміт токенів на сторінку, типово 2048 (лише Perplexity) |
|
||||
|
||||
<Warning>
|
||||
Не всі параметри працюють з усіма провайдерами. Режим Brave `llm-context`
|
||||
Не всі параметри працюють з усіма постачальниками. Режим Brave `llm-context`
|
||||
не приймає `ui_lang`, `freshness`, `date_after` і `date_before`.
|
||||
Gemini, Grok і Kimi повертають одну синтезовану ШІ відповідь із цитуваннями. Вони
|
||||
приймають `count` для сумісності зі спільним інструментом, але це не змінює
|
||||
форму grounded-відповіді.
|
||||
Perplexity поводиться так само, коли ви використовуєте шлях сумісності
|
||||
Sonar/OpenRouter (`plugins.entries.perplexity.config.webSearch.baseUrl` /
|
||||
Perplexity поводиться так само, коли ви використовуєте шлях сумісності Sonar/OpenRouter
|
||||
(`plugins.entries.perplexity.config.webSearch.baseUrl` /
|
||||
`model` або `OPENROUTER_API_KEY`).
|
||||
SearXNG приймає `http://` лише для довірених хостів приватної мережі або local loopback;
|
||||
SearXNG приймає `http://` лише для довірених хостів приватної мережі або loopback;
|
||||
публічні кінцеві точки SearXNG мають використовувати `https://`.
|
||||
Firecrawl і Tavily через `web_search` підтримують лише `query` і `count`
|
||||
-- для розширених параметрів використовуйте їхні спеціалізовані інструменти.
|
||||
@ -312,16 +316,16 @@ OpenClaw також може запропонувати додаткове на
|
||||
|
||||
## x_search
|
||||
|
||||
`x_search` виконує запити до дописів X (раніше Twitter) за допомогою xAI і повертає
|
||||
синтезовані ШІ відповіді з цитуваннями. Він приймає запити природною мовою та
|
||||
`x_search` виконує запити до дописів у X (раніше Twitter) за допомогою xAI і повертає
|
||||
відповіді, синтезовані ШІ, із цитуваннями. Він приймає запити природною мовою та
|
||||
необов’язкові структуровані фільтри. OpenClaw вмикає вбудований інструмент xAI `x_search`
|
||||
лише для запиту, який обслуговує цей виклик інструмента.
|
||||
|
||||
<Note>
|
||||
xAI документує `x_search` як інструмент, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів
|
||||
і отримання тредів. Для статистики взаємодії окремого допису, як-от репости,
|
||||
відповіді, закладки або перегляди, віддавайте перевагу цільовому пошуку за точним URL допису
|
||||
або ID статусу. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повертати менш
|
||||
xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів
|
||||
і отримання гілок. Для статистики взаємодії з окремим дописом, такої як репости,
|
||||
відповіді, закладки або перегляди, краще використовувати цільовий пошук за точним URL допису
|
||||
або ID статусу. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути менш
|
||||
повні метадані для окремого допису. Хороший шаблон такий: спочатку знайдіть допис, потім
|
||||
виконайте другий запит `x_search`, зосереджений саме на цьому дописі.
|
||||
</Note>
|
||||
@ -343,7 +347,7 @@ OpenClaw також може запропонувати додаткове на
|
||||
cacheTtlMinutes: 15,
|
||||
},
|
||||
webSearch: {
|
||||
apiKey: "xai-...", // optional if XAI_API_KEY is set
|
||||
apiKey: "xai-...", // необов’язково, якщо задано XAI_API_KEY
|
||||
},
|
||||
},
|
||||
},
|
||||
@ -354,15 +358,15 @@ OpenClaw також може запропонувати додаткове на
|
||||
|
||||
### Параметри x_search
|
||||
|
||||
| Параметр | Опис |
|
||||
| -------------------------- | ---------------------------------------------------------- |
|
||||
| `query` | Пошуковий запит (обов’язковий) |
|
||||
| `allowed_x_handles` | Обмежити результати конкретними handle у X |
|
||||
| `excluded_x_handles` | Виключити конкретні handle у X |
|
||||
| `from_date` | Включати лише дописи на цю дату або пізніше (YYYY-MM-DD) |
|
||||
| `to_date` | Включати лише дописи на цю дату або раніше (YYYY-MM-DD) |
|
||||
| `enable_image_understanding` | Дозволити xAI аналізувати зображення, прикріплені до відповідних дописів |
|
||||
| `enable_video_understanding` | Дозволити xAI аналізувати відео, прикріплені до відповідних дописів |
|
||||
| Параметр | Опис |
|
||||
| --------------------------- | ---------------------------------------------------------- |
|
||||
| `query` | Пошуковий запит (обов’язково) |
|
||||
| `allowed_x_handles` | Обмежити результати конкретними хендлами X |
|
||||
| `excluded_x_handles` | Виключити конкретні хендли X |
|
||||
| `from_date` | Включати лише дописи в цю дату або пізніше (YYYY-MM-DD) |
|
||||
| `to_date` | Включати лише дописи в цю дату або раніше (YYYY-MM-DD) |
|
||||
| `enable_image_understanding`| Дозволити xAI аналізувати зображення, прикріплені до відповідних дописів |
|
||||
| `enable_video_understanding`| Дозволити xAI аналізувати відео, прикріплені до відповідних дописів |
|
||||
|
||||
### Приклад x_search
|
||||
|
||||
@ -387,10 +391,10 @@ await x_search({
|
||||
// Базовий пошук
|
||||
await web_search({ query: "OpenClaw plugin SDK" });
|
||||
|
||||
// Пошук, орієнтований на Німеччину
|
||||
// Пошук для Німеччини
|
||||
await web_search({ query: "TV online schauen", country: "DE", language: "de" });
|
||||
|
||||
// Свіжі результати (за минулий тиждень)
|
||||
// Недавні результати (за минулий тиждень)
|
||||
await web_search({ query: "AI developments", freshness: "week" });
|
||||
|
||||
// Діапазон дат
|
||||
@ -415,14 +419,14 @@ await web_search({
|
||||
{
|
||||
tools: {
|
||||
allow: ["web_search", "x_search"],
|
||||
// or: allow: ["group:web"] (includes web_search, x_search, and web_fetch)
|
||||
// або: allow: ["group:web"] (включає web_search, x_search і web_fetch)
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Web Fetch](/uk/tools/web-fetch) -- отримати URL і витягнути придатний для читання вміст
|
||||
- [Web Fetch](/uk/tools/web-fetch) -- отримання URL і витягування читабельного вмісту
|
||||
- [Web Browser](/uk/tools/browser) -- повна автоматизація браузера для сайтів із важким JS
|
||||
- [Grok Search](/uk/tools/grok-search) -- Grok як провайдер `web_search`
|
||||
- [Ollama Web Search](/uk/tools/ollama-search) -- вебпошук без ключа через ваш хост Ollama
|
||||
- [Grok Search](/uk/tools/grok-search) -- Grok як постачальник `web_search`
|
||||
- [Ollama Web Search](/uk/tools/ollama-search) -- безключовий веб-пошук через ваш хост Ollama
|
||||
|
||||
Loading…
Reference in New Issue
Block a user