TencentCloud/tencentcloud-agentobs-sdk-dsh3

tencentcloud-agentobs-sdk-dsh

Tencent Cloud Service CLS observability plugin for DeepSeek Harness — direct upload to Tencent Cloud CLS

包名
tencentcloud-agentobs-sdk-dsh
版本
0.0.1
许可证
Apache-2.0
最近更新
2026年8月18日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:TencentCloud/tencentcloud-agentobs-sdk-dsh

配置

环境变量(推荐)

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

显式插件配置优先于环境变量。

配置项

设置默认值说明
enabledtrue禁用采集但不卸载插件
endpointCLS_ENDPOINTCLS API 接入点
topicIdCLS_TOPIC_IDCLS 日志主题 ID
secretIdCLS_SECRET_ID腾讯云 SecretId
secretKeyCLS_SECRET_KEY腾讯云 SecretKey
serviceNamedeepseek-harness服务名
captureContenttrue捕获 prompts/responses/tool 内容(设为 false 关闭)
contentMaxChars128000单个内容属性最大字符数
batchMaxSize32每批上报最大 span 数
maxQueueSize2048队列上限,超限丢弃最旧 span
flushIntervalMs5000定时刷新间隔(毫秒)
retryTimes3上报重试次数
debugfalse启用调试日志