> For the complete documentation index, see [llms.txt](https://support.morozovpimnev.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.morozovpimnev.ru/umnyi-poisk/draivery-poiska.md).

# Драйверы поиска

В модуле существуют следующие драйверы поиска:

* **asmpsmartsearch** - расширенный драйвер hostcms, использует mysql
* **asmpsmartsphinx**  - расширенный драйвер sphinx, использует Sphinx
* **qdrant** - драйвер на базе Qdrant + Embeddings

Конфигурационный файл поиска размещается в `modules/search/config/config.php` и содержит следующие настройки:

* **default** — секция с драйвером по умолчанию, стандартно используется драйвер hostcms н, нужно указать один наших, например: *asmpsmartsearch*;

```php
<?php

return array (
	'default' => array(
		'driver' => 'asmpsmartsearch',
	),
	'asmpsmartsearch' => array(
		'driver' => 'asmpsmartsearch',
	),
	'asmpsmartsphinx' => array(
		'driver' => 'asmpsmartsphinx',
		'database' => 'sphinx',
    'index' => 'hostcms'
	),
	'sphinx' => array(
		'driver' => 'sphinx',
		'database' => 'sphinx',
		'index' => 'hostcms'
	),
	'qdrant' => array(
		'driver' => 'qdrant',
		'url' => 'http://127.0.0.1:6333',
		'api_key' => '',
		'timeout' => 30,
		'score_threshold' => 0.35,
		'yandex' => array(
			'folder_id' => '',
			'api_key' => '',
			'model' => 'text-search-doc',
			'query_model' => 'text-search-query',
			'url' => 'https://llm.api.cloud.yandex.net/foundationModels/v1/textEmbedding',
			'timeout' => 30
		)
	),
	'modules' => array(
		0 => 'Structure',
		1 => 'Informationsystem',
		2 => 'Forum',
		3 => 'Shop',
		4 => 'Helpdesk',
		5 => 'Siteuser',
		6 => 'Document',
		7 => 'Xsl',
		8 => 'Tpl',
		9 => 'Lib',
	),
	'weights' => array(
		'title' => 10,
		'text' => 1,
		'h1' => 6,
		'h2' => 5,
		'h3' => 4,
		'h4' => 4,
		'h5' => 3,
		'h6' => 2,
		'strong' => 2,
		'b' => 2,
		'em' => 2,
		'i' => 2,
		'img-alt' => 0.8,
		'img-title' => 0.8,
		'a-title' => 0.8,
	),
);
```

## Драйвер asmpsmartsphinx

Вам потребуется указать:

* driver — название драйвера;
* **database** — имя секции из конфигурационного файла базы данных для доступа к Sphinx через MySQL-протокол;
* **index** — имя индекса, описанного в конфигурационном файле sphinx.

## Драйвер qdrant

Вам потребуется указать:

* **driver** — название драйвера;
* **url** — Адрес сервера Qdrant. При локальной установке — `http://127.0.0.1:6333`;
* **api\_key** — API-ключ для авторизации в Qdrant. Если авторизация не настроена, оставить пустым;
* **timeout** — Максимальное время ожидания ответа Qdrant в секундах. По умолчанию — `30`;
* **score\_threshold** — Минимальный порог релевантности результатов поиска от `0` до `1`. Чем выше значение, тем строже отбор. Рекомендуемое начальное значение — `0.35`;

**Yandex**

* **folder\_id** — Идентификатор каталога в Yandex Cloud, который вы [получили](https://support.morozovpimnev.ru/umnyi-poisk/sozdanie-klyucha-yandex.cloud.md) на предыдущих шагах;
* **api\_key** — API-ключ Yandex Cloud с необходимыми правами для обращения к моделям embeddings, который вы [получили](https://support.morozovpimnev.ru/umnyi-poisk/sozdanie-klyucha-yandex.cloud.md) на предыдущих шагах;
* **model** — Модель для создания векторов индексируемых документов. По умолчанию — `text-search-doc`.
* **query\_model** — Модель для преобразования поисковых запросов в векторы. По умолчанию — `text-search-query`.
* **url** — Адрес API Yandex Cloud для генерации embeddings. Рекомендуется оставить без изменений.
* **timeout** — Максимальное время ожидания ответа API Yandex Cloud в секундах. По умолчанию — `30`.
