Подключение к Performance Hub

Главное отличие вашего ИИ-агента от обычного чат-бота заключается в том, что он интегрирован в ваш бизнес. Благодаря подключению через MCP в Performance Hub агент может искать клиентов и участников, проверять бронирования и визиты, проверять состояние здоровья устройств, формировать отчеты — те же операционные данные, которые вы видите в Performance Hub, доступны агенту в ходе беседы и в его автоматизациях.

Вы можете точно контролировать, к какой части Performance Hub агент имеет доступ: к каким объектам, возможностям и даже к каким конкретным инструментам. На этой странице описаны доступные варианты.

Настройка MCP access выполняется в разделе Управление устройствами в меню Конфигурация → MCP access.

Рисунок 1. Раздел MCP access: область доступа, возможности и переключатель вкл./выкл.

Краткая справка

Рекомендация: Оставьте MCP access включенным (значение по умолчанию). Именно это подключение делает агента по-настоящему полезным для вашего бизнеса, а «из коробки» он безопасно ограничен только тем объектом, к которому был добавлен. Если позже вам потребуется, чтобы агент работал с более широкими данными (несколько сайтов, область или вся организация), расширьте Access scope, а не отключайте подключение. «Если этот параметр выключен, агент не сможет получить доступ к каким-либо функциям, инструментам или данным Performance Hub».

Что подключение дает агенту

MCP (Model Context Protocol) — это открытый стандарт, который агент использует для вызова функций Performance Hub: «Разрешить этому агенту вызывать инструменты Performance Hub через служебную учетную запись. На устройстве не хранится ни один ключ — доступ проверяется при каждом запросе и аннулируется в ту же секунду, когда вы отключите эту настройку». На практике это означает, что вы можете задавать такие вопросы, как:

• "Сколько посетителей зарегистрировалось на ресепшене на этой неделе по сравнению с прошлой?"
• "Какие контроллеры дверей сейчас находятся в режиме оффлайн?"
• "Найдите клиента, у которого вчера не прошла оплата, и составьте сводку по его учетной записи."

…и агент отвечает на основе актуальных данных Performance Hub с учетом заданной вами области доступа. На этом же подключении работают автоматизации (утренняя сводка по вчерашним бронированиям, еженедельный дайджест состояния устройств) и встроенный операционный регламент, описанный в разделе Навыки.

Агент выступает в Performance Hub под собственной учетной записью (служебной учетной записью, привязанной к устройству), а не от имени какого-то конкретного человека. Каждый его вызов проверяется на стороне Performance Hub на соответствие предоставленным вами правам — ограничения применяются централизованно, а не на честном слове.

Access scope — какие объекты агент может видеть

• Этот объект (по умолчанию) — объект, к которому был добавлен агент. Подходит для агента, работающего с одним сайтом.
• Выбранные объекты — только те объекты, которые вы укажете. Полезно для агента, обслуживающего несколько сайтов.
• Области — каждый объект в выбранных областях. Полезно для агента регионального менеджера.
• Вся организация — абсолютно всё. Подходит для агентов головного офиса, выполняющих кросс-объектную отчетность.

"Вы можете предоставлять доступ только в рамках собственных объектов, областей и разрешений."

Capabilities — что агент может использовать

Capabilities — это группы инструментов, привязанные к модулям Performance Hub.

• Все возможности (по умолчанию) — "Агент может использовать все доступные возможности, включая новые возможности по мере их добавления."
• Только выбранные возможности — "Агент может использовать только те возможности, которые вы выберете ниже." Агент получает ровно эти возможности и ничего больше, даже если ваши подписки изменятся.
• Все возможности, кроме выбранных — "Агент может использовать все возможности, кроме тех, которые вы выберете ниже. Новые возможности добавляются автоматически." Хороший компромисс: полная функциональность за исключением (например) выставления счетов.

В этом разделе также есть переключатель только для чтения: включите его, и агент сможет искать информацию, но ничего не сможет изменить, поскольку инструменты, вносящие изменения, скрыты и отклоняются. Это самый простой способ запустить строго информационного агента.

Выбор инструментов (дополнительно)

Для более точного контроля разверните раздел Дополнительно и выберите Tool selection — Только выбранные инструменты или Все инструменты, кроме выбранных — чтобы включить или исключить отдельные инструменты в рамках предоставленных возможностей. Например, вы можете разрешить поиск клиентов, но запретить их обновление. Большинству объектов это никогда не понадобится; управления на уровне возможностей вполне достаточно для практических задач.

Last updated by показывает, кто последним изменял права доступа.

Заметка о действиях записи (изменения данных)

Если вы не включите переключатель «только чтение», предоставленный доступ распространяется на все функции, которые предоставляют возможности агента, включая действия, которые изменяют данные, а не только читают их (если модуль это поддерживает). Чтобы агент выполнял только информационные функции, используйте переключатель «только чтение», оставьте только функции для составления отчетов или исключите определенные инструменты. Кроме того, агент запрашивает подтверждение важных действий в ходе беседы перед их выполнением.

Отключение и отзыв доступа

• Выключите MCP access, и агент мгновенно потеряет подключение к Performance Hub. Он продолжит работать как обычный ассистент с доступом к своим файлам и памяти, но больше не сможет видеть ваши бизнес-данные. Изменения (включение, выключение или изменение области действия) вступают в силу через несколько секунд после сохранения; перезапуск не требуется.
• Удаление или сброс настроек агента полностью отзывает его учетные данные.

Кто и что может предоставлять

Права доступа ограничены возможностями того, кто их предоставляет: область действия и возможности, которыми обладаете вы в Организации, являются верхним пределом того, что вы можете передать агенту. Если какой-то параметр недоступен, значит, у вашей роли нет соответствующих прав; в этом случае настройку может выполнить администратор с необходимым доступом. Если вы вообще не можете изменить MCP access, в разделе будет указано: "У вас нет разрешения на настройку MCP access для этого устройства."

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

• Skills — операционный сценарий, который задействует это подключение
• Agent capabilities — подключение агента к другим вашим приложениям
• Automations & scheduled tasks — автономные задачи, использующие данные Performance Hub
• Access control — кто может общаться с агентом (отдельный вопрос от того, к чему агент может получить доступ)
• Security & privacy