Работа с агентом

Найти сотрудника

Найди сотрудника по e-mail marina@example.com и покажи его должность,
группы и текущий статус. Используй team_list_users и team_get_user.

Адрес в примере условный. Поиск со знаком @ выполняется по e-mail. Если агент одновременно укажет группу, приоритет будет у фильтра группы: поиск нужно выполнить отдельным вызовом.

Посмотреть отсутствующих

Сначала получи список календарей. Покажи отсутствия сотрудников
с 1 по 30 ноября 2026 года: отдельно по людям и по видам отсутствий.
Ничего не создавай.

Для свода агент использует team_get_absences, для отдельных записей — team_list_events с kind=status. Названия календарей берутся с вашей установки: наличие календарей «Отпуск» или «Болезнь» заранее не предполагается.

На условных данных показаны сотрудники отдела, виды отсутствий, периоды и число дней.

Отметить отсутствие

Найди Марину по e-mail marina@example.com и проверь календарь «Отпуск».
Если сотрудник и календарь найдены однозначно, проверь события с 9 по
13 ноября 2026 года и отметь отпуск на эти дни через team_mark_absence.
После создания покажи запись. Если похожий отпуск уже есть, сообщи об этом.

Создание отсутствия не требует confirm=true. Повторный вызов создаёт новую запись, поэтому проверка существующих событий помогает избежать дублей.

Пригласить сотрудника

Создай приглашение для Ильи с e-mail ilya@example.com.
Сначала проверь, нет ли уже действующего сотрудника или приглашения
с этим адресом. После создания покажи contact_id и срок приглашения.
Группы и права пока не назначай.

Обязателен только e-mail. При необходимости инструмент принимает сведения профиля, группы и уровни доступа по приложениям. Срок приглашения в описании инструмента — трое суток; фактическая дата истечения возвращается в ответе. Ответ не содержит ссылки приглашения.

В примере агент сообщает о создании приглашения, добавлении сотрудника в отдел и полном доступе к CRM.

Проверить права

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

Нужны право токена team_get_access и администратор приложения «Команда». Для объяснения агент использует is_admin, список приложений и from_groups.

На условных данных показаны уровни доступа по приложениям и их источники: группа или личное назначение.

Изменить состав группы

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

team_set_group_members заменяет состав целиком. Все участники, отсутствующие в новом массиве, исключаются. Вызов принимает от 1 до 200 контактов и не требует confirm=true.

Отключить сотрудника

Найди сотрудника по e-mail oleg@example.com и покажи его карточку.
Перед отключением запроси моё согласие. После согласия вызови
team_disable_user с confirm=true и проверь состояние сотрудника.

Плагин проверяет параметр подтверждения, а получение согласия в разговоре поручается агенту. Для обратного включения используется team_enable_user. Отключение меняет состояние пользователя и не удаляет его контакт.

Агент показывает последствия отключения и запрашивает согласие до закрытия входа в бэкенд.

Какие данные получает клиент

Данные возвращаются подключённому MCP-клиенту в ответах на вызовы. Состав зависит от инструмента и прав:

Отдельного API-ключа внешнего сервиса, webhook или задания cron в плагине нет. MCP-соединение и авторизацию обеспечивает приложение MCP. Если клиент использует внешний ИИ-сервис, дальнейшая передача полученных ответов определяется устройством этого клиента.