Zhihu AIOps Skill

This skill provides workflows and API references for the 智护运维平台 / Zhihu AIOps platform.

Use it for:

• Querying platform assets, asset models, asset types, and managed devices.
• Creating operating-system monitoring assets after connectivity checks.
• Querying dashboard and alarm summaries.
• Working with CMDB / asset discovery scan tasks and scan results.
• Querying VictoriaMetrics and Categraf SNMP snmp_* metrics.
• Generating managed asset inspection reports.

Configuration

Set these environment variables before calling platform APIs:

export ZHIHU_API_URL="http://zhihu-server:48080/admin-api"
export ZHIHU_USER="admin"
export ZHIHU_PASSWORD="your-password"
export VM_URL="http://zhihu-metric:9090"

Do not hard-code customer IPs, test-environment URLs, usernames, passwords, or API keys into prompts or generated scripts. Prefer environment variables.

Core Workflow

1. Read the relevant reference file from references/ based on the user's goal.
2. Login to the Zhihu platform before calling protected platform APIs.
3. Send Authorization: Bearer with platform requests unless the target environment expects the raw token format.
4. For managed assets, query asset models first when the model ID is unknown, then call /cqt/asset-info/page with the correct modelId and modelCode.
5. For SNMP/network/security/storage device metrics, use VictoriaMetrics snmp_* metrics collected by Categraf, not Zabbix.
6. For inspection reports, combine platform managed asset data with VictoriaMetrics/SNMP data only when realtime metric status is requested.

Reference Map

• Asset center APIs: references/api_asset.md
• CMDB discovery APIs: references/api_cmdb.md
• Dashboard and alarm summary APIs: references/api_dashboard.md
• Monitor center APIs: references/api_monitor.md
• VictoriaMetrics APIs: references/api_victoriametrics.md
• Categraf SNMP metrics: references/api_snmp_metrics.md
• Add OS monitoring workflow: references/add-os-monitor.md
• Managed asset inspection workflow: references/inspection-run.md

Common Tasks

Query Managed Assets

Read references/api_asset.md. If the user asks for concrete assets rather than model definitions, use /cqt/asset-info/page. For known managed inspection models, use the model information in references/inspection-run.md.

Generate Managed Asset Inspection Report

Read references/inspection-run.md, then query these categories as needed:

• Security device: modelId=254, modelCode=securitydevice
• Network device: modelId=185, modelCode=networkdevice
• Terminal device: modelId=260, modelCode=terminaldevice
• Storage device: modelId=261, modelCode=storagedevice
• Database: modelId=183, modelCode=storagebase
• Operating system: modelId=195, modelCode=operatesystem

Query SNMP Metrics

Read references/api_snmp_metrics.md. Use VM_URL and VictoriaMetrics APIs:

• /api/v1/series for metric discovery.
• /api/v1/query for instant queries.
• /api/v1/query_range for trends.

Prefer snmp_* metrics for network devices, security devices, storage devices, switches, routers, firewalls, and other SNMP-managed assets.

Add OS Monitoring

Read references/add-os-monitor.md. Required user inputs are target IP, port, username, password, and monitor name. Login first, resolve the operating-system model/items dynamically, test connectivity, then create the asset.

Current Limitations

This first ClawHub package is documentation-first and registration-ready. It does not yet include a production CLI wrapper. When deterministic execution is required, implement scripts in scripts/ in the next phase, for example:

python3 scripts/zhihu_cli.py login
python3 scripts/zhihu_cli.py asset-page --model-code networkdevice
python3 scripts/zhihu_cli.py inspect-managed-assets --scope all
python3 scripts/zhihu_cli.py snmp-discover
python3 scripts/zhihu_cli.py vm-query --query 'up'