← Обзор / ai-search / configuration / indexing
Поиск по ключевым словам
Включите поиск по ключевым словам, чтобы находить чанки, точно содержащие слова запроса. Обзор режимов поиска см. в Режимы поиска.
Включить поиск по ключевым словам
Задайте index_method.keyword к true при создании или обновлении экземпляра. Поиск по ключевым словам можно использовать отдельно или вместе с векторным поиском для гибридный поиск.
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
vector |
boolean | true |
Включите векторный (семантический) поиск. |
keyword |
boolean | false |
Включите поиск по ключевым словам (BM25). |
Хотя бы один из vector или keyword должен быть true. Изменение index_method запускает полную переиндексацию вашего содержимого.
const instance = await env.AI_SEARCH.create({
id: "my-instance",
index_method: {
vector: false,
keyword: true,
},
});Токенизатор ключевых слов
keyword_tokenizer поле (внутри indexing_options) определяет, как текст разбивается на токены. Изменение этого значения запускает полную переиндексацию.
| Значение | По умолчанию | Описание |
|---|---|---|
porter |
Да | Применяет стемминг Портера. "running" совпадает с "run". Лучше всего подходит для естественного языка. |
trigram |
Нет | Перекрывающиеся окна по 3 символа. "config" совпадает с "configuration." Лучше всего подходит для кода. |
Режим сопоставления ключевых слов
keyword_match_mode поле (внутри retrieval_options) определяет, как объединяются несколько терминов запроса.
| Значение | По умолчанию | Описание |
|---|---|---|
and |
Да | Должны присутствовать все термины запроса. Более высокая точность, но меньше результатов. |
or |
Нет | Совпадать может любой термин запроса. Более высокая полнота, больше результатов. |
Можно переопределить keyword_match_mode за запрос:
const instance = env.AI_SEARCH.get("my-instance");
const results = await instance.search({
messages: [{ role: "user", content: "What is Cloudflare?" }],
ai_search_options: {
retrieval: {
keyword_match_mode: "or",
},
},
});Лимиты
Экземпляры с включённым поиском по ключевым словам поддерживают до 500 000 файлов на экземпляр на тарифе Workers Paid, тогда как экземпляры только с векторным поиском поддерживают до 1 000 000. См. Лимиты и цены для полного списка ограничений.