From f367779ad1aef7efb9f4cd94c80a6de910d5b45d Mon Sep 17 00:00:00 2001 From: oliver Date: Mon, 11 May 2026 17:27:26 +0800 Subject: [PATCH] Docs: UME NE keyword matches host_name (netx-side) Align ops playbook and netx_query_ume_ne_inventory description with netx API. Co-authored-by: Cursor --- runtime/tools/experts/network_ops/netx_tools.py | 4 ++-- skills/_workspace/ops/ops-netx-ume-playbook/SKILL.md | 2 +- skills/_workspace/ops/ops-netx-ume-playbook/reference.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/runtime/tools/experts/network_ops/netx_tools.py b/runtime/tools/experts/network_ops/netx_tools.py index 96eb41f4..960791ab 100644 --- a/runtime/tools/experts/network_ops/netx_tools.py +++ b/runtime/tools/experts/network_ops/netx_tools.py @@ -628,8 +628,8 @@ def netx_query_ume_ne_inventory_tool() -> ToolSpec: name="netx_query_ume_ne_inventory", description=( "查询 netx 已同步的 UME 网元清单（读 /v1/ume/inventory/ne，与 netx Web「网元清单」同源）。" - "keyword 可选：匹配 ne_id / ne_name / user_label / ip_address 包含。" - "返回 total、page、page_size、items（含在线状态、地址、类型等）。" + "keyword 可选：匹配 ne_id / ne_name / user_label / ip_address / host_name（主机名）包含。" + "返回 total、page、page_size、items（含 host_name、在线状态、地址、类型等）。" ), parameters={ "type": "object", diff --git a/skills/_workspace/ops/ops-netx-ume-playbook/SKILL.md b/skills/_workspace/ops/ops-netx-ume-playbook/SKILL.md index a9f03878..97f3d383 100644 --- a/skills/_workspace/ops/ops-netx-ume-playbook/SKILL.md +++ b/skills/_workspace/ops/ops-netx-ume-playbook/SKILL.md @@ -39,7 +39,7 @@ description: 面向 ops 专家的 netx UME 运维作业手册。覆盖告警查 - **需要复杂条件 / 自定义计算 / 多条件关联**： - `netx_sql_query_ume`（必须过滤 + `statement_timeout_ms`） - **查网元是谁、IP/标签、在线状态、或核对告警里的 ne_id**： - - 先 `netx_query_ume_ne_inventory`（`keyword` 可填名称片段或 UUID 片段） + - 先 `netx_query_ume_ne_inventory`（`keyword` 可填名称、主机名、标签、IP 或 UUID 片段） - 需要完整字段与 `raw_json` 时再 `netx_get_ume_ne` ## 约束与护栏 diff --git a/skills/_workspace/ops/ops-netx-ume-playbook/reference.md b/skills/_workspace/ops/ops-netx-ume-playbook/reference.md index 0ad040f6..9f7a4438 100644 --- a/skills/_workspace/ops/ops-netx-ume-playbook/reference.md +++ b/skills/_workspace/ops/ops-netx-ume-playbook/reference.md @@ -46,7 +46,7 @@ ## 4b) 网元清单与详情 - 工具：`netx_query_ume_ne_inventory` — 对应 netx `GET /v1/ume/inventory/ne` - - 参数：`keyword`（可选，匹配 ne_id/ne_name/user_label/ip）、`page`、`page_size`（最大 500） + - 参数：`keyword`（可选，匹配 ne_id/ne_name/user_label/ip_address/**host_name**）、`page`、`page_size`（最大 500） - 工具：`netx_get_ume_ne` — `GET /v1/ume/inventory/ne/{ne_id}` - 参数：`ne_id`（UUID，与清单字段一致） - 与告警 raw 中的 `ne_*` 字段互补：需要 UME 原始 JSON 时用 `netx_get_ume_ne` 的 `raw_json`。