用途：在 Kibana 的 Agent Builder 中管理智能体（Agent）与自定义工具（Tool），支持创建、更新、删除、查看以及发起对话，适合需要在 Kibana 内构建数据查询与自动化代理的场景。
前置条件：脚本运行前需设置环境变量 KIBANA_URL（必填），以及 KIBANA_API_KEY 或 KIBANA_USERNAME+KIBANA_PASSWORD 之一用于认证；可选 KIBANA_SPACE_ID、KIBANA_INSECURE。
主要能力：通过 node skills/kibana/agent-builder/scripts/agent-builder.js 提供 list-tools、list-agents、create-agent、get-agent、update-agent、delete-agent、chat、list-custom-tools、get-tool、create-tool、update-tool、delete-tool、test-tool 等命令。创建智能体需先列出可用工具（platform.core. 前缀为内置工具），再收集名称、描述、系统指令与工具 ID；自定义工具分三类：ES|QL（参数化查询，参数用 ?name，类型限 string、integer、float、boolean、date、array）、索引搜索（用 pattern 指定索引范围）和工作流（关联 Elastic Workflow 的 workflow_id）。chat 命令调用流式接口，输出 [Reasoning]、[Tool Call]、[Tool Result]、[Response] 事件，可能耗时 30-60 秒。
限制与约束：POST 创建工具仅接受 id、type、description、configuration、tags，name 无效；ES|QL 工具必须带 params（无参数时写 params: {}）；参数仅支持 type 和 description，default、optional 会报 400；索引搜索配置用 pattern 而非 index；更新只接受 description、configuration、tags，id 与 type 不可变；智能体更新同理，含 id、name 或 type 会导致 400。删除操作不可恢复，执行前需确认；ES|QL 查询应加 | LIMIT N 防止上下文溢出；智能体 ID 由名称自动生成。
参考文档包括 references/architecture-guide.md 与 references/use-cases.md，ES|QL 语法可参考 elasticsearch-esql 技能，工作流 YAML 可参考 security-workflows 技能。