cli-anything-hiagent
Command-line interface for HiAgent Python SDK - Observe service (API Token, Trace Spans) via CLI
来源信息
- 仓库
- volcengine/hiagent-python-sdk
- 最近来源活动
- 2026年5月29日 03:26
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 29
- 分支
- 10
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- cli-anything-hiagent
- description
- Command-line interface for HiAgent Python SDK - Observe service (API Token, Trace Spans) via CLI
# 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*
在 GitHub 查看