Conexión a Performance Hub

Lo que diferencia a su Agente de IA de un chatbot genérico es que está conectado a su negocio. A través de la conexión MCP de Performance Hub, el agente puede buscar clientes y miembros, verificar reservas y visitas, revisar el estado de los dispositivos y extraer informes (los mismos datos operativos que ve en Performance Hub, disponibles para el agente en sus conversaciones y automatizaciones).

Usted controla exactamente a qué partes de Performance Hub puede acceder el agente: qué instalaciones, qué capacidades e incluso qué herramientas individuales. Esta página explica las opciones.

El acceso MCP se configura en Gestión de dispositivos en Configuración → MCP access.

Figura 1: La sección de MCP access: alcance de acceso, capacidades y el interruptor de encendido/apagado

Referencia rápida

Recomendación: Deje el MCP access activado (el valor predeterminado). La conexión es lo que hace que el agente sea verdaderamente útil para su negocio y, de forma predeterminada, está limitada de manera segura únicamente a la instalación en la que se añadió el agente. Si más adelante necesita que el agente trabaje con datos más amplios (varios sitios, una región o toda la organización), amplíe el Access scope en lugar de trabajar sin la conexión. "Si esto se desactiva, el agente no podrá acceder a ninguna función, herramienta o dato de Performance Hub".

Qué le proporciona la conexión al agente

MCP (Model Context Protocol) es el estándar abierto que utiliza el agente para llamar a Performance Hub: "Permitir que este agente llame a las herramientas de Performance Hub a través de una cuenta de servicio. No se almacena ninguna clave en el dispositivo; el acceso se verifica en cada solicitud y se revoca en el momento en que desactive esto". En la práctica, significa que puede hacer preguntas como:

• "¿Cuántos visitantes se registraron en recepción esta semana en comparación con la anterior?"
• "¿Qué controladores de puerta están desconectados ahora mismo?"
• "Busca al cliente cuyo pago falló ayer y haz un resumen de su cuenta".

…y el agente responde a partir de los datos en directo de Performance Hub, limitados a lo que usted le haya concedido. La misma conexión alimenta las automatizaciones (un resumen matutino de las reservas de ayer, un boletín semanal sobre el estado de los dispositivos) y el manual operativo integrado descrito en Habilidades.

El agente actúa con su propia identidad en Performance Hub (una cuenta de servicio vinculada al dispositivo), no como una persona en particular. Cada llamada que realiza se comprueba con el acceso que usted ha concedido aquí, en el lado de Performance Hub; la concesión se aplica de forma centralizada, no basándose en la confianza.

Access scope: qué instalaciones puede ver el agente

• Esta instalación (predeterminado): la instalación en la que se añadió el agente. Es adecuado para un agente de un solo sitio.
• Instalaciones seleccionadas: solo las instalaciones que usted indique. Es útil para un agente que da servicio a unos pocos sitios.
• Regiones: todas las instalaciones de las regiones seleccionadas. Es útil para el agente de un gerente regional.
• Organización completa: todo. Adecuado para agentes de la oficina central que realizan informes entre sitios.

"Solo puede conceder acceso dentro de sus propias instalaciones, regiones y permisos".

Capabilities: qué puede usar el agente

Las capabilities son grupos de herramientas vinculadas a los módulos de Performance Hub.

• Todas las capacidades (predeterminado): "El agente puede utilizar todas las capacidades disponibles, incluidas las nuevas capacidades a medida que se añaden".
• Solo las capacidades seleccionadas: "El agente solo puede utilizar las capacidades que seleccione a continuación". El agente obtiene exactamente estas y nada más, incluso si sus suscripciones cambian.
• Todas las capacidades excepto las seleccionadas: "El agente puede utilizar todas las capacidades excepto las que seleccione a continuación. Las nuevas capacidades se incluyen automáticamente". Un buen término medio: funcionalidad completa, excluyendo (por ejemplo) la facturación.

La sección también cuenta con un interruptor de solo lectura: actívelo y el agente podrá buscar información pero no podrá modificar nada, ya que las herramientas que realizan cambios se ocultan y se rechazan. Es la forma más sencilla de ejecutar un agente estrictamente informativo.

Tool selection (avanzado)

Para un control detallado, expanda Advanced y elija una opción de Tool selection (Solo las herramientas seleccionadas o Todas excepto las herramientas seleccionadas) para incluir o excluir herramientas individuales dentro de las capacidades concedidas. Por ejemplo, podría permitir las búsquedas de clientes pero excluir las actualizaciones de clientes. La mayoría de las instalaciones nunca necesitan esto; el control a nivel de capacidad es el nivel práctico.

Last updated by muestra quién cambió por última vez la concesión.

Una nota sobre las acciones de escritura

A menos que active el conmutador de sólo lectura, la concesión incluye todo lo que exponen las capacidades, incluidas las acciones que cambian los datos y no sólo los leen, en los casos en que un módulo las ofrezca. Para mantener el agente en un rol informativo, utilice el conmutador de sólo lectura, limítelo a capacidades orientadas a informes o excluya herramientas específicas. El agente también confirma las acciones importantes en la conversación antes de realizarlas.

Desactivarlo y revocar el acceso

• Desactive el MCP access y el agente perderá inmediatamente su conexión con Performance Hub: seguirá funcionando como un asistente general con sus archivos y su memory, pero ya no podrá ver los datos de su empresa. Los cambios (activar, desactivar o editar el ámbito) surten efecto a los pocos momentos de guardar; no es necesario reiniciar nada.
• Eliminar o restablecer el agente revoca sus credenciales por completo.

Quién puede conceder qué

Las concesiones se limitan a quien las otorga: el ámbito y las capacidades de los que usted dispone en la organización constituyen el límite máximo de lo que puede ceder al agente. Si una opción no está disponible, se debe a que su propio rol no la incluye; en su lugar, un administrador con el acceso necesario puede configurarla. Si no puede cambiar el MCP access en absoluto, la sección indicará "No tiene permiso para configurar el acceso MCP para este dispositivo."

Páginas relacionadas

• Skills: el manual de procedimientos operativo que pone esta conexión en marcha
• Agent capabilities: conectar el agente a sus otras aplicaciones
• Automations & scheduled tasks: tareas automatizadas que utilizan datos de Performance Hub
• Access control: quién puede hablar con el agente (una cuestión distinta de lo que el agente puede alcanzar)
• Security & privacy