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 の言語
- 英語
- スター
- 30
- フォーク
- 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で見る