mirror of
https://github.com/hansjone/netxops.git
synced 2026-10-09 22:03:16 +08:00
oliver
3a731389f0
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>
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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 |
|