cli-anything-hiagent

# cli-anything-hiagent Command-line interface for the HiAgent Python SDK built by Hiagent. This CLI provides programmatic access to HiAgent's Observe service, including API Token management and Trace/Span observability. ## Installation ```bash pip install cli-anything-hiagent ``` ## Installation from source ```bash uv pip install -e agent-harness ``` **Prerequisites:** - HiAgent Python SDK (`hiagent-api`, `hiagent-components`) - Volcano Engine credentials (request signing) - `VOLC_ACCESSKEY` / `VOLC_SECRETKEY` environment variables, or - `~/.volc/.env` ## Configuration Set up credentials using environment variables: ```bash export VOLC_ACCESSKEY="..." export VOLC_SECRETKEY="..." export HIAGENT_TOP_ENDPOINT="https://open.volcengineapi.com" ``` ## Observe Commands Observe service for API Token management and Trace/Span observability: ```bash # Create API Token cli-anything-hiagent observe token create \ --workspace-id ws-123 \ --custom-app-id app-456 # List trace spans cli-anything-hiagent observe trace list \ --workspace-id ws-123 \ --page-size 10 \ --sort-by StartTime \ --sort-order Desc # List trace spans with pagination cli-anything-hiagent observe trace list \ --workspace-id ws-123 \ --page-size 20 \ --last-id last-doc-id \ --sort-by Latency \ --sort-order Asc ``` ### Observe Command Options **token create:** - `--workspace-id` (required): Workspace ID - `--custom-app-id` (required): Custom App ID **trace list:** - `--workspace-id` (required): Workspace ID - `--page-size`: Page size (default: 10) - `--last-id`: Last ID for pagination - `--sort-by`: Sort field (StartTime, Latency, LatencyFirstResp, TotalTokens) - `--sort-order`: Sort order (Asc, Desc) ## JSON Output Mode Use `--json` flag for machine-readable output (essential for AI agents): ```bash cli-anything-hiagent --json observe trace list --workspace-id ws-123 ``` JSON output format: ```json { "success": true, "message": "Operation completed", "data": { ... } } ``` ## Return Codes - `0` - Success - `1` - Error (with error message in `message` field of JSON output) ## Error Handling All commands output errors in both human-readable and JSON formats: ```bash # JSON error $ cli-anything-hiagent --json observe trace list --workspace-id invalid-ws { "success": false, "message": "...", "data": null } ``` ## System Requirements - Python >= 3.10 - HiAgent API access with valid Volcano Engine credentials - Network access to HiAgent endpoints ## License Apache-2.0 --- *Generated by Hiagent*