tencentcloud-cls-sdk-hermes 1.0.34

Tencent Cloud CLS observability plugin for Hermes

tencentcloud-cls-sdk-hermes

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

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

功能

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

安装

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>"

卸载

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