netxops/docs/TOOL_MAP.md
oliver 3a731389f0 Add KB local write tools and align Netx Ops with standard preset.
Host-side netx__kb* tools jail create/update/delete under paths.local memories/drafts/suggestions; Netx Ops agent.cordis.yml now includes full standard capability rows plus ops tools.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-15 21:43:41 +08:00

2.1 KiB

Netx Ops tool map

Tools register by capability group. One group ↔ one skill.

Group Skill Default in Ops preset
ops netx-ops on
topology netx-topology off

Public flags mount the same group on the host for other presets. Forced mounts: dsh-netxops/tools-ops | tools-topology (legacy aliases: tools-nms / tools-common → ops).

Model names: netx__<stem>. NMS tools use Nms; adapter nmsProvider=zte-ume still hits /v1/ume/*.

ops → netx-ops

Tool Role
queryNmsAlarms … sqlQueryNms Alarm + inventory + SQL
listManagedNe / getManagedNe / execManagedNe / listCliTargets Managed CLI (login / show)
findTopologyPaths Fabric path lookup

topology → netx-topology

Tool Role
Tree / view / folders / membership / neighbors Canvas CRUD
Fabric query / classify / edges Inventory + adjacency
layoutTopologyView move_nodes / catalog / …
suggestSinkHubs / analyzeTopologyViewLayout / sinkTopologyDualUnits Dual-unit / QA (may stub → MCP layout engine)

Canonical skill bodies: sibling netx/skills/. DSH loads them at runtime (NETX_SKILLS_ROOT or ../netx/skills) or from presets/netxops/skills after sync.

Execution: HTTP apiUrl + Bearer NETX_API_TOKEN.

knowledge base → groupKb* (not ops/topology)

Registered when KB is configured, MANIFEST has paths.local, and the KB in-preset / public toggle is on. Host-side FS writes (bypass workspace sandbox). Jail: {kbLocal}/memories|drafts|suggestions only — not identity/.

Tool Role
kbWriteMemory New diary entry under memories/{日常笔记|排障复盘|AI思维链}/ (overwrite optional)
kbWriteDraft New DRAFT-… under drafts/ (+ status: draft)
kbWriteSuggestion New file under suggestions/{theory|improvement}/
kbUpdateLocal Replace body of an existing jailed file
kbDeleteLocal Delete one jailed file
kbListLocal List recent .md under writable trees