Официальные навыки Elastic
<p align="center"> <img alt="Логотип Elastic" src="https://assets.kitploit.com/production/public/readmes/12587/8e357b6e4cbecb13a462cd8da398525dbe599bb7210c6426f2f1103702561816.png" width="200"> </p> <p align="center"> <a href="https://github.com/elastic/agent-skills/blob/main/LICENSE"><img alt="Лицензия" src="https://img.shields.io/badge/license-Apache%202.0-blue"></a> </p> # Elastic Agent Skills Elastic Agent Skills — созданные людьми, которые создали Elastic — передают экспертизу нативной платформы напрямую вашему ИИ-агенту для программирования. Это официальная библиотека Agent Skills, совместимая с агентными IDE, такими как Cursor, GitHub Copilot, Windsurf, Gemini CLI и другими. Навыки следуют открытому стандарту [Agent Skills](https://agentskills.io/). > [!NOTE] > **Технический предпросмотр** > > Эти навыки находятся на ранней стадии выпуска и активно развиваются. Ожидайте изменений по мере того, как навыки будут оформляться с помощью надёжных > оценок и по мере развития ландшафта моделей. Заглядывайте сюда часто, чтобы быть в курсе обновлений. ## О проекте Этот репозиторий содержит тщательно отобранные навыки — пакеты инструкций, контекста и инструментов, которые учат любого ИИ-агента правильно работать с Elasticsearch, Kibana, Elastic Observability и Elastic Security. Добавьте их в среду выполнения агента, которую вы уже используете, и ваш ассистент перестанет использовать устаревшие шаблоны и начнёт делать всё правильно. ## Что такое навыки? Навыки — это самодостаточные пакеты, которые дают ИИ-агентам знания и инструменты для выполнения конкретных задач воспроизводимым образом. Каждый навык находится в собственной папке с файлом `SKILL.md`, содержащим метаданные и инструкции, которым следует агент. Дополнительную информацию о стандарте Agent Skills см. на [agentskills.io](http://agentskills.io/). ## Область применения Навыки в этом репозитории сосредоточены на: - Взаимодействии с API Elasticsearch (поиск, индексирование, управление кластером) - Создании и управлении контентом Kibana, таким как алерты, коннекторы и другое - Шаблонах для Elastic Observability, Elastic Security и Agent Builder <!-- BEGIN-SKILL-TABLE --> ## Доступные навыки <details> <summary>Cloud (2)</summary> | Навык | Описание | Версия | Автор | | ----- | ----------- | ------- | ------ | | [cloud-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/cloud/onboarding/SKILL.md) | Подключение организации Elastic Cloud: настройка Cloud-контекста и API-ключа CLI `elastic`, установка региона по умолчанию, затем приглашение пользователей, назначение предопределённых или пользовательских ролей Serverless-проектов и создание или отзыв Cloud API-ключей. Используйте при настройке аутентификации Cloud или при предоставлении, изменении или аудите доступа пользователей к организации и её проектам. | 0.3.0 | elastic | | [cloud-provisioning](https://github.com/elastic/agent-skills/blob/main/skills/cloud/provisioning/SKILL.md) | Развёртывание и эксплуатация инфраструктуры Elastic Cloud: создание, подключение к, обновление и удаление Serverless-проектов (Elasticsearch, Observability, Security); управление фильтрами трафика (сетевая безопасность IP и AWS PrivateLink); и управление жизненным циклом развёртываний Elastic Cloud Hosted. Используйте при создании или выполнении операций второго дня для serverless-проектов или hosted-развёртываний, либо при ограничении их сетевого доступа. | 0.3.0 | elastic | </details> <details> <summary>Elasticsearch (10)</summary> | Навык | Описание | Версия | Автор | | ----- | ----------- | ------- | ------ | | [elasticsearch-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection/SKILL.md) | Создание и управление заданиями обнаружения аномалий Elastic ML через API. Используйте при настройке заданий для индекса или потока данных, конфигурировании заданий и потоков данных (datafeeds), а также при их открытии, запуске или остановке. | 1.1.0 | elastic | | [elasticsearch-anomaly-detection-explainer](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-anomaly-detection-explainer/SKILL.md) | Объяснение оценок обнаружения аномалий Elasticsearch ML, поведения модели и интерпретации результатов. Используйте, когда пользователь спрашивает, почему оценка высокая или низкая, как обучается модель, что означают числа или как устранить неожиданные оценки аномалий. | 0.3.0 | elastic | | [elasticsearch-cluster-health](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-cluster-health/SKILL.md) | Диагностика кластера Elasticsearch в состоянии, отличном от зелёного, с выявлением наиболее вероятной причины и рекомендациями по устранению. Используйте, когда оператор сообщает о жёлтом или красном статусе, нераспределённых шардах, сбоях размещения или хочет провести триаж только для чтения перед более глубоким расследованием. Обучает влиянию реплик по сравнению с первичными шардами, классификации решателей размещения (allocation decider) и осведомлённости о потере данных. | 0.1.0 | elastic | | [elasticsearch-esql](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-esql/SKILL.md) | Выполнение запросов ES\|QL (Elasticsearch Query Language); используйте, когда пользователь хочет запрашивать данные Elasticsearch, анализировать логи, агрегировать метрики, исследовать данные или создавать графики и дашборды на основе результатов ES\|QL. | 0.10.0 | elastic | | [elasticsearch-index-design](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-index-design/SKILL.md) | Проектирование и проверка маппингов индексов Elasticsearch для заданных шаблонов доступа: правильные типы полей, мультиполя text+keyword, настройка doc_values, предотвращение разрастания маппинга и явные настройки шардов. Используйте при создании нового индекса, проверке маппинга на предмет производительности хранения или запросов, исправлении неверных типов полей или когда пользователь спрашивает, какой тип использовать для поиска, фильтрации, сортировки или агрегации по полю. | 0.1.0 | elastic | | [elasticsearch-ingest](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-ingest/SKILL.md) | Загрузка файлов CSV, JSON и NDJSON в индексы Elasticsearch с помощью bulk API и явных маппингов, когда типы полей имеют значение. Используйте при пакетном импорте локальных файлов, преобразовании строк CSV или массивов JSON в bulk-формат NDJSON, проверке подключения к кластеру с помощью elastic es info перед загрузкой или проверке количества документов и маппингов после загрузки — не для конвейеров Logstash, Beats, пользовательских скриптов или переиндексации между индексами. | 0.1.3 | elastic | | [elasticsearch-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-onboarding/SKILL.md) | Помощь разработчикам, новым в Elasticsearch, пройти путь от нуля до работающего поискового опыта. Проведите их через понимание их намерения, маппинг их данных и создание поискового опыта с заложенными лучшими практиками. Используйте, когда пользователь выражает намерение создать функциональность, связанную с поиском, спрашивает о концепциях Elasticsearch для своего случая использования или выражает потребность в помощи с началом работы с Elasticsearch. | 0.3.0 | elastic | | [elasticsearch-query-optimization](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-query-optimization/SKILL.md) | Диагностика медленных поисковых запросов Elasticsearch Query DSL и предложение измеряемых исправлений. Используйте, когда поиск медленный, вывод профилирования показывает дорогостоящее условие, фильтры точного совпадения находятся в контексте оценки или ведущие подстановочные знаки доминируют в задержке. Обосновывайте каждую рекомендацию профилированием поиска — переносите условия, не участвующие в оценке, в контекст фильтра, устраняйте ведущие подстановочные знаки и повторно профилируйте для подтверждения улучшения. | 0.1.0 | elastic | | [elasticsearch-reindex](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-reindex/SKILL.md) | Руководство по переиндексации Elasticsearch для производительности: локальная и удалённая, нарезка (slicing), троттлинг, task API. Используйте при копировании или миграции индексов, изменении маппингов или преобразовании во время переиндексации. | 0.2.0 | elastic | | [elasticsearch-search-relevance](https://github.com/elastic/agent-skills/blob/main/skills/elasticsearch/elasticsearch-search-relevance/SKILL.md) | Повышение релевантности поиска Elasticsearch для индексов контента и каталогов: закрепление или продвижение результатов с помощью правил запросов (правильный тип правила, критерии и связывание правила с запросом) и настройка органического ранжирования с помощью multi_match, повышения веса полей и анализа, основанного на маппинге индекса. Используйте, когда результаты поиска ранжируются плохо, конкретный документ должен появляться первым по запросу или пользователь просит настроить полнотекстовое сопоставление — но не для аналитики ES\|QL, загрузки индексов или состояния кластера. | 0.1.0 | elastic | </details> <details> <summary>Kibana (7)</summary> | Навык | Описание | Версия | Автор | | ----- | ----------- | ------- | ------ | | [kibana-agent-builder](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-agent-builder/SKILL.md) | Создание и управление агентами и пользовательскими инструментами Kibana Agent Builder. Используйте, когда требуется создать, обновить, удалить, протестировать или просмотреть агентов или инструменты в Agent Builder, либо когда пользователь хочет понять, какие агенты или инструменты уже существуют. | 0.3.0 | elastic | | [kibana-alerting-rules](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-alerting-rules/SKILL.md) | Создание и управление правилами оповещений Kibana. Используйте при создании, обновлении или управлении жизненным циклом правил (включение, отключение, отключение звука, откладывание), выборе типов правил пороговых значений метрик и параметров, а также при поиске/списке только для чтения с фильтрами по тегам. | 0.3.0 | elastic | | [kibana-anomaly-detection](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-anomaly-detection/SKILL.md) | Обнаружение аномалий Elastic ML — расследование/RCA, объяснение оценки, устранение неполадок жизненного цикла заданий и операции с заданиями. Используйте при ответах на вопросы «что сломалось?»/«какая сущность?»/RCA, «почему оценка высокая/низкая?»/перенормировка, «datafeed остановился»/«лимит памяти»/hard_limit, либо при настройке заданий обнаружения аномалий ML. Читает результаты из `.ml-anomalies-*` и состояние заданий из ML REST API. | 0.3.0 | elastic | | [kibana-cases](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-cases/SKILL.md) | Управление делами расследований и инцидентов в Elastic Security, Observability и Stack Management — создание, поиск, обновление и обогащение дел комментариями, оповещениями, событиями и наблюдаемыми объектами (IOC). Используйте при отслеживании инцидентов, корреляции оповещений с делом, добавлении заметок о расследовании, обновлении статуса или серьёзности, либо управлении результатами триажа. | 0.2.0 | elastic | | [kibana-context-engine](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-context-engine/SKILL.md) | Запросы к AI-индексам Elastic Context Engine и хранимым в них Knowledge Indicators (KI). Используйте, когда требуется выполнить поиск, исследование, подсчёт или ответить на вопросы по индексу знаний AI Index / KI / Context Engine, а также при написании ES\|QL-запросов к нему. | 0.2.1 | elastic | | [kibana-dashboards](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-dashboards/SKILL.md) | Создание и управление дашбордами Kibana и визуализациями Lens. Используйте, когда нужно декларативно определять дашборды и визуализации, версионировать их, автоматизировать их развёртывание или улучшать компоновку, разделы, элементы управления или дизайн диаграмм. | 0.4.0 | elastic | | [kibana-workflows](https://github.com/elastic/agent-skills/blob/main/skills/kibana/kibana-workflows/SKILL.md) | Создание, проверка, тестирование, запуск и просмотр определений Elastic Workflow YAML. Используйте, когда пользователь хочет преобразовать естественный язык в рабочий процесс Kibana, исправить YAML рабочего процесса, понять триггеры или шаги, либо запустить быстрый цикл тестирования на реальном Kibana. | 0.5.0 | elastic | </details> <details> <summary>Observability (6)</summary> | Навык | Описание | Версия | Автор | | ----- | ----------- | ------- | ------ | | [observability-csp-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/csp-investigation/SKILL.md) | Исследование проблем с сервисами облачных провайдеров (CSP) — сегодня AWS (рассуждения применимы к любому сервису AWS; схема и сигнатуры сбоев наиболее глубоко проработаны для RDS, Lambda, SQS, ALB, EC2), а в будущем GCP и Azure — с использованием облачных метрик в схеме OTel в Elastic. Используйте при диагностике проблем облачных ресурсов, будь то по срабатыванию алерта или по запросу: давление на подключения/CPU/память базы данных, частота ошибок и троттлинг функций, накопление очереди и отставание потребителей, 5xx балансировщика нагрузки, насыщение инстансов. Соотносит исследуемый ресурс с его собственной базовой линией, классифицирует режим отказа и исключает сопутствующие, но не связанные условия. | 0.2.0 | elastic | | [observability-k8s-investigation](https://github.com/elastic/agent-skills/blob/main/skills/observability/k8s-investigation/SKILL.md) | Исследование проблем рабочих нагрузок, узлов и control-plane Kubernetes с использованием телеметрии OTel (EDOT). Используйте при диагностике сбоев подов (CrashLoopBackOff, OOMKilled, Error), давления на узлы, исчерпания ресурсов, ошибок загрузки образов, отклонений при admission, аномалий автомасштабирования или при соотнесении состояния K8s с сигналами приложений. Только путь приёма OTel — устаревшая форма интеграции ECS Kubernetes вне области рассмотрения. | 0.5.1 | elastic | | [observability-llm-obs](https://github.com/elastic/agent-skills/blob/main/skills/observability/llm-obs/SKILL.md) | Ответы на вопросы о поведении LLM и агентных приложений на основе данных, уже загруженных в Elastic: задержка и частота ошибок, использование токенов и затраты, качество ответов и события guardrail, а также оркестрация цепочек вызовов агентов. Используйте, когда пользователь спрашивает о мониторинге LLM, наблюдаемости GenAI, расходе токенов или затратах на ИИ, задержке модели, сбоях промптов или guardrail, или о том, как выполнялась цепочка вызовов инструментов агента. | 0.3.1 | elastic | | [observability-onboarding](https://github.com/elastic/agent-skills/blob/main/skills/observability/onboarding/SKILL.md) | Подключение приложения к Elastic Observability с помощью Elastic Distribution of OpenTelemetry (EDOT): маршрутизация по языку и среде выполнения, обнаружение и замена классического агента Elastic APM, применение требуемой конфигурации OTLP, а затем проверка с помощью ES\|QL, что трассировки, метрики и логи действительно поступают под ожидаемым именем сервиса. Используйте при добавлении наблюдаемости в сервис, миграции с классического агента Elastic APM или отладке того, почему инструментированный сервис не отображается в Elastic. | 0.3.0 | elastic | | [observability-service-reliability](https://github.com/elastic/agent-skills/blob/main/skills/observability/service-reliability/SKILL.md) | Проектирование и эксплуатация целевых показателей надёжности сервисов в Elastic Observability: выбор типа SLI и обоснованной цели, выбор временного окна и метода бюджетирования, создание и поддержка SLO через Kibana API, привязка правил алертов по скорости выгорания и решение о том, когда SLO — неподходящий инструмент, а правильным выбором является пороговое правило, задача аномалий или синтетический монитор. Используйте при определении или пересмотре SLO и бюджетов ошибок, настройке алертов по скорости выгорания, снижении шума алертов или настройке мониторинга доступности для пользовательской конечной точки. | 0.4.1 | elastic | | [observability-sre-triage](https://github.com/elastic/agent-skills/blob/main/skills/observability/sre-triage/SKILL.md) | Сквозная сортировка деградировавшего или подозрительного сервиса: чтение статуса SLO и скорости выгорания, проверка активных правил алертинга и аномалий ML, измерение пропускной способности, задержки и частоты ошибок, оценка здоровья зависимостей и насыщения инфраструктуры, а также сведение логов к отказам, которые это объясняют. Используйте, когда кто-то спрашивает, здоров ли сервис, почему он медленный или выдаёт ошибки, что в его логах или какой атрибут отличает запросы, которые завершаются сбоем. Также используйте, когда кто-то просит запрос, лежащий в основе любого из этих сигналов — пропускной способности, процентилей задержки, частоты ошибок, здоровья зависимостей или объёма логов — по трассировкам, метрикам или логам APM/OTel. | 0.5.2 | elastic | </details> <details> <summary>Безопасность (6)</summary> | Навык | Описание | Версия | Автор | | ----- | ----------- | ------- | ------ | | [security-alert-analysis](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-analysis/SKILL.md) | Расследование конкретного оповещения обнаружения Elastic Security: сбор контекста, оценка риска сущности, классификация угрозы, документирование результатов и, при необходимости, подтверждение. Используйте при триаже отдельного известного оповещения, проведении расследования SOC или при последующих действиях после того, как навык security-alert-triage определил группу для расследования. | 0.1.0 | elastic | | [security-alert-triage](https://github.com/elastic/agent-skills/blob/main/skills/security/alert-triage/SKILL.md) | Приоритизация и ранжирование очереди оповещений Elastic Security по взвешенному риску — базовой оценке риска, усилению по тактике MITRE, риску сущности и критичности актива — с последующей кластеризацией оповещений в группы сущностей. Используйте, когда аналитик спрашивает, на что обратить внимание, какие оповещения наиболее срочные, или хочет получить ранжированную отправную точку по всей очереди перед началом более глубокого расследования. | 0.2.0 | elastic | | [security-case-management](https://github.com/elastic/agent-skills/blob/main/skills/security/case-management/SKILL.md) | Создание, поиск, обновление и управление кейсами SOC через Kibana Cases API. Используйте при отслеживании инцидентов, связывании оповещений с кейсами, добавлении заметок о расследовании или управлении результатами триажа. | 0.1.0 | elastic | | [security-detection-rule-management](https://github.com/elastic/agent-skills/blob/main/skills/security/detection-rule-management/SKILL.md) | Создание, настройка и управление правилами обнаружения Elastic Security (SIEM и Endpoint). Используйте для работы с ложными срабатываниями, исключениями, новым покрытием, шумными правилами или управлением правилами через Kibana API. | 0.1.0 | elastic | | [security-generate-security-sample-data](https://github.com/elastic/agent-skills/blob/main/skills/security/generate-security-sample-data/SKILL.md) | Генерация образцов событий безопасности, сценариев атак и синтетических оповещений для Elastic Security. Используйте при демонстрации, наполнении дашбордов, тестировании правил обнаружения или настройке POC. | 0.1.0 | elastic | | [security-ml-integrations](https://github.com/elastic/agent-skills/blob/main/skills/security/ml-integrations/SKILL.md) | Установка и управление пакетами интеграций ML безопасности Elastic (beaconing, ded, dga, lmd, pad, problemchild). Охватывает полный жизненный цикл: предварительные проверки, установку пакета Fleet, шаблоны компонентов, конвейеры приёма данных, трансформации, представления данных, задания обнаружения аномалий ML и правила обнаружения. Используйте, когда пользователь просит установить, настроить, проверить состояние или устранить неполадки пакета интеграции ML безопасности. | 0.1.0 | elastic | </details> <!-- END-SKILL-TABLE --> ## Вопросы безопасности AI-агенты для программирования работают с реальными учётными данными, реальным доступом к оболочке и зачастую с полными правами пользователя, запускающего их. Когда такие агенты направляются на рабочие процессы безопасности, ставки возрастают. Это требует откровенного разговора о рисках, прежде чем вы начнёте. - **Проведите собственное моделирование угроз.** Оцените, к каким данным агент имеет доступ, какие действия он может выполнять и что произойдёт, если он поведёт себя неожиданным образом. [Совместное руководство CISA по безопасному развёртыванию ИИ-систем](https://www.cisa.gov/news-events/alerts/2024/04/15/joint-guidance-deploying-ai-systems-securely) — хорошая отправная точка. --- [Read more](https://github.com/elastic/agent-skills)