Herramientas

El servidor MCP de Glass Data ofrece al agente las herramientas listadas en esta página, y el agente elige la herramienta según la pregunta. Cada herramienta exige un nivel de acceso de la conexión en la cuenta y un perfil de acceso mínimo del usuario.

Toda herramienta, excepto list_accounts, recibe la cuenta por su slug en el argumento account. El agente recibe la lista completa de herramientas cualquiera que sea su acceso, y una llamada sin el acceso o el perfil exigido se rechaza con lo que liberaría la herramienta. La herramienta describe_account informa las herramientas retenidas en la cuenta.

El comportamiento común a las herramientas, como la comparación de versiones y la simulación, está en Operaciones.

Cuentas

Herramienta Qué hace Acceso Perfil
list_accounts lista las cuentas del usuario, con el slug, el entorno (producción o prueba), si la conexión está habilitada en cada cuenta y lo que el agente puede hacer en ella no exige no exige
describe_account describe una cuenta: nombre, entorno, estado, zona horaria, acceso de la conexión, perfil del usuario y herramientas retenidas, con lo que liberaría cada una Leer Sólo lectura

Tipos de evento y campos

Herramienta Qué hace Acceso Perfil
list_event_types lista los tipos de evento, con el estado, la cantidad de campos, métricas y monitoreos y la hora del último evento aceptado, incluido el tipo _failure Leer Sólo lectura
describe_event_type describe los campos de un tipo de evento: identificador, nombre, tipo de dato, configuraciones, valores aceptados y usos Leer Sólo lectura
list_field_values lista los valores que acepta un campo y los valores recibidos desde una fecha, con el nombre que representa cada valor Leer Sólo lectura
list_field_elements lista los ítems de un campo de lista o booleano, con la etiqueta, el color y el ícono de cada ítem Leer Sólo lectura
create_event_field crea un campo en un tipo de evento, con identificador, tipo de dato y tipo de propiedad que no se pueden cambiar después Leer y modificar Editor
update_event_field modifica el nombre, la descripción, la obligatoriedad, la herencia y el tamaño máximo de un campo Leer y modificar Editor
add_field_elements incluye ítems en un campo de lista, en lote Leer y modificar Editor
update_field_elements modifica el valor, la etiqueta, el color o el ícono de ítems de un campo de lista o booleano, en lote, excepto los valores de un campo booleano Leer y modificar Editor
remove_field_elements elimina ítems de un campo de lista, en lote, sin cambiar el valor de los eventos ya grabados Leer y modificar Editor
deactivate_event_field desactiva un campo y mantiene los valores grabados, que vuelven si el campo se reactiva en el panel Leer y modificar Editor
remove_event_field elimina un campo, y los valores grabados dejan de poder consultarse Leer y modificar Editor

Eventos y exportación

Herramienta Qué hace Acceso Perfil
count_events cuenta los eventos de un período en bloques de tiempo, con filtros y división opcional por un campo Leer Sólo lectura
find_events lista los eventos que cumplen los filtros, del más reciente al más antiguo, con los campos elegidos Leer Sólo lectura
create_export inicia una exportación de los eventos que cumplen los filtros, con todos los campos activos del tipo de evento Leer Analista
describe_export informa el estado de una exportación y devuelve el enlace de descarga, que exige el perfil Analista Leer Sólo lectura
list_exports lista las exportaciones recientes de la cuenta, incluidas las iniciadas en el panel, y el consumo del límite diario Leer Sólo lectura

Métricas y monitoreos

Herramienta Qué hace Acceso Perfil
list_metrics lista las métricas, con el tipo de evento, la agrupación, la cantidad de filtros y las agregaciones de cada métrica Leer Sólo lectura
describe_metric describe una métrica: filtros, agregaciones y granularidades, con el período que alcanza cada granularidad Leer Sólo lectura
query_metric lee los valores de una métrica en un período reciente o en una ventana pasada, con la franja esperada y las alertas Leer Sólo lectura
list_monitors lista los monitoreos, con la métrica, el intervalo, la detección, el estado y la cantidad de segmentos analizados en los últimos 30 días Leer Sólo lectura
describe_monitor describe un monitoreo: filtros, criterios, ajustes de la detección de anomalías, última ejecución y destino de las alertas Leer Sólo lectura

Reglas

Herramienta Qué hace Acceso Perfil
list_rules lista las reglas, con el tipo de evento, la versión activa y la cantidad de condiciones de cada regla Leer Sólo lectura
describe_rule describe una versión de regla, la activa por defecto: condiciones en orden de evaluación, subcondiciones, expresiones, acciones y el modo de cada nivel Leer Sólo lectura
create_rule crea una regla en un tipo de evento, con un borrador vacío Leer y modificar Editor
draft_rule crea un borrador a partir de una versión, la activa por defecto Leer y modificar Editor
add_rule_condition incluye una condición o un Si no en un borrador: al final, antes o después de otra condición, o como subcondición Leer y modificar Editor
add_rule_action incluye una acción independiente en un borrador Leer y modificar Editor
update_rule_condition modifica la expresión, el nombre, las acciones, el modo, la posición o la condición superior de una fila del borrador Leer y modificar Editor
remove_rule_condition elimina una fila del borrador, con sus subcondiciones Leer y modificar Editor
update_rule modifica el modo de evaluación del primer nivel de un borrador de regla de evento Leer y modificar Editor
validate_rule valida el borrador completo e informa los avisos del editor Leer y modificar Editor
compare_rule_versions compara dos versiones condición por condición, con la versión activa como base por defecto Leer Sólo lectura
simulate_rule simula una versión con valores informados, incluido un borrador, y puede probar junto un borrador de análisis Leer Sólo lectura

Listas

Herramienta Qué hace Acceso Perfil
list_lists lista las listas, con el tipo de valor, la cantidad de ítems y las reglas activas que consultan cada lista Leer Sólo lectura
describe_list describe una lista y, fila por fila y en la sintaxis de la regla, las reglas que consultan la lista (in o not in) o incluyen ítems en ella Leer Sólo lectura
lookup_list_items verifica si hasta 100 valores están en la lista, con el autor, la fecha de inclusión, la validez y la descripción de cada ítem, sin consumir el límite de consultas Leer Sólo lectura
list_list_items lista los ítems de una lista en páginas, con búsqueda opcional por parte del valor, y consume el límite de consultas Leer Sólo lectura
add_list_items incluye hasta 1.000 valores en una lista, con descripción y plazo de validez opcionales, y reemplaza un valor que ya está en la lista, con el ítem reemplazado en la respuesta Leer y modificar Analista
remove_list_items elimina hasta 1.000 valores de una lista, informa los valores que no estaban en la lista y avisa cuando una regla vuelve a incluir ítems en ella. La eliminación de todos los ítems se hace en el panel Leer y modificar Analista

Las inclusiones y eliminaciones valen a partir del evento siguiente, también en las reglas activas.

Análisis

Herramienta Qué hace Acceso Perfil
list_analyses lista los análisis, con el tipo de evento, la versión activa, la cantidad de celdas y las reglas que ejecutan y registran cada análisis Leer Sólo lectura
describe_analysis describe una versión de análisis: las celdas en orden y, en las versiones activas o en observación (shadow), el efecto de cada celda en los últimos 30 días Leer Sólo lectura
create_analysis crea un análisis en un tipo de evento, con un nombre que no se puede cambiar después, y abre el primer borrador Leer y modificar Editor
draft_analysis abre un borrador a partir de una versión, la activa por defecto Leer y modificar Editor
add_analysis_cell incluye una celda en el borrador, al final, antes o después de otra celda Leer y modificar Editor
update_analysis_cell modifica o mueve una celda del borrador, y exige confirmación para un cambio que reinicia la ventana de la celda Leer y modificar Editor
remove_analysis_cell elimina una celda del borrador Leer y modificar Editor
compare_analysis_versions compara dos versiones celda por celda, con los cambios que reinician la ventana de una celda Leer Sólo lectura
simulate_analysis simula una versión con valores informados y presenta la medida de cada celda frente a su disparador Leer Sólo lectura

El agente no publica reglas ni análisis: la publicación se hace en el panel, mediante la comparación y publicación.