TencentCloud/tencentcloud-agentobs-sdk-dsh ↗★ 3
tencentcloud-agentobs-sdk-dsh
Tencent Cloud Service CLS observability plugin for DeepSeek Harness — direct upload to Tencent Cloud CLS
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:TencentCloud/tencentcloud-agentobs-sdk-dsh说明文档
阅读完整 README ↗配置
环境变量(推荐)
export CLS_ENDPOINT=ap-guangzhou.cls.tencentcs.com
export CLS_TOPIC_ID=your-topic-id
export CLS_SECRET_ID=your-secret-id
export CLS_SECRET_KEY=your-secret-key
export CLS_SERVICE_NAME=dsh-agent
dsh --profile web
插件配置文件
编辑 $DSH_HOME/profiles/ /cordis.patch.yml:
- id: cls-observability
config:
endpoint: ap-guangzhou.cls.tencentcs.com
topicId: your-topic-id
secretId: your-secret-id
secretKey: your-secret-key
serviceName: dsh-agent
captureContent: true
batchMaxSize: 32
flushIntervalMs: 5000
debug: false
显式插件配置优先于环境变量。
关闭内容捕获
默认情况下,prompts、responses、tool arguments/results 会附加到 span。如需关闭:
export OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false
dsh --profile web
或在插件配置中设置 captureContent: false。
插件配置文件
编辑 $DSH_HOME/profiles/ /cordis.patch.yml:
- id: cls-observability
config:
endpoint: ap-guangzhou.cls.tencentcs.com
topicId: your-topic-id
secretId: your-secret-id
secretKey: your-secret-key
serviceName: dsh-agent
captureContent: true
batchMaxSize: 32
flushIntervalMs: 5000
debug: false
显式插件配置优先于环境变量。
配置项
| 设置 | 默认值 | 说明 |
|---|---|---|
enabled | true | 禁用采集但不卸载插件 |
endpoint | CLS_ENDPOINT | CLS API 接入点 |
topicId | CLS_TOPIC_ID | CLS 日志主题 ID |
secretId | CLS_SECRET_ID | 腾讯云 SecretId |
secretKey | CLS_SECRET_KEY | 腾讯云 SecretKey |
serviceName | deepseek-harness | 服务名 |
captureContent | true | 捕获 prompts/responses/tool 内容(设为 false 关闭) |
contentMaxChars | 128000 | 单个内容属性最大字符数 |
batchMaxSize | 32 | 每批上报最大 span 数 |
maxQueueSize | 2048 | 队列上限,超限丢弃最旧 span |
flushIntervalMs | 5000 | 定时刷新间隔(毫秒) |
retryTimes | 3 | 上报重试次数 |
debug | false | 启用调试日志 |