技能介绍

解决什么问题

当你想把对话式 Agent 接到 Elasticsearch 时，常见痛点不是“不会写 REST 请求”，而是凭据放哪里、schema 怎么确认、哪些动作会改数据、执行失败时到底缺登录、缺连接还是缺额度。这个技能把这些问题收敛到 oo CLI 与 OOMOL 连接器后面：你只需要声明要做什么，凭据由服务端注入，本地流程不必拿原始 token。

技能如何工作

核心是 4 个动作：list_indices 列出可见索引；get_index_schema 获取单个索引的 mappings、settings、aliases 和字段统计；ping_cluster 检查集群可达性与健康状态；query_index 用文本查询、过滤、分页和排序搜索索引。

执行前先读取参考文件确认用途，再用 oo connector schema 拿实时输入/输出 schema，不要凭印象构造 payload。运行动作时传入匹配 schema 的 JSON payload；--data 可以接收 JSON 字符串或 @path/to/file.json，省略时发送 {}。响应结构是 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 在 meta.executionId。

安全边界与注意点

读取类动作（get / list / search）可以直接运行；创建、更新、发送或 post 类动作会改变 Elasticsearch 状态，必须先和用户确认确切 payload 与影响；删除或 remove 类动作是破坏性操作，必须确认目标并拿到明确批准。

首次配置只应在命令真正因认证或连接错误失败时处理：缺少 oo 命令时安装 CLI；未登录时登录一次 OOMOL；出现 scope 缺失、凭据过期、app 未就绪或未找到时，检查 Elasticsearch 是否已连接、是否过期或缺 scope，并以 API key / custom credential 重新连接；遇到 HTTP 402 / OOMOL_INSUFFICIENT_CREDIT，先充值再重试。不要主动运行 oo auth login 或打开连接 URL，也不要每次调用都重复这些一次性步骤。