# Agentes Un agente de IA puede conectarse a la cuenta para consultar su configuración, tipos de evento, campos, reglas, métricas, monitores y listas, y los valores de las métricas a lo largo del tiempo. La conexión usa el protocolo MCP (Model Context Protocol), compatible con los asistentes de código y de chat más comunes. La función está **en fase de pruebas**. Las funcionalidades disponibles y los límites de uso pueden cambiar en cualquier momento, sin aviso previo. ## Qué puede ver el agente El acceso se concede en su nombre y opera con **sus** permisos: el agente nunca alcanza algo que su [perfil de acceso](/es/admin/users/#perfiles-de-acceso) no alcance. Se aplican dos verificaciones a cada llamada, y ambas deben pasar: el permiso del usuario que autorizó y el permiso consentido al agente en el momento de la conexión. | Permiso | Qué autoriza | | :------ | :----------- | | Lectura de la configuración | consultar tipos de evento, campos, reglas, análisis, métricas, monitores y listas | | Lectura de los datos de la cuenta | consultar los eventos recibidos, los valores medidos de una métrica y los valores ya recibidos por un campo | | Escritura de la configuración | cambiar el nombre y la descripción de un campo | La lectura de los datos de la cuenta alcanza datos personales presentes en los eventos, como correos electrónicos, direcciones IP, BINs de tarjeta e identificadores de dispositivo. Por eso se consiente aparte de la lectura de la configuración: una conexión puede leer la configuración de la cuenta sin alcanzar ningún dato de evento. El agente actúa sobre una cuenta a la vez, indicada en la pantalla de conexión. Para consultar otra cuenta, conecte el agente nuevamente desde ella. ## Cómo conectar En **Agentes > Conectar agente**: 1. Seleccione el agente por su logotipo. La pantalla pasa a mostrar las instrucciones específicas de ese agente. 2. Configure el agente con la **URL del servidor MCP** y el **client_id** indicados en la pantalla. Donde el agente pida un secreto de cliente (`client secret`), déjelo en blanco: la conexión no usa secreto. 3. Autorice el acceso a la cuenta desde el navegador, cuando el agente lo solicite. Los agentes de línea de comandos presentan, en lugar de los pasos anteriores, un comando listo para ejecutar en la terminal, seguido de la misma autorización desde el navegador. Hoy están previstos **Claude Code**, **Claude Desktop**, **Cursor**, **VS Code** y **Gemini CLI**. Un agente todavía no registrado debe ser habilitado por nosotros antes de conectarse: hable con soporte si el suyo no está en la lista. ## Agentes conectados **Agentes** lista las conexiones existentes en la cuenta a nombre del usuario autenticado, con el cliente, la fecha de la autorización y la última actividad registrada, actualizada en intervalos de quince minutos. Una conexión que nunca se usó se identifica como tal. **Desconectar** finaliza el acceso de ese agente de inmediato, sin afectar las demás conexiones ni las de los otros usuarios. Un agente desconectado vuelve a operar solo después de una nueva autorización. ## Qué puede hacer el agente El agente dispone de operaciones de listado y de detalle sobre cada tipo de configuración, además de la consulta de los valores ya observados en un campo: | Operación | Contenido | | :-------- | :-------- | | Cuenta | datos generales de la cuenta conectada, con 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 observados en un campo, incluidos los valores recibidos por un campo de lista sin ítems registrados | | Eventos | conteo de los eventos de un período en bloques de tiempo, opcionalmente dividido por un campo, y las propias 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, con dimensiones, agregaciones y filtros, y los valores medidos por período, con la franja esperada y las alertas del intervalo | | Monitores | lista de los monitores 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 la descripción de un campo | La consulta de eventos admite los mismos filtros de [Explorar](/es/admin/explore/), incluida la referencia a una lista y la [comparación entre campos](/es/admin/explore/#comparación-entre-campos). Responde sobre una ventana reciente, no sobre todo el historial de la cuenta. En clientes compatibles con interfaces del MCP, la consulta de los valores de una métrica se presenta como gráfico en la propia conversación. Las preguntas típicas son de orientación y de revisión: 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. Cada respuesta trae también la dirección del artículo correspondiente de esta documentación, de modo que el agente consulte la referencia en lugar de deducir el comportamiento de la plataforma. ## Consentimientos Las operaciones que el agente alcanza dependen de los consentimientos concedidos en el momento de la conexión. Una operación no consentida no aparece para el agente, lo que la vuelve indistinguible de una que no existe. Por eso la consulta a la cuenta informa qué consentimientos recibió la conexión y qué operaciones quedaron retenidas, con el consentimiento que falta en cada una. Un agente que responde que algo no es posible puede, con eso, verificar si la operación existe y solo no fue consentida. La liberación exige reconectar el agente concediendo el consentimiento que falta, conforme [Cómo conectar](#cómo-conectar). Una conexión existente no pasa a alcanzar nada más sin esa nueva autorización. Las operaciones que el [perfil de acceso](/es/admin/users/#perfiles-de-acceso) del usuario no alcanza no se relacionan como retenidas: ninguna reautorización las concedería, porque la verificación que las bloquea es la del usuario, no la del agente. ### Cambio en el consentimiento de lectura La consulta de los valores de una métrica y el listado de los valores de un campo pasaron a exigir la **lectura de los datos de la cuenta**, antes alcanzadas por la lectura de la configuración. Una conexión autorizada únicamente para leer la configuración deja de alcanzar ambas, y vuelve a alcanzarlas después de reconectada con el nuevo consentimiento. ## Límites de uso Las llamadas están limitadas por usuario y por cuenta en una ventana de tiempo, con un límite propio para cada operación, dimensionado según su costo y su frecuencia esperada. Un agente que supera el límite recibe el rechazo y vuelve a operar en la ventana siguiente.