Действие ALTEGIO: Получить события

Назначение

Действие «Получить события» используется для получения свободных временных слотов для записи в ALTEGIO.

ИИ-агент вызывает эту функцию, когда необходимо проверить доступность даты, услуги или специалиста.

Когда используется

Функция вызывается, если пользователь спрашивает, например:

• «Когда есть свободное время?»

• «Есть ли запись завтра?»

• «Когда свободен мастер Анна?»

• «Есть ли время на маникюр в пятницу?»

Шаг 1. Имя и описание функции

Рекомендуемое имя функции: get_booking_status

Использование данного имени рекомендуется, так как с ним протестирована корректная работа ИИ-агента.

Рекомендуемое описание функции: Проверить свободные слоты. Для конкретного дня укажи одинаковую дату в start_date и end_date.

Шаг 2. Добавление параметров функции

Параметры функции

Для базовой настройки нужно добавить два параметра функции - start_date и end_date.

Параметр	Тип	Рекомендуемая инструкция для параметра	Обязательный
start_date	Текстовый	Дата начала. Формат ISO 8601 (YYYY-MM-DDTHH:mm)	Да
end_date	Текстовый	Дата окончания. Формат ISO 8601 (YYYY-MM-DDTHH:mm)	Да

Дополнительные параметры (по желанию)

Если требуется получать свободные слоты:

• по конкретному специалисту

• по конкретной услуге

необходимо добавить соответствующие параметры:

Параметр	Тип	Обязательный
specialist_name	Текстовый	Нет
service_name	Текстовый	Нет

Настройка параметров specialist_name и service_name

Шаг 3. Выбор действия

В блоке «Выбор действия» в выпадающем списке выберите:

Получить события

Шаг 4. Настройка основных параметров

В настройках действия сопоставьте поля:

• В поле «Время начала события» → выберите параметр start_date

• В поле «Время окончания события» → выберите параметр end_date

Шаг 5. Настройка необязательных параметров

Если добавлены параметры:

• В поле «Услуга» → выберите service_name

• В поле «Имя специалиста» → выберите specialist_name

Дополнительно можно активировать переключатель:

«Добавить доступные услуги сотрудника в полученное расписание».

Это позволит функции вернуть список услуг специалиста, если расписание запрошено без указания конкретной услуги.

ШАГ 6. Добавление инструкции в системный промпт

Для того, чтобы ИИ агент вызывал функцию в нужный момент, добавьте информацию об этом в системный промпт агента.

Пример:

Используй функцию `get_booking_status`, чтобы узнать доступное время для записи.

Логика работы функции

• Если указан специалист → возвращается расписание конкретного специалиста.

• Если указана услуга → возвращаются слоты под конкретную услугу.

• Если параметры не указаны → возвращаются все доступные слоты.

---

Результат функции

Функция возвращает список доступных временных интервалов в заданном диапазоне дат.