Навык «Календарь»

Навык помогает добавить готовое событие в Google Calendar коротким действием, а также подключает Искру к личному календарю по протоколу CalDAV: показывает план на день или неделю, ищет встречи и свободные окна, создаёт, переносит и отменяет встречи. Полное подключение работает с Яндекс Календарём, Mail.ru, iCloud, Nextcloud и корпоративными CalDAV-серверами. Пароль, введённый в форму подключения, не передаётся AI-модели. Сервер Искры использует его для входа на подключённый сервер календаря по HTTPS и ведёт обмен с ним.

Навык — про разовые действия по просьбе: «покажи план на завтра», «перенеси встречу». Если вы хотите, чтобы события и задачи ходили между Искрой и календарём постоянно и сами, это отдельная настройка — «Календари и задачи» в настройках; см. раздел «Синхронизация календарей и задач». Одно другому не мешает: навык можно оставить, а можно и не устанавливать вовсе.

Подключения у них тоже разные, и это важно при первой настройке. В мастере «Календарей и задач» вы выбираете карточку своей службы, и адрес сервера она знает сама — поля адреса там нет. У навыка карточек нет: адрес сервера здесь обычное поле формы, которое для почты на домене организации заполняется вручную. Подробности — ниже.

Быстрое событие в Google Calendar

Назовите событие, дату, время и длительность, например: «Добавь в Google Calendar силовую тренировку 18 августа в 15:00 на час». Искра сразу подготовит ссылку на заполненную форму события. Откройте её, проверьте данные и нажмите «Сохранить» в Google Calendar.

Можно назвать длительность («на час») или точное время окончания: Искра сама рассчитает конец события и корректно учтёт переход на следующие сутки.

Для этого действия не нужен пароль приложения и не требуется подключать календарь. Событие ещё не создано, пока вы не сохраните его в открывшейся форме Google. Если вы явно назвали часовой пояс, Искра передаст его в форму; без указанной зоны время интерпретируется в часовом поясе вашего аккаунта Google. Если вы не назвали целевой календарь, Искра одним коротким вопросом предложит выбрать Google Calendar или уже подключённый календарь.

Установка навыка ради быстрого Google-события не открывает форму подключения. Настройки CalDAV понадобятся позже только для чтения календаря, поиска свободных окон или изменения встреч через Искру.

Короткий Google-маршрут готовит разовые события со временем или на весь день. Для запроса с повторением Искра объяснит эту границу и не станет превращать серию в один экземпляр. Ссылка будет подготовлена только после вашего явного решения перейти к полностью заданному разовому событию; recurrence/RRULE в неё не добавляются.

Подключение

Полное подключение нужно, когда вы хотите читать календарь, искать свободные окна или менять встречи прямо через Искру. Оно выполняется паролем приложения — отдельным паролем, который вы создаёте у провайдера специально для внешних программ (не основной пароль от почты).

Пароль приложения: Яндекс, Mail.ru, iCloud, Nextcloud

Шаг 1. Создайте пароль приложения у своего провайдера.

• Яндекс — Яндекс ID → «Безопасность» → «Пароли приложений». Пароли у Яндекса раздельные по типу доступа — для календаря нужна именно категория «CalDAV для Календаря». Пароль от почты календарь не откроет: это отдельный пароль, создайте новый в нужной категории. Для ящика Яндекс 360 на домене организации всё то же самое: тот же Яндекс ID и та же категория пароля.
• Mail.ru — Настройки почты → «Безопасность» → «Пароли для внешних приложений».
• iCloud — appleid.apple.com → «Безопасность» → пароль для приложения (нужна включённая двухфакторная аутентификация Apple ID).
• Nextcloud / корпоративный сервер — обычный пароль или пароль приложения (если администратор их включил); адрес CalDAV-сервера узнайте у администратора.

Адрес сервера, часовой пояс и рабочие часы

Шаг 2. Заполните настройки навыка в Искре. Витрина навыков → «Календарь» → добавить в личный профиль → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает страница навыка → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к календарю»:

• Логин (адрес почты) — полный адрес, например ivan@yandex.ru. Для почты Яндекс 360 на домене организации — вместе с этим доменом, например ivan@corp.ru; у iCloud логином остаётся Apple ID, даже если почта приходит на адрес собственного домена;
• Адрес сервера — если почта на публичном домене службы (@yandex.ru, @ya.ru, @mail.ru, @inbox.ru, @list.ru, @bk.ru, @icloud.com, @me.com), поле можно оставить пустым: Искра определит сервер сама по адресу почты. Если почта на домене организации (Яндекс 360, Mail.ru для бизнеса, iCloud+ с собственным доменом), впишите адрес службы сами — https://caldav.yandex.ru, https://calendar.mail.ru или https://caldav.icloud.com: по домену компании сервер календаря обычно не находится. Для Nextcloud или корпоративного сервера впишите его явно, например cloud.company.ru — указывать точный путь CalDAV не обязательно, Искра сама перебирает стандартные варианты (/.well-known/caldav, /caldav/, /dav/) на введённом адресе. Если вписать http://…, Искра сама заменит его на https:// — по незащищённому протоколу подключение не пойдёт;
• Часовой пояс — можно оставить пустым: обычно он уже известен из вашего профиля (браузер сообщает его при входе). Заполните вручную, только если Искра попросит;
• Рабочие часы — используются при поиске свободных окон; по умолчанию 09:00–18:00, будни;
• Пароль приложения — вставьте пароль, созданный на шаге 1. Поле write-only, как и обычные ключи: посмотреть сохранённое значение нельзя, только заменить.

Шаг 3. Подключение личное: календарь настраивается на ваш профиль, а не на всю организацию — агент работает с вашим личным календарём.

Пароль приложения вводите через форму настроек навыка: там он сохраняется отдельно от переписки. Пароль, отправленный обычным сообщением, становится частью чата и доступен AI-модели.

Что умеет

• Быстрое событие в Google Calendar — предзаполненная форма с названием, временем, местом и описанием без настройки подключения; сохранение завершает пользователь в Google Calendar.
• План на день или неделю в подключённом CalDAV-календаре — события за период по всем вашим календарям сразу, с пометкой накладок (пересекающихся по времени встреч) и событий «на весь день». Искра называет, из каких календарей собран ответ. Предел чтения — 90 дней и 200 встреч в одном ответе; неполный результат отмечается отдельно.
• Поиск встречи в подключённом CalDAV-календаре — найти встречу по названию за период; регистр букв не важен, включая кириллицу («Планёрка» и «планёрка» совпадают).
• Свободные окна в подключённом CalDAV-календаре — свободное время нужной длительности в ваши рабочие часы с учётом занятости по всем календарям.
• Создание встречи в подключённом CalDAV-календаре — с местом, участниками, описанием, напоминанием («напомнить за» — от 10 минут до 1 дня) и повторением (ежедневно, по будням, еженедельно, ежемесячно, ежегодно) с окончанием по дате.
• Перенос и изменение CalDAV-встречи — время, название, место, напоминание, описание.
• Отмена CalDAV-встречи.

Для повторяющейся встречи при переносе, изменении и отмене Искра спрашивает охват: только этот экземпляр или вся серия. Создание и изменение CalDAV-встречи по умолчанию подтверждаются формой. Если в настройках навыка выключено «Спрашивать каждый раз», полностью заполненное действие может выполниться сразу; удаление требует отдельного явного согласия в чате. Указанные участники не получают приглашений — их нужно отправить отдельно.

Формы подтверждения

В подключённом CalDAV-календаре создание, перенос и изменение встречи проходят по умолчанию через форму-черновик: проверьте поля встречи и нажмите «Создать встречу» или «Сохранить». Отдельного подтверждения в переписке не требуется. Если в Настройках → Работа навыка → Подтверждение вы выключили «Спрашивать каждый раз», заполненное создание или изменение может выполниться сразу. Неполную форму Искра предложит дополнить. Отмена встречи по-прежнему требует вашего явного согласия текстом в чате.

Для Google Calendar Искра открывает форму самого Google. Событие появляется в календаре только после сохранения в этой форме.

Приглашения участникам не рассылаются

Участников встречи можно вписать — они попадут в событие, — но приглашения им не отправляются: письмо с приглашением никто не получит. Искра предупреждает об этом при создании встречи. Разослать приглашения можно отдельно, например письмом через навык «Почта».

Ответить на чужое приглашение (принять или отклонить встречу, куда позвали вас) через навык тоже нельзя — это делается в самом календаре провайдера.

Чем «Календарь» отличается от «Планов» Искры

Это два разных механизма, их легко перепутать по названию:

• «Планы» (раздел Искры) — это ваш собственный календарь и список задач внутри платформы, включая регулярные прогоны агента: задачи, которые Искра выполняет по времени сама. Связь с внешним календарём включается отдельно в синхронизации календарей и задач; установка этого навыка её не настраивает. Подробнее о разделе — «Раздел «Планы»».
• «Календарь» (этот навык) — это события в вашем внешнем личном календаре: короткое предзаполненное действие для Google Calendar либо чтение и правка встреч на подключённом сервере (Яндекс, Mail.ru, iCloud, Nextcloud). Он не запускает агента по расписанию.

Ограничения

• Приглашения не рассылаются, ответить на чужое приглашение нельзя (см. выше).
• Охват «этот и последующие» для повторяющихся встреч не поддерживается — только отдельный экземпляр или вся серия целиком.
• Период чтения по умолчанию — 7 дней, максимум 90 дней и до 200 встреч в одном ответе; если встреч больше, Искра честно помечает, что показала часть, и предлагает сузить период.
• Для Google Calendar доступно добавление нового события через предзаполненную форму. Искра не читает и не синхронизирует Google-календарь, не переносит и не удаляет уже созданные там события.
• Microsoft 365 и Outlook.com CalDAV не поддерживают — для корпоративной почты и календаря на собственном сервере Exchange (не Microsoft 365/Exchange Online) есть навык «Microsoft Exchange: почта и календарь».
• Корпоративный сервер, доступный только во внутренней сети организации, навык подключить не сможет без разрешения администратора контура.

Типичные ошибки

Передача пароля и безопасность календаря CalDAV

Пароль календаря, введённый в форму подключения, хранится в защищённом хранилище отдельно от переписки: AI-модель и код навыка не получают его из настроек. Сервер Искры использует этот пароль для входа на сервер календаря по HTTPS (Basic-аутентификация). Сохранённое значение нельзя посмотреть в настройках повторно — его можно заменить. Логин и адрес сервера являются обычными параметрами и могут быть доступны Искре при работе с подключением.

Пароль, отправленный обычным сообщением, становится частью чата и доступен AI-модели. Форма подключения не скрывает и не удаляет такой текст из переписки. Для подключения календаря используйте поле пароля в форме.

При поиске календаря и перенаправлениях CalDAV пароль может передаваться между поддоменами одного регистрируемого домена, например между calendar.example.org и dav.example.org. При переходе на другой домен данные для входа снимаются: HTTPS-запрос туда возможен, но уже без пароля. Поэтому адрес подключения должен принадлежать службе, которой вы доверяете.

Пароль из настроек не записывается в обычные служебные журналы подключения. Пароль приложения можно отозвать в личном кабинете провайдера — тогда навык перестанет подключаться, пока вы не создадите и не впишете новый.