Полнотекстовый поиск вакансий по словам в названии и описании (Postgres tsvector, синтаксис websearch: кавычки для точной фразы, минус перед словом — исключить его). Используйте, когда запрос содержит конкретные термины: должность, технологию, компанию. Для поиска по смыслу и синонимам без точных слов используйте semantic_search. Пустой query — не ошибка, вернутся вакансии по фильтрам, отсортированные по дате публикации. Описание в каждом результате обрезано; полный текст — через get_vacancy по id.

Полная карточка одной вакансии по её id из hh.ru: незакрытое описание, работодатель, все требуемые навыки, ссылка на hh.ru. Используйте после search_vacancies/semantic_search, чтобы изучить конкретную вакансию подробно, или перед compare_to_profile.

Статистика по навыкам: какие технологии чаще всего требуются в подходящих под фильтр вакансиях, их доля и медианная зарплата вакансий, где навык нужен. Используйте для вопросов «что сейчас востребовано» или «что учить». Не возвращает список вакансий — для него используйте search_vacancies.

Общий срез рынка по фильтру: сколько вакансий, у скольких указана зарплата и её персентили (p25/p50/p75), доля удалённых, разбивка по требуемому опыту и топ-10 работодателей. Используйте для агрегированных вопросов вида «какие сейчас зарплаты» или «много ли удалёнки» — не для списка конкретных вакансий.

Честно сопоставляет вакансию с профилем кандидата (profile.yaml): verdict good/stretch/no, совпавшие и недостающие навыки, а если verdict «no» — конкретные причины отказа (blockers): зарплата ниже минимума, требуемый опыт выше принимаемого, не подходящая занятость, не удалённая работа, стоп-слово из red_flags. Используйте перед тем, как рекомендовать вакансию кандидату как хороший вариант — не оценивайте пригодность вакансии самостоятельно. По умолчанию грузит profile.yaml из корня проекта (шаблон — profile.example.yaml); profile_path позволяет указать другой файл.

Поиск вакансий по смыслу через векторные эмбеддинги описаний, а не по точным словам. Используйте, когда запрос описывает задачу своими словами или ищет по концепции без гарантии, что в вакансии есть именно эти слова. Для поиска по конкретным терминам используйте search_vacancies — он быстрее и не требует установленного extra rag. Возвращает вакансии с оценкой похожести (similarity).

Служебная информация о состоянии базы: сколько вакансий/работодателей/навыков загружено, сколько описаний уже проиндексировано эмбеддингами, какой моделью они посчитаны, за какой период данные и когда их в последний раз собирали. Вызывайте в начале работы, чтобы понимать границы доступных данных и не выдумывать вакансии или статистику, которых в базе нет. Параметров не принимает.