> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Навык: ALOR Calendar

> Описание навыка для чтения и управления Outlook/Exchange календарём ALOR через EWS с настройками из email-канала Велеса.

# Навык: ALOR Calendar

`alor-calendar` — это специализированный навык для работы с Outlook/Exchange календарём ALOR через Exchange Web Services (EWS).

Навык нужен, когда Велесу нужно посмотреть календарь, найти встречу или подготовить изменение события. Он использует настройки подключения из уже настроенного email-канала, поэтому отдельный календарный токен обычно не требуется.

***

## Когда он полезен

Типичные запросы:

* «Покажи мои встречи на завтра».
* «Найди в календаре встречи про квартальный план».
* «Посмотри свободные окна на следующей неделе».
* «Создай встречу с таким-то названием и временем» — только после явного подтверждения.

***

## Как устроено подключение

```mermaid theme={null}
flowchart LR
    request[Запрос пользователя] --> skill[Навык alor-calendar]
    skill --> config{Где взять настройки?}
    config --> env[EXCHANGE_* env]
    config --> email[channels.email]
    email --> ews[EWS / Exchange]
    env --> ews
    ews --> result[Список событий или результат операции]
```

Навык сначала смотрит обычные переменные окружения `EXCHANGE_*`, если они заданы. Если их нет, он берёт данные из `channels.email`: IMAP/SMTP host, имя пользователя, пароль и адрес почтового ящика.

Если доменное имя пользователя записывается в JSON, обратный слеш нужно экранировать: `DOMAIN\\username`.

***

## Возможности

* проверить, хватает ли настроек для подключения;
* показать события за период;
* показать ближайшие события;
* искать встречи по тексту;
* создать событие в календаре после подтверждения пользователя.

Для операций изменения календаря действует правило безопасности: сначала Велес должен кратко описать точное действие, время, участников и текст, затем получить подтверждение.

***

## Технические требования

Навык требует Python-пакеты:

```bash theme={null}
python -m pip install --user exchangelib python-dateutil
```

Основной helper-скрипт:

```text theme={null}
veles/skills/alor-calendar/scripts/outlook_calendar.py
```

Примеры команд:

```bash theme={null}
python scripts/outlook_calendar.py env-check
python scripts/outlook_calendar.py upcoming --days 14
python scripts/outlook_calendar.py list --start 2026-04-01 --end 2026-05-01
python scripts/outlook_calendar.py search --query "планёрка" --start 2026-04-01 --end 2026-05-01
```

По умолчанию используется часовой пояс `Europe/Moscow`, если пользователь или окружение не задают другой.

***

## Ограничения и безопасность

* IMAP не содержит календарные данные; email-конфигурация используется только как источник host/login/password для EWS.
* Пароли и другие секреты нельзя печатать в ответах или сохранять в файлах навыка.
* Отменённые события нужно явно показывать как отменённые, а не silently скрывать их.
* Создание, изменение, отмена и удаление событий требуют явного подтверждения пользователя.

***

## Связанные страницы

* [Каналы и интеграции](/channels_ru)
* [Секреты и токены](/basics/secrets_ru)
* [Навыки Велеса: технический справочник](/skills/reference_ru)