Exchange (EWS)

Карточка собрана автоматически из манифеста пакета. Так же пакет выглядит во вкладке «Обзор» в Студии.

Навыкиexchangeверсия 1.3.1agentchat

Навыки чтения календаря Exchange/OWA через EWS: встречи за диапазон/неделю, кто текущий пользователь, диагностика EWS. Переиспользует настройки и подход фонового пакета exchange-calendar.

Навыки в пакете · 8

• Прочитать элементget_item

  Прочитать элемент (встречу/задачу) по ItemId: тема, время, место, организатор, участники. Только чтение.

  Параметры: 2

  Параметр	Тип	Описание
  item_id *	string	EWS ItemId элемента (из create_meeting/create_task/list_appointments).
  change_key	string	ChangeKey элемента (опционально).

• Удалить элементdelete_item

  Удалить встречу/задачу по ItemId (HardDelete, без отмены приглашений).

  Параметры: 2

  Параметр	Тип	Описание
  item_id *	string	EWS ItemId элемента.
  change_key	string	ChangeKey элемента (опционально).

• Создать задачуcreate_task

  Создать задачу (Task) в списке задач Exchange текущего пользователя. Задача пишется в папку «Список задач» (To-Do).

  Параметры: 7

  Параметр	Тип	Описание
  subject *	string	Тема задачи (обязательно).
  body	string	Описание / тело задачи (опционально).
  due	string	Срок в ISO datetime или YYYY-MM-DD (конец дня). Опционально.
  start	string	Дата начала в ISO datetime или YYYY-MM-DD. Опционально.
  priority	string	Приоритет (опционально, по умолчанию normal).
  categories	array	Категории (опционально).
  percent_complete	number	Процент выполнения 0-100 (опционально).

• Встречи за диапазонlist_appointments

  Встречи календаря Exchange текущего пользователя за произвольный диапазон дат (только чтение). Даты: YYYY-MM-DD, конец включительный. По умолчанию: сегодня.

  Параметры: 4

  Параметр	Тип	Описание
  start_date	string	Начало, YYYY-MM-DD (или ISO datetime). По умолчанию: сегодня.
  end_date	string	Конец, YYYY-MM-DD (включительно). По умолчанию: start_date.
  timezone	string	IANA-пояс, напр. Europe/Moscow. По умолчанию: из настроек пакета.
  max_items	number	Максимум встреч (1-2000). По умолчанию: из настроек пакета.

• Встречи неделиweek_appointments

  Встречи за календарную неделю Пн-Вс (или Пн-Пт при weekdays_only=true), содержащую anchor. Отдаёт окно недели (дни) и нормализованные встречи.

  Параметры: 4

  Параметр	Тип	Описание
  anchor	string	Любая дата недели, YYYY-MM-DD. По умолчанию: сегодня.
  timezone	string	IANA-пояс, напр. Europe/Moscow.
  weekdays_only	boolean	true: только Пн-Пт (рабочая неделя).
  max_items	number	Максимум встреч (1-2000).

• Текущий пользовательwhoami

  Проверяет, под кем сконфигурирован доступ: маскированный логин, режим авторизации и доступ к папке Календарь.

• Диагностика EWSdiagnose

  Проверяет доступность сервера EWS и предлагаемую схему авторизации (NTLM/Negotiate/Basic): без учётных данных пользователя.

• Создать встречуcreate_meeting

  Создать встречу в календаре Exchange текущего пользователя. Организатор: пользователь, чьи учётные данные сконфигурированы (exchange_login/exchange_password). Написание по правилам календаря Exchange (встреча пишется в папку Календарь организатора).

  Параметры: 9

  Параметр	Тип	Описание
  subject *	string	Тема встречи (обязательно).
  start *	string	Начало в ISO datetime (напр. 2025-02-10T10:00:00). По умолчанию берётся локальный пояс из настроек пакета.
  end *	string	Конец в ISO datetime (напр. 2025-02-10T11:00:00).
  body	string	Текст описания встречи (опционально).
  location	string	Место встречи (опционально).
  sensitivity	string	Чувствительность. По умолчанию normal.
  reminder_minutes	number	Напоминание за N минут (не более 1440 = 24 часа).
  attendees	array	Список участников (опционально). Каждый: { address, name?, optional? }.
  send_to_attendees	boolean	true: сразу разослать приглашения участникам (по умолчанию false: только в календарь организатора).

Настройки пакета · 8

Подключение

• URL EWSews_urlобязательнообщее

  Точка подключения Exchange Web Services, напр. https://mail.example.com/EWS/Exchange.asmx

• Тип аутентификацииauth_typeобщее

  ntlm: доменная авторизация (нужен «Домен»); basic: обычная Basic по HTTPS.

• Домен (для NTLM)domainобщее

  Оставьте пустым, если NTLM не используется. Можно указывать как DOMAIN или DOMAIN\.

Учётные данные

• Логин Exchangeexchange_loginобязательнообщее

  Шаблон логина. По умолчанию {{user.login}}: логин берётся у текущего пользователя.

• Пароль Exchangeexchange_passwordобязательносекретна пользователя

  Личный пароль каждого пользователя (персональная настройка).

Отображение

• Часовой поясtimezoneобщее

  Пояс, в котором считаются даты. IANA, напр. Europe/Moscow.

• Максимум встреч за запросmax_itemsобщее

  Ограничение CalendarView (1-2000). По умолчанию 500.

• Проверять TLS-сертификатverify_tlsобщее

  Отключите только для OWA с самоподписанным сертификатом.

Зависит от SDK

@eva/skill-sdk@eva/agent-sdk@eva/agent-chat-sdk@eva/widget-sdk@eva/context@eva/artifacts

Как подключить

Администратор загружает пакет в разделе Админ → Пакеты или публикует его из Студии. После публикации пакет появляется у пользователей: навыки в каталоге Навыки, а виджеты фоновых сервисов на доске виджетов. Настройки с меткой «общее» задаёт администратор, с меткой «на пользователя» каждый пользователь заполняет у себя.

Подробнее о жизненном цикле пакета: Студия: публикация и версии. Весь каталог: Пакеты EVA.