> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/integrations/google-kalendar/poluchit-dostupnoe-vremya.md).

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

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

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FFUnr1VAhbbyylARv5olP%2F%7B2C993373-EACD-457F-A1FE-B16D970A8D80%7D.png?alt=media&amp;token=eeeeeeb4-7d4d-46f3-bf17-4d82a0cb65a3" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FTnu90mh6FXzkF1eQUmoO%2F%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C.png?alt=media&amp;token=0c864686-6674-4daf-990e-81f66321d09e" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FUhHFwbKBq1t7QpT7nBKZ%2F%7B2335A883-3BA3-4E8A-9416-DD716C7F61F5%7D.png?alt=media&amp;token=333e2f28-021d-4994-8381-c4f8ae277a4d" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FGCrBrf9AuP1UDeyPMF9I%2F%7B907F7231-A24D-4926-913B-14C6A8CFCAC2%7D.png?alt=media&amp;token=096bf51a-aace-431d-a31a-58a50a5f60c7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F0mJYtw1URHJZGYqTaJU4%2F%D0%B7%D0%B0%20%D0%BF%D0%B5%D1%80%D0%B8%D0%BE%D0%B4.png?alt=media&amp;token=acb39afa-e752-414c-b416-075ef35ff2e7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FTdLit0A5MwfxsQLptZ4E%2F%D1%81%D0%B2%D0%BE%D0%B1%D0%BE%D0%B4%D0%BD%D0%BE%D0%B5%20%D0%B2%D1%80%D0%B5%D0%BC%D1%8F%20%D0%B7%D0%B0%20%D0%BF%D0%B5%D1%80%D0%B8%D0%BE%D0%B4.png?alt=media&amp;token=2069a710-c660-48c2-ab87-7ee81870181d" 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="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fq8HikdBiXxo9aMHkzNZr%2F%7B64128589-1C45-4F9A-9466-3B91D4BDC1FC%7D.png?alt=media&amp;token=4cc35c04-1757-4070-b1a7-952a764d019b" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
