kibana-agent-builder

Навык kibana-agent-builder предназначен для управления агентами и пользовательскими инструментами в Kibana Agent Builder. Официальная карточка описывает полный рабочий цикл: создание, обновление, удаление, получение, перечисление и тестирование агентов, а также работу с custom tools. Скилл полезен, когда нужно не только проверить существующую конфигурацию, но и вести её через последовательные операции API и командной строки. Для начала требуется адрес Kibana в переменной KIBANA_URL. Для доступа можно использовать KIBANA_API_KEY либо пару KIBANA_USERNAME и KIBANA_PASSWORD; дополнительно поддерживаются ELASTICSEARCH_USERNAME и ELASTICSEARCH_PASSWORD как резервные переменные для имени и пароля. KIBANA_SPACE_ID позволяет выбрать пространство, а KIBANA_INSECURE — явно отключить проверку TLS, если это нужно в конкретной среде. Рекомендуемый сценарий начинается с получения списка доступных инструментов командой list-tools. Это помогает отличить встроенные инструменты с префиксом platform.core. от custom- и connector-инструментов до создания агента. Затем list-agents показывает уже существующих агентов и снижает риск конфликта имён. При создании можно передать имя, краткое описание, системные инструкции и список идентификаторов инструментов. После операции нужно снова получить список агентов и убедиться, что новая запись действительно появилась. Для существующего агента предусмотрено получение по id, а обновление меняет описание, инструкции и набор инструментов; имя и идентификатор при этом не считаются изменяемыми полями. Удаление необратимо, поэтому официальный workflow требует отдельного подтверждения перед delete-agent. Навык охватывает три типа custom tools. ES|QL-инструмент содержит параметризованный запрос, описание параметров и типы string, integer, float, boolean, date или array. Для ES|QL поле params обязательно даже тогда, когда параметров нет, а каждый параметр может иметь только type и description. Index search ограничивает встроенный поиск шаблоном индекса через поле pattern. Workflow-инструмент связывает агента с заранее определённым Elastic Workflow через workflow_id; такой тип предназначен для последовательностей, которые выходят за рамки простого чтения данных и вызывают внешние действия. Важная часть навыка — проверка ограничений API до записи. В POST разрешены только id, type, description, configuration и tags; поле name добавлять нельзя. Для ES|QL нельзя подменять params полями default или optional, а для index search используется pattern, не index. В PUT обновляются только description, configuration и tags, тогда как id и type остаются неизменяемыми. Практически это означает, что карточка подходит для безопасного управления Agent Builder при уже настроенном доступе к Kibana, но не заменяет выдачу API-ключа, настройку самой Kibana или проверку прав пользователя. Для запуска опубликованного скилла также требуется сетевой доступ и окружение с разрешёнными командами node, Bash, Read, Glob и Grep; сами инструкции не обещают работу без этих предусловий.