# Получить доступное время

Чтобы ИИ-агент мог правильно создавать события в вашем календаре, ему нужна функция **"Получить доступное время"**. Эта функция позволяет ИИ-агенту анализировать ваше текущее расписание и находить подходящие временные интервалы для новых событий. ИИ-агент учитывает уже занятое время и не предлагает вам те интервалы, которые у вас уже забронированы.

*Пример функции для получения доступного времени:*

**Название: get\_available\_start\_times\_by\_date**\
**Описание:** Получить время доступное для записи\
Добавим в параметрах функции:\
• **`date`**\
Инструкция: **`Дата. Формат - YYYY-MM-DD (например, 2025-01-24)`**. Формат, в котором записываются данные в функцию. Советую использовать именно такой вариант.\
\
Так как у меня несколько услуг, нужно добавить еще параметр\
• **`event_type`** и добавим список услуг, через вложенность одно значение Фитнес массаж, другое Антицеллюлитный массаж.

<figure><img src="/files/nLCdGHqb3AYUuKUTatTq" alt=""><figcaption></figcaption></figure>

### Отправка результатов

Переходим в отправку результатов для Google Calendar.

**Выбор действия.**

Выберите целевое действия **Получить доступное время.**

<figure><img src="/files/RoIDsQ45T1YkkWhgnosI" alt=""><figcaption></figcaption></figure>

### Выбор календаря

• **Способ записи в календарь - Один календарь для всех событий.** Если один календарь, то выбираем это значение. ИИ-агент будет анализировать расписание только с одного календаря.\
• **Отдельный календарь для каждого значения**. Так как у меня несколько услуг, то выбираем параметр **`event_type.`**&#x418;И-агент будет анализировать расписание с выбранных календарей.

<figure><img src="/files/ZnXiZiIYEHRWlrrEdyEs" alt=""><figcaption></figcaption></figure>

### Способ поиска доступного времени

• **За конкретную дату. П**озволяет ИИ-агенту анализировать ваше текущее расписание за конкретную дату. Выберите параметр функции с датой. Формат - YYYY-MM-DD (например, 2025-01-24).

<figure><img src="/files/otUymlrbUfIGpZ3lVspg" alt=""><figcaption></figcaption></figure>

• **За период (дата и время).** Позволяет ИИ-агенту анализировать текущее расписание за определенный период. Для этого нужно выбрать параметр функции с начальной и конечной датой и временем. Формат - YYYY-MM-DDTHH:mm (например, 2025-01-24T19:30), например\
\&#xNAN;**`startTime`** и **`endTime`**

<figure><img src="/files/vqgmQAalyWsMfEmucxSN" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/yakID6M2fltLYplciF2q" alt=""><figcaption><p>В Telegram</p></figcaption></figure>

### Продолжительность события

**"Продолжительность события"** помогает ИИ-агенту анализировать, можно ли записать событие в выбранное время. Например, если вы хотите записаться на услугу, ИИ проверит, работает ли услуга в это время и хватит ли оставшегося времени до конца рабочего дня. Если до закрытия осталось всего 10 минут, а событие требует больше времени, ИИ не станет его записывать в календарь, а предложит перенести событие на другой день.

• **Фиксированное значение,** укажите продолжительность события в минутах.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fe8GFyf0rS55qdY7PXK4g%2F%D0%B2%D1%80%D0%B5%D0%BC%D1%8F%20%D1%84%D0%B8%D0%BA%D1%81%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5.png?alt=media&#x26;token=06c2f4f9-17db-428b-82c4-16ebf94f2486" alt=""><figcaption></figcaption></figure>

• **Значение из числового параметра функции,** выберите **числовой** параметр функции, значение которого будет использовано как продолжительность события в минутах.\
Для этого нужно создать параметр `time` в функции.

• **Своя продолжительность для каждого значения,** выбираете параметр функции, для каждого значения которого будет задана своя продолжительность. Указываем продолжительность в минутах.

<figure><img src="/files/dV7wrPxAHSSZV9SXTHxk" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/functional/integrations/google-kalendar/poluchit-dostupnoe-vremya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.