Agentes
Conecte un agente de IA (Claude Code, Claude Desktop, Cursor, VS Code o Gemini CLI) a la cuenta para consultar configuraciones y eventos en la propia conversación. El agente accede a la cuenta mediante el protocolo MCP (Model Context Protocol) y opera con los permisos del usuario que autorizó la conexión.
La función está en fase de pruebas. Las funcionalidades y los límites de uso pueden cambiar sin aviso previo.
La conexión está destinada al uso interno, por parte de los colaboradores de la cuenta. No exponga la conexión a terceros ni la incorpore a un producto ofrecido a los clientes de la cuenta. Para ese uso, hable con soporte.
Conectar un agente
En Agentes > Conectar agente:
- Seleccione el agente por su logotipo. La pantalla muestra las instrucciones específicas de ese agente.
- En el agente, indique la URL del servidor MCP y el client_id mostrados en la pantalla. Si el agente pide un secreto de cliente (
client secret), déjelo en blanco. - Cuando el agente lo solicite, autorice el acceso a la cuenta desde el navegador.
Para agentes de línea de comandos, la pantalla muestra un comando listo para la terminal en lugar de los pasos 1 y 2. La autorización desde el navegador es la misma.
La pantalla lista los agentes registrados. Un agente fuera de la lista debe ser habilitado por soporte antes de conectarse.
El agente accede a una cuenta a la vez, indicada en la pantalla de conexión. Para consultar otra cuenta, conecte el agente nuevamente desde ella.
Agentes conectados
Agentes lista las conexiones del usuario autenticado en la cuenta, con el cliente, la fecha de la autorización y la última actividad. La última actividad se actualiza cada quince minutos. La pantalla indica las conexiones que nunca se usaron.
Desconectar finaliza el acceso del agente de inmediato. Las demás conexiones, del mismo usuario y de los otros, siguen activas. El agente desconectado vuelve a operar solo después de una nueva autorización.
Permisos
El agente opera en nombre del usuario que autorizó la conexión y hereda el perfil de acceso de ese usuario. Cada llamada pasa por dos verificaciones, y ambas deben ser aprobadas: el permiso del usuario y el consentimiento concedido al agente en la conexión.
| Consentimiento | Qué autoriza |
|---|---|
| Lectura de la configuración | consultar tipos de evento, campos, reglas, análisis, métricas, monitoreos y listas |
| Lectura de los datos de la cuenta | consultar los eventos recibidos, los valores medidos de una métrica y los valores recibidos por un campo |
| Escritura de la configuración | cambiar el nombre y la descripción de un campo |
Los eventos contienen datos personales, como correos electrónicos, direcciones IP, BINs de tarjeta e identificadores de dispositivo. Por eso la lectura de los datos de la cuenta es un consentimiento separado. Una conexión puede leer la configuración de la cuenta sin acceder a ningún evento.
Operaciones
El agente lista y detalla cada tipo de configuración, consulta eventos y métricas y edita campos:
| Operación | Contenido |
|---|---|
| Cuenta | datos generales de la cuenta conectada y los consentimientos concedidos a la conexión |
| Tipos de evento | lista de los tipos y el detalle de cada uno, con sus campos |
| Campos | valores ya recibidos por un campo, incluso por un campo de lista sin ítems registrados |
| Eventos | conteo de los eventos de un período en bloques de tiempo, con división opcional por un campo, y las filas de evento |
| Reglas | lista de las reglas y el detalle de una versión, con sus condiciones y acciones |
| Análisis | lista de los análisis y el detalle de uno, con el efecto de cada celda y las reglas que lo ejecutan y lo registran |
| Métricas | lista de las métricas, el detalle de una (dimensiones, agregaciones y filtros) y los valores por período, con la franja esperada y las alertas |
| Monitoreos | lista de los monitoreos y el detalle de uno, con sus criterios |
| Listas | lista de las listas configuradas y el detalle de una |
| Edición de campo | cambio del nombre y de la descripción de un campo |
La consulta de eventos admite los mismos filtros de Explorar, incluida la referencia a una lista y la comparación entre campos. La consulta cubre una ventana reciente, no todo el historial de la cuenta.
En clientes que muestran interfaces del MCP, los valores de una métrica aparecen como gráfico en la conversación.
Cada respuesta incluye la dirección del artículo correspondiente de esta documentación. El agente consulta la referencia en lugar de deducir el comportamiento de la plataforma.
Preguntas típicas:
- qué regla decide determinado tipo de evento;
- qué métricas existen sobre un campo;
- qué hace una versión de regla, antes de publicarla;
- cuántos eventos de un tipo llegaron por estado en el período.
Consentimientos
Una operación sin consentimiento no aparece para el agente. Para el agente, es igual a una operación que no existe.
La operación Cuenta informa los consentimientos de la conexión y las operaciones retenidas, con el consentimiento que falta en cada una. Cuando el agente responde que algo no es posible, pídale que consulte la cuenta. La respuesta muestra si la operación existe y solo no fue consentida.
Para liberar la operación, reconecte el agente concediendo el consentimiento que falta, conforme Conectar un agente. Una conexión existente no obtiene acceso sin esa nueva autorización.
Las operaciones que el perfil de acceso del usuario no permite no aparecen como retenidas. Ninguna reautorización las liberaría, porque la barrera es el permiso del usuario, no el del agente.
Límites de uso
Las llamadas tienen un límite por usuario y por cuenta en una ventana de tiempo, con un valor propio para cada operación. Al superar el límite, el agente recibe un rechazo y vuelve a operar en la ventana siguiente.