TencentCloud 製の Apache-2.0 DSH プラグイン。GenAI トレースを Tencent Cloud CLS へ直接送り、entry/agent/step/chat/tool の 5 層 span モデル、コレクタ不要の Protobuf 送信、調整可能なバッチとリトライ、内容キャプチャの切り替えを提供します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-21
ライセンス
Apache-2.0
01どんなタスクに使えるのか?
コレクタを立てずに DSH の GenAI トレースを Tencent Cloud CLS へ届ける
1 回の DSH ターンが ENTRY → AGENT(invoke_agent)→ STEP(react round_N)→ CHAT / TOOL の span になり、プラグインのプロセスから Protobuf で直接アップロードされます
すでに Tencent Cloud CLS でログを集めており、エージェントのトレースも同じ場所に置きたいが OTLP パイプラインは増やしたくないチーム
マシン外に出る内容と量を制御する
`captureContent`(または標準の `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`)でプロンプト・応答・ツール内容の取り込みを止めつつ span 構造は保持でき、`enabled: false` ならアンインストールせず収集だけ停止できます
遅延やエラー分析のためにトレースは欲しいが、ソースコードや資格情報をログサービスへ送れない運用者
02DeepSeek Harness への導入方法
前提条件
- DeepSeek Harness `>=0.1.0-rc.6 <0.2.0`(README の互換性表は上限を 0.2.0 未満としています)
- Node.js 18.0.0 以降
- CLS のエンドポイントとトピック ID、および SecretId/SecretKey か数値の UIN のいずれか
インストール手順
- 01
DSH CLI が未導入ならグローバルにインストールします: `npm install -g @deepseek-ai/dsh`。
$ npm install -g @deepseek-ai/dsh
- 02
使用するプロファイルへ導入します: `dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh`(`headless` / `harness` も同様)。
$ dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh
- 03
pnpm v9+ が protobufjs の install スクリプトを止める場合(`ERR_PNPM_IGNORED_BUILDS`)、該当プロファイルのディレクトリ(例 `~/.dsh/profiles/web`)で `echo "enable-scripts=true" >> .npmrc` と `pnpm install` を 1 回実行します。
- 04
DSH サービスを再起動します。README はインストールや更新が再起動後にのみ有効になると明記しています。
- 05
環境変数(`CLS_ENDPOINT`、`CLS_TOPIC_ID`、`CLS_SECRET_ID`/`CLS_SECRET_KEY` または `CLS_UIN`、`CLS_SERVICE_NAME`)か `$DSH_HOME/profiles/<profile>/cordis.patch.yml` で設定します。明示的なプラグイン設定が環境変数より優先されます。
導入成功の確認
作者は未記載
ロールバック
- `dsh plugin --profile web remove tencentcloud-agentobs-sdk-dsh`。`headless` / `harness` にも入れた場合はそれぞれ実行します。
03DSH 統合と能力の範囲
DSH ネイティブの可観測性プラグイン。DSH の session・agent loop・LLM stream・tool のライフサイクルにフックし、`tencentcloud-cls-sdk-js` で Tencent Cloud CLS へ直接送信します(OTLP コレクタも sidecar も不要)
5 層 GenAI span モデル
DSH の session イベント、agent loop のラウンド、LLM stream、tool 呼び出し→Tencent Cloud の AI エージェント可観測仕様に沿った ENTRY / AGENT(invoke_agent)/ STEP(react round_N)/ CHAT(chat model_name)/ TOOL(execute_tool tool_name)span
span はプラグイン自身が `tencentcloud-cls-sdk-js` で Protobuf 送信するため、コレクタや sidecar の配備は不要ですバッチ・キュー・リトライ制御
`batchMaxSize`(32)、`flushIntervalMs`(5000)、`maxQueueSize`(2048)、`retryTimes`(3)、`debug`→上限付きのバッチを一定間隔でフラッシュし、送信失敗はリトライ
キューが満杯になると agent を止めるのではなく最も古い span を破棄します内容キャプチャと切り詰め
`captureContent`(既定 true)、`contentMaxChars`(128000)、または環境変数 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`→プロンプト・応答・ツール引数と結果を span に付与(属性ごとに切り詰め)、あるいはまったく収集しない
`cordis.patch.yml` の明示的なプラグイン設定が環境変数より優先されます
04誰に向いているのか?使うべきでない場面は?
向いている用途
- すでに Tencent Cloud CLS でログを集めており、エージェントのトレースも同じ場所に置きたいが OTLP パイプラインは増やしたくないチーム
- 遅延やエラー分析のためにトレースは欲しいが、ソースコードや資格情報をログサービスへ送れない運用者
不向きな用途
- ドキュメント上の DSH 範囲は `>=0.1.0-rc.6 <0.2.0`、Node.js は `>=18.0.0` です。0.2.x のホストへの導入はサポート対象外です。
- 内容キャプチャは既定で有効なため、ソースコード・資格情報・個人データが CLS へ送られる可能性があります。`captureContent: false` か `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false` で無効化し、CLS の保持期間とアクセス制御が方針に合うことを確認してください。
- `maxBatchBytes` は SDK の 19MB ハードリミット未満でないとバッチ全体がローカルで拒否され、`maxQueueSize` が満杯になると最も古い span が破棄されます。
05互換性・メンテナンス・セキュリティ上の注意
- ドキュメント上の DSH 範囲は `>=0.1.0-rc.6 <0.2.0`、Node.js は `>=18.0.0` です。0.2.x のホストへの導入はサポート対象外です。
- 内容キャプチャは既定で有効なため、ソースコード・資格情報・個人データが CLS へ送られる可能性があります。`captureContent: false` か `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false` で無効化し、CLS の保持期間とアクセス制御が方針に合うことを確認してください。
- `maxBatchBytes` は SDK の 19MB ハードリミット未満でないとバッチ全体がローカルで拒否され、`maxQueueSize` が満杯になると最も古い span が破棄されます。
Apache-2.0 · TencentCloud による公開(最新リリース v0.0.1、2026-08-18。最終 push 2026-08-26)
06よくある質問
OTLP コレクタは必要ですか?
不要です。プラグインが `tencentcloud-cls-sdk-js` を直接呼び、Protobuf バッチを送信するため、コレクタも sidecar も配備しません。必要なのはエンドポイントとトピック ID だけです。
どの DSH バージョンに対応しますか?
README の互換性表では DeepSeek Harness が `>=0.1.0-rc.6 <0.2.0`、Node.js が `>=18.0.0` です。
プロンプトやコードは CLS に送られますか?
既定では送られます。`captureContent` が `true` で、プロンプト・応答・ツール引数と結果が span に付与されます。`captureContent: false` か `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false` にすると、span 構造だけを保ち内容は送りません。
ERR_PNPM_IGNORED_BUILDS で失敗しました。
pnpm v9+ は依存パッケージの install スクリプトを既定で止めます。該当プロファイルのディレクトリ(例 `~/.dsh/profiles/web`)で `.npmrc` に `enable-scripts=true` を追記し、`pnpm install` を 1 回実行してください。以降の導入・更新では不要です。
削除するには?
`dsh plugin --profile web remove tencentcloud-agentobs-sdk-dsh` を実行し、`headless` と `harness` にも入れていれば同様に実行します。その後 DSH を再起動すると反映されます。
07関連する DSH ワークフロー
dsh-univer-office
by dream-num
DSH 内で Office 文書をプレビュー・作成・編集(Univer 搭載)
clearai-dsh
by clearailhc
DeepSeek HarnessにEpistemic Loopを導入するネイティブDSHプラグイン。
dsh-fish-memory
by yuuyuko-uu
DSHのセッションに、時間情報付きの少しずつ薄れる長期記憶を与えます。
dsh-trading
by zhu1090093659
DeepSeek Harness上に構築したエージェント型トレーディングターミナル。仮想通貨・米国・中国・香港市場を3列GUIで一括表示、19以上の着脱式コネクタ、デフォルトでドライラン(本番注文は人間承認)対応。BYOKでデータ外部送信なし。
08データと出典
`tencentcloud-agentobs-sdk-dsh` 是一个 DeepSeek Harness (DSH) 可观测插件,直接将 GenAI trace 数据上报到腾讯云日志服务 (CLS)。
它观察 DSH 原生的 session、agent loop、LLM stream 和 tool 生命周期,将其转换为腾讯云AI Agent可观测规范的 5 层 span 层级模型(entry → agent → step → chat →…
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-21。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
