Действие «Получить события» используется для получения свободных временных слотов для записи в YCLIENTS.
ИИ-агент вызывает эту функцию, когда необходимо проверить доступность даты, услуги или специалиста.
Когда используется
Функция вызывается, если пользователь спрашивает, например:
«Когда есть свободное время?»
«Когда свободен мастер Анна?»
«Есть ли время на маникюр в пятницу?»
Шаг 1. Имя и описание функции
Рекомендуемое имя функции: get_booking_status
Использование данного имени рекомендуется, так как с ним протестирована корректная работа ИИ-агента.
Рекомендуемое описание функции: Проверить свободные слоты. Для конкретного дня укажи одинаковую дату в start_date и end_date.
Шаг 2. Добавление параметров функции
Параметры функции
Для базовой настройки нужно добавить два параметра функции - start_date и end_date.
Рекомендуемая инструкция для параметра
Дата начала. Формат ISO 8601 (YYYY-MM-DDTHH:mm)
Дата окончания. Формат ISO 8601 (YYYY-MM-DDTHH:mm)
Дополнительные параметры (по желанию)
Если требуется получать свободные слоты:
по конкретному специалисту
необходимо добавить соответствующие параметры:
Шаг 3. Выбор действия
В блоке «Выбор действия» в выпадающем списке выберите:
Получить события
Шаг 4. Настройка основных параметров
В настройках действия сопоставьте поля:
В поле «Время начала события» → выберите параметр start_date
В поле «Время окончания события» → выберите параметр end_date
Шаг 5. Настройка необязательных параметров
Если добавлены параметры:
В поле «Услуга» → выберите service_name
В поле «Имя специалиста» → выберите specialist_name
Дополнительно можно активировать переключатель:
«Добавить доступные услуги сотрудника в полученное расписание».
Это позволит функции вернуть список услуг специалиста, если расписание запрошено без указания конкретной услуги.
ШАГ 6. Добавление инструкции в системный промпт
Для того, чтобы ИИ агент вызывал функцию в нужный момент, добавьте информацию об этом в системный промпт агента.
Пример:
Используй функцию `get_booking_status`, чтобы узнать доступное время для записи.
Логика работы функции
Если указан специалист → возвращается расписание конкретного специалиста.
Если указана услуга → возвращаются слоты под конкретную услугу.
Если параметры не указаны → возвращаются все доступные слоты.
Результат функции
Функция возвращает список доступных временных интервалов в заданном диапазоне дат.