mcpField
L
langsmith-fetch

langsmith-fetch

github.com/langchain-aiエージェントワークフロー3950 回インストール36 週間前に更新
リポジトリ

langsmith-fetch について

langsmith-fetchは、LangSmithのトレースをローカルに保存するコマンドラインスキルです。Agentの実行を調査する開発者向けで、最近のトレースやID指定のトレースを取得できます。

主な機能

  1. 01最近のトレース取得
  2. 02ID指定でのトレース取得
  3. 03JSONまたは読みやすい形式で保存
  4. 04ツール呼び出しと結果の確認

活用シーン

  1. 01Agentの予期しない動作の調査
  2. 02ツール呼び出しと返却データの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/langchain-ai/lca-skills --skill langsmith-fetch

インストール後、Claude Code で/langsmith-fetchを入力して読み込まれたか確認します。

詳細

LangSmith トレースの取得

プロジェクトの依存関係に langsmith-fetch があり、.env ファイルに LANGSMITH_API_KEY が設定されている必要があります。

セットアップ

まず、LANGSMITH_API_KEY を含む .env ファイルを探します。

find . -name ".env" -type f 2>/dev/null | head -5

コマンド

すべてのコマンドで --env-file <path-to-.env> を使用します。

# Fetch recent traces (uses LANGSMITH_PROJECT from .env, or specify --project-uuid)
uv run --env-file <path> langsmith-fetch traces ./traces --limit 10
uv run --env-file <path> langsmith-fetch traces ./traces --project-uuid <uuid> --limit 10

# Fetch single trace by ID
uv run --env-file <path> langsmith-fetch trace <trace-id>

# Include metadata (timing, tokens, costs)
uv run --env-file <path> langsmith-fetch trace <trace-id> --include-metadata

出力形式

  • --format pretty - 人間が読みやすい形式（デフォルト）
  • --format json - 整形済み JSON
  • --format raw - パイプ処理向けのコンパクトな JSON

トラブルシューティングのワークフロー

  1. .env を探します：find . -name ".env" -type f 2>/dev/null
  2. 最近のトレースを取得します：uv run --env-file <path> langsmith-fetch traces ./debug --limit 10
  3. 保存された JSON ファイルから該当するトレースを探します
  4. 次を確認します：どのツールが呼び出されましたか？何が返されましたか？正しい結果、または期待どおりの結果でしたか？

コメント

Markdown 対応