Agentes de AnomalyArmor

Habilidades de IA y servidor MCP para la observabilidad de datos de AnomalyArmor. Monitoriza la calidad de los datos, detecta la deriva del esquema y gestiona alertas directamente desde Claude Code, Cursor o cualquier herramienta de IA compatible con MCP.

Versión: 0.6.0 | Herramientas: 52 herramientas MCP consolidadas | Habilidades: 14 comandos de barra

Inicio rápido

Opción 1: Plugin de Claude Code (Recomendado)

# Install the plugin
claude plugin marketplace add anomalyarmor/agents
claude plugin install armor@anomalyarmor

# Or via skills.sh
npx skills add anomalyarmor/agents

Luego usa habilidades como:

• /armor:status - Comprobar el estado de los datos

• /armor:alerts - Ver y gestionar alertas

• /armor:recommend - Obtener recomendaciones de monitorización de IA

• /armor:ask - Hacer preguntas sobre tus datos

Opción 2: Servidor MCP

Añádelo a tu configuración de MCP (Claude Code, Cursor, etc.):

{
  "mcpServers": {
    "armor": {
      "command": "uvx",
      "args": ["armor-mcp"]
    }
  }
}

Related MCP server: aegis-dq

Requisitos previos

1. Cuenta de AnomalyArmor: Regístrate en anomalyarmor.ai

2. Clave API: Genera una en Ajustes > Claves API

3. Configurar: Establece la variable de entorno ARMOR_API_KEY o crea ~/.armor/config.yaml:

api_key: aa_live_your_key_here

Habilidades disponibles

Herramientas MCP (29 consolidadas)

Las herramientas siguen un patrón consolidado: una herramienta por dominio maneja múltiples operaciones a través de un parámetro action, reduciendo el uso de la ventana de contexto mientras se mantiene la funcionalidad completa.

Salud y Resumen

• health_summary() - Salud general de los datos en todos los activos

• get_todays_briefing() - Resumen diario de IA con alertas, frescura y brechas de cobertura

Alertas (5 herramientas)

• get_alerts_summary() - Recuento de alertas por gravedad y estado

• list_alerts(status, severity, asset_id, from_date, to_date) - Consultar alertas con filtros

• list_inbox_alerts(status, limit) - Bandeja de entrada de alertas no resueltas

• update_alert(alert_id, action, ...) - Reconocer, resolver, posponer o comentar alertas

• get_alert_trends(period) - Tendencias de alertas a lo largo del tiempo

• get_alert_history(alert_id) - Historial completo de una alerta específica

Reglas de Alerta (3 herramientas)

• list_alert_rules(asset_id, is_active) - Listar reglas configuradas

• create_alert_rule(asset_id, rule_type, ...) - Crear nueva regla de alerta

• manage_alert_rule(rule_id, action, ...) - Actualizar, eliminar, activar/desactivar o duplicar reglas

Activos (3 herramientas)

• list_assets(source, asset_type, search) - Listar activos monitorizados

• create_asset(name, source_type, connection_config) - Crear fuente de datos

• manage_asset(asset_id, action, ...) - Actualizar, eliminar, probar conexión o activar descubrimiento

• trigger_asset_discovery(asset_id) - Iniciar descubrimiento de esquema

Frescura (4 herramientas)

• get_freshness_summary() - Resumen de frescura en todos los activos

• check_freshness(asset_id, table_path) - Comprobar la frescura de una tabla específica

• setup_freshness(asset_id, table_path, check_interval, ...) - Crear programación de frescura

• list_freshness_schedules(asset_id) - Listar programaciones configuradas

• manage_freshness_schedule(schedule_id, action, ...) - Actualizar, eliminar, pausar/reanudar programaciones

Deriva del Esquema (5 herramientas)

• get_schema_summary() - Resumen de deriva del esquema

• list_schema_changes(asset_id, severity, from_date, to_date) - Listar cambios detectados

• create_schema_baseline(asset_id, description) - Crear línea base

• enable_schema_monitoring(asset_id, schedule_type, notify_on) - Habilitar monitorización

• disable_schema_monitoring(asset_id) - Deshabilitar monitorización

• get_schema_monitoring(asset_id) - Ver configuración de monitorización actual

• dry_run_schema(asset_id, schedule_type) - Probar monitorización de esquema antes de habilitar

Calidad de Datos (4 herramientas)

• get_metrics_summary(asset_id) / list_metrics(asset_id) - Ver métricas

• create_metric(asset_id, metric_type, table_path, ...) - Crear recuento de filas, tasa de nulos o métrica personalizada

• manage_metric(metric_id, action, ...) - Actualizar, eliminar, capturar o ver instantáneas

• get_validity_summary(asset_id) / list_validity_rules(asset_id) - Ver reglas de validez

• create_validity_rule(asset_id, rule_type, table_path, ...) - Crear regla de validez

• manage_validity_rule(rule_id, action, ...) - Actualizar, eliminar, comprobar o ver resultados

Integridad Referencial (2 herramientas)

• create_referential_check(asset_id, ...) - Crear comprobación referencial entre tablas

• manage_referential(check_id, action, ...) - Listar, eliminar, ejecutar o ver resultados

Destinos (4 herramientas)

• list_destinations(destination_type) - Listar destinos de alertas (Slack, correo electrónico, webhook)

• setup_destination(destination_type, ...) - Crear canal de Slack, correo electrónico o destino de webhook

• manage_destination(destination_id, action, ...) - Actualizar, eliminar, probar, activar/desactivar

• manage_rule_destinations(rule_id, action, ...) - Vincular/desvincular destinos a reglas de alerta

Cobertura y Recomendaciones (3 herramientas)

• get_coverage(asset_id) - Nivel de cobertura y puntuación de un activo

• manage_coverage(asset_id, action) - Obtener siguientes pasos o aplicar monitorización recomendada

• recommend(asset_id, recommendation_type) - Recomendaciones de IA para frescura, métricas, cobertura o umbrales

Inteligencia (2 herramientas)

• ask_question(asset, question) - Preguntas y respuestas en lenguaje natural

• generate_intelligence(asset) - Activar generación de base de conocimientos de IA

Catálogo (4 herramientas)

• get_lineage(asset_id, depth, direction) - Gráfico de linaje de datos

• job_status(job_id) - Comprobar estado de trabajo asíncrono

• create_tag(asset_id, name, object_path, ...) - Crear y asignar etiquetas

• list_tags(asset_id) / apply_tags(asset_id, ...) - Listar y aplicar etiquetas

Claves API

• get_api_key_info() - Ver detalles y permisos de la clave API actual

Ejemplos

Comprobar la salud de los datos

User: Is my data healthy?

Your data health status:
- Overall: WARNING
- 3 unresolved alerts (1 critical, 2 warning)
- 2 stale tables (orders, customers)
- 1 unacknowledged schema change
- Coverage: 65% (Tier 2: Protected)

Obtener recomendaciones de IA

User: What should I monitor on my Snowflake warehouse?

Based on your table patterns and update frequency:
1. orders (high traffic) - Add freshness check (hourly), row count metric
2. customers (PII) - Enable schema drift monitoring, add null checks
3. payments (financial) - Add freshness + row count + validity rules

Want me to set these up? I can configure all three in one go.

Resumen diario

User: What happened overnight?

Your daily briefing:
- 2 new alerts: orders table stale (6h), schema change in users
- Coverage improved: finance schema now at Tier 3 (Verified)
- Recommendation: 4 tables still have no monitoring. Run /armor:recommend.

Análisis de causa raíz

User: Why is the orders table stale?

Investigation results:
- Last update: 6 hours ago (expected: hourly)
- Upstream dependency: raw_orders was last updated 8 hours ago
- Likely cause: upstream ETL job failed or delayed
- Impact: 3 downstream dashboards affected

Solución de problemas

Fallo de autenticación

Error: No API key configured

Solución: Establece la variable de entorno ARMOR_API_KEY o crea ~/.armor/config.yaml

Servidor MCP no encontrado

Error: MCP server 'armor' not found

Solución:

1. Reinicia tu herramienta de IA después de los cambios de configuración

2. Verifica que uvx esté instalado: uvx --version

3. Comprueba la sintaxis de configuración de MCP

Las habilidades no se cargan

Solución:

1. Verifica que el plugin esté instalado: claude plugin list

2. Comprueba que el directorio de habilidades exista

3. Reinicia Claude Code

Desarrollo

Consulta AGENTS.md para ver las directrices de desarrollo.

Soporte

• Problemas: GitHub Issues

• Documentación: docs.anomalyarmor.ai

• Correo electrónico: support@anomalyarmor.ai

Licencia

Licencia MIT - ver LICENSE