Metadata-Version: 2.4
Name: tencentcloud-cls-sdk-hermes
Version: 1.0.34
Summary: Tencent Cloud CLS observability plugin for Hermes
Author: Tencent Cloud
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: tencentcloud-cls-sdk-python<2,>=1.0.8

# tencentcloud-cls-sdk-hermes

腾讯云 CLS 可观测插件 for Hermes Agent。

自动上报 Trace、Audit、Gateway 事件到腾讯云日志服务（CLS），无需修改 Hermes 核心代码。

## 功能

- Trace：会话 / 对话轮次 / LLM 调用 / 工具调用
- Audit：LLM 输出 / 工具结果 / 终端命令 / 审批
- Gateway：网关入口消息
- Token 用量（含 cache 命中）与 TTFT
- 值级脱敏（自动隐藏内联密钥）

## 安装

```bash
curl -fsSL https://tencentcloud-cls-sdk-hermes-1254139626.cos.ap-guangzhou.myqcloud.com/tencentcloud-cls-sdk-hermes-install.sh | bash -s -- install \
  --endpoint "<your-cls-endpoint>" \
  --topic-id "<your-topic-id>" \
  --secret-id "<your-secret-id>" \
  --secret-key "<your-secret-key>"
```

## 卸载

```bash
curl -fsSL https://tencentcloud-cls-sdk-hermes-1254139626.cos.ap-guangzhou.myqcloud.com/tencentcloud-cls-sdk-hermes-install.sh | bash -s -- uninstall
```

## 环境变量

| 变量 | 必填 | 说明 |
|------|------|------|
| `HERMES_CLS_ENDPOINT` | ✅ | CLS 接入点 |
| `HERMES_CLS_TOPIC_ID` | ✅ | 日志主题 ID |
| `HERMES_CLS_SECRET_ID` | ✅ | 腾讯云 SecretId |
| `HERMES_CLS_SECRET_KEY` | ✅ | 腾讯云 SecretKey |
| `HERMES_CLS_SERVICE_NAME` | | 服务名（默认 hermes-agent） |
| `HERMES_CLS_ENV` | | 环境标签（默认 prod） |

## License

MIT
