Агенты AnomalyArmor

ИИ-навыки и MCP-сервер для наблюдаемости данных AnomalyArmor. Контролируйте качество данных, обнаруживайте дрейф схемы и управляйте оповещениями прямо из Claude Code, Cursor или любого другого ИИ-инструмента с поддержкой MCP.

Версия: 0.6.0 | Инструменты: 52 консолидированных инструмента MCP | Навыки: 14 команд через слэш

Быстрый старт

Вариант 1: Плагин Claude Code (рекомендуется)

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

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

Затем используйте такие навыки, как:

• /armor:status — Проверка состояния данных

• /armor:alerts — Просмотр и управление оповещениями

• /armor:recommend — Получение рекомендаций по мониторингу от ИИ

• /armor:ask — Запросы к вашим данным

Вариант 2: MCP-сервер

Добавьте в конфигурацию MCP (Claude Code, Cursor и т.д.):

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

Related MCP server: aegis-dq

Предварительные требования

1. Учетная запись AnomalyArmor: Зарегистрируйтесь на anomalyarmor.ai

2. API-ключ: Создайте его в разделе Settings > API Keys

3. Настройка: Установите переменную окружения ARMOR_API_KEY или создайте файл ~/.armor/config.yaml:

api_key: aa_live_your_key_here

Доступные навыки

Инструменты MCP (29 консолидированных)

Инструменты следуют консолидированному шаблону: один инструмент на домен обрабатывает несколько операций через параметр action, что сокращает использование контекстного окна при сохранении полной функциональности.

Состояние и сводки

• health_summary() — Общее состояние данных по всем активам

• get_todays_briefing() — Ежедневная ИИ-сводка с оповещениями, актуальностью и пробелами в покрытии

Оповещения (5 инструментов)

• get_alerts_summary() — Количество оповещений по серьезности и статусу

• list_alerts(status, severity, asset_id, from_date, to_date) — Запрос оповещений с фильтрами

• list_inbox_alerts(status, limit) — Входящие нерешенные оповещения

• update_alert(alert_id, action, ...) — Подтверждение, решение, откладывание или комментирование оповещений

• get_alert_trends(period) — Тренды оповещений во времени

• get_alert_history(alert_id) — Полная история конкретного оповещения

Правила оповещений (3 инструмента)

• list_alert_rules(asset_id, is_active) — Список настроенных правил

• create_alert_rule(asset_id, rule_type, ...) — Создание нового правила оповещения

• manage_alert_rule(rule_id, action, ...) — Обновление, удаление, включение/выключение или дублирование правил

Активы (3 инструмента)

• list_assets(source, asset_type, search) — Список отслеживаемых активов

• create_asset(name, source_type, connection_config) — Создание источника данных

• manage_asset(asset_id, action, ...) — Обновление, удаление, проверка подключения или запуск обнаружения

• trigger_asset_discovery(asset_id) — Запуск обнаружения схемы

Актуальность (4 инструмента)

• get_freshness_summary() — Обзор актуальности по всем активам

• check_freshness(asset_id, table_path) — Проверка актуальности конкретной таблицы

• setup_freshness(asset_id, table_path, check_interval, ...) — Создание расписания актуальности

• list_freshness_schedules(asset_id) — Список настроенных расписаний

• manage_freshness_schedule(schedule_id, action, ...) — Обновление, удаление, приостановка/возобновление расписаний

Дрейф схемы (5 инструментов)

• get_schema_summary() — Обзор дрейфа схемы

• list_schema_changes(asset_id, severity, from_date, to_date) — Список обнаруженных изменений

• create_schema_baseline(asset_id, description) — Создание базовой линии

• enable_schema_monitoring(asset_id, schedule_type, notify_on) — Включение мониторинга

• disable_schema_monitoring(asset_id) — Отключение мониторинга

• get_schema_monitoring(asset_id) — Просмотр текущей конфигурации мониторинга

• dry_run_schema(asset_id, schedule_type) — Тестирование мониторинга схемы перед включением

Качество данных (4 инструмента)

• get_metrics_summary(asset_id) / list_metrics(asset_id) — Просмотр метрик

• create_metric(asset_id, metric_type, table_path, ...) — Создание количества строк, частоты null или пользовательской метрики

• manage_metric(metric_id, action, ...) — Обновление, удаление, захват или просмотр снимков

• get_validity_summary(asset_id) / list_validity_rules(asset_id) — Просмотр правил валидности

• create_validity_rule(asset_id, rule_type, table_path, ...) — Создание правила валидности

• manage_validity_rule(rule_id, action, ...) — Обновление, удаление, проверка или просмотр результатов

Ссылочная целостность (2 инструмента)

• create_referential_check(asset_id, ...) — Создание межтабличной проверки целостности

• manage_referential(check_id, action, ...) — Список, удаление, запуск или просмотр результатов

Назначения (4 инструмента)

• list_destinations(destination_type) — Список назначений оповещений (Slack, email, webhook)

• setup_destination(destination_type, ...) — Создание канала Slack, email или webhook-назначения

• manage_destination(destination_id, action, ...) — Обновление, удаление, тест, включение/выключение

• manage_rule_destinations(rule_id, action, ...) — Привязка/отвязка назначений к правилам оповещений

Покрытие и рекомендации (3 инструмента)

• get_coverage(asset_id) — Уровень покрытия и оценка актива

• manage_coverage(asset_id, action) — Получение следующих шагов или применение рекомендованного мониторинга

• recommend(asset_id, recommendation_type) — ИИ-рекомендации по актуальности, метрикам, покрытию или порогам

Интеллект (2 инструмента)

• ask_question(asset, question) — Вопросы и ответы на естественном языке

• generate_intelligence(asset) — Запуск генерации базы знаний ИИ

Каталог (4 инструмента)

• get_lineage(asset_id, depth, direction) — Граф происхождения данных

• job_status(job_id) — Проверка статуса асинхронной задачи

• create_tag(asset_id, name, object_path, ...) — Создание и назначение тегов

• list_tags(asset_id) / apply_tags(asset_id, ...) — Список и применение тегов

API-ключи

• get_api_key_info() — Просмотр деталей и разрешений текущего API-ключа

Примеры

Проверка состояния данных

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)

Получение ИИ-рекомендаций

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.

Ежедневная сводка

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.

Анализ первопричин

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

Устранение неполадок

Ошибка аутентификации

Error: No API key configured

Решение: Установите переменную окружения ARMOR_API_KEY или создайте файл ~/.armor/config.yaml

MCP-сервер не найден

Error: MCP server 'armor' not found

Решение:

1. Перезапустите ИИ-инструмент после внесения изменений в конфигурацию

2. Проверьте, установлен ли uvx: uvx --version

3. Проверьте синтаксис конфигурации MCP

Навыки не загружаются

Решение:

1. Проверьте, установлен ли плагин: claude plugin list

2. Проверьте наличие каталога навыков

3. Перезапустите Claude Code

Разработка

См. AGENTS.md для руководств по разработке.

Поддержка

• Проблемы: GitHub Issues

• Документация: docs.anomalyarmor.ai

• Email: support@anomalyarmor.ai

Лицензия

Лицензия MIT — см. LICENSE