ディレクトリに戻る

tencentcloud-agentobs-sdk-dsh

キュレーションリスト掲載メンテナンス: 活発

tencentcloud/tencentcloud-agentobs-sdk-dsh

DSH 可観測プラグイン:GenAI trace を腾讯云 CLS に上报

GitHub で見るホームページ
$ npm install -g @deepseek-ai/dsh

15

スター

3

フォーク

TypeScript

言語

Apache-2.0

ライセンス

2026-08-18

作成日

2026-08-26

最終プッシュ

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 のいずれか

インストール手順

  1. 01

    DSH CLI が未導入ならグローバルにインストールします: `npm install -g @deepseek-ai/dsh`。

    $ npm install -g @deepseek-ai/dsh

  2. 02

    使用するプロファイルへ導入します: `dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh`(`headless` / `harness` も同様)。

    $ dsh plugin --profile web add tencentcloud-agentobs-sdk-dsh

  3. 03

    pnpm v9+ が protobufjs の install スクリプトを止める場合(`ERR_PNPM_IGNORED_BUILDS`)、該当プロファイルのディレクトリ(例 `~/.dsh/profiles/web`)で `echo "enable-scripts=true" >> .npmrc` と `pnpm install` を 1 回実行します。

  4. 04

    DSH サービスを再起動します。README はインストールや更新が再起動後にのみ有効になると明記しています。

  5. 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 ネイティブの可観測性プラグイン。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 が破棄されます。
2026-08-182026-08-26v0.0.1

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 を再起動すると反映されます。

08データと出典

  • 作者による申告github.come46575d24323…

    `tencentcloud-agentobs-sdk-dsh` 是一个 DeepSeek Harness (DSH) 可观测插件,直接将 GenAI trace 数据上报到腾讯云日志服务 (CLS)。

  • 作者による申告github.come46575d24323…

    它观察 DSH 原生的 session、agent loop、LLM stream 和 tool 生命周期,将其转换为腾讯云AI Agent可观测规范的 5 层 span 层级模型(entry → agent → step → chat →…

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-21。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。