/ الدليل / الملعب / langsmith-fetch-skill
● مجتمع OthmanAdi ⚡ فوري

langsmith-fetch-skill

بواسطة OthmanAdi · OthmanAdi/langsmith-fetch-skill

تصحيح أخطاء وكلاء LangChain / LangGraph من خط أوامرك — يجلب آثار LangSmith Studio إلى Claude Code ويحلل الأعطال والزمن الكامن واستدعاءات الأدوات.

مهارة الملاحظة المركزة. عندما تطلب من Claude تصحيح أخطاء وكيل، يقوم بتشغيل langsmith-fetch مقابل LangSmith Studio، وسحب بيانات الآثار، وتحليل أنماط التنفيذ، وإبراز الأعطال والأسباب الجذرية ونقاط الزمن الكامن الحرجة ومشاكل استدعاءات الأدوات. تصدير الجلسات للمراجعة لاحقاً.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

langsmith-fetch-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "langsmith-fetch-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/OthmanAdi/langsmith-fetch-skill",
        "~/.claude/skills/langsmith-fetch-skill"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "langsmith-fetch-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/OthmanAdi/langsmith-fetch-skill",
        "~/.claude/skills/langsmith-fetch-skill"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "langsmith-fetch-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/OthmanAdi/langsmith-fetch-skill",
        "~/.claude/skills/langsmith-fetch-skill"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "langsmith-fetch-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/OthmanAdi/langsmith-fetch-skill",
        "~/.claude/skills/langsmith-fetch-skill"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "langsmith-fetch-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/OthmanAdi/langsmith-fetch-skill",
        "~/.claude/skills/langsmith-fetch-skill"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "langsmith-fetch-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/OthmanAdi/langsmith-fetch-skill",
          "~/.claude/skills/langsmith-fetch-skill"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add langsmith-fetch-skill -- git clone https://github.com/OthmanAdi/langsmith-fetch-skill ~/.claude/skills/langsmith-fetch-skill

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: langsmith-fetch-skill

تشخيص وكيل بطيء دون فتح واجهة LangSmith

👤 مطورو LangChain/LangGraph ⏱ ~20 min intermediate

متى تستخدمه: وكيل كان سريعاً في السابق أصبح بطيئاً الآن؛ تريد معرفة السبب الجذري.

المتطلبات الأساسية
  • مفتاح LangSmith API — smith.langchain.com -> Settings -> API Keys
  • تثبيت المهارة — git clone https://github.com/OthmanAdi/langsmith-fetch-skill ~/.claude/skills/langsmith-fetch-skill
الخطوات
  1. اطلب من Claude التشخيص
    لماذا وكيلي <name> بطيء؟ اسحب آخر 20 آثار من LangSmith وجد نقطة الاختناق.✓ تم النسخ
    → المهارة تسحب الآثار؛ تقارير بالزمن الكامن حسب الخطوة
  2. التعمق
    ركز على الأثر <id> — حلل أوقات استدعاءات الأدوات.✓ تم النسخ
    → الزمن الكامن لكل أداة مع استدعاء القيم الشاذة

النتيجة: خطوة محددة للتحسين، وليس تخمين.

المزالق
  • تحسين المتوسط عندما يكون الزمن الكامن الطرفي هو المشكلة — اطلب p95/p99 بشكل محدد
اجمعها مع: filesystem

تحديد السبب الجذري لفشل الوكيل من معرف الأثر

👤 أي شخص يشغل LangGraph في الإنتاج ⏱ ~15 min intermediate

متى تستخدمه: قام مستخدم بالإبلاغ عن خطأ؛ لديك معرف الأثر.

الخطوات
  1. جلب وتحليل
    صحح أخطاء الأثر <id>. ما الخطأ الفوري، ما السبب الجذري في الرسم البياني؟✓ تم النسخ
    → خطوة الخطأ + القرار السابق الذي أدى إليه

النتيجة: إصلاح يستهدف نقطة القرار الفعلية، وليس العرض.

ابحث عن العقدة التي تستهلك أكثر الرموز

👤 فرق تحسين نفقات LLM ⏱ ~30 min intermediate

متى تستخدمه: المراجعة الشهرية لنفقات الوكيل.

الخطوات
  1. دمج استخدام الرموز
    عبر آثار آخر 7 أيام، رتب عقد الرسم البياني حسب إجمالي استخدام الرموز.✓ تم النسخ
    → جدول مرتب مع حصة %
  2. اقترح التشديد
    بالنسبة للـ 3 الأفضل، اقترح خيارات ضغط المطالبة أو خفض النموذج.✓ تم النسخ
    → قائمة تحسين مستهدفة

النتيجة: تقليل نفقات قابل للقياس دون مطاردة المدخرات الصغيرة.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

langsmith-fetch-skill + filesystem

احفظ التصديرات إلى جانب كود الوكيل لتتبع النسب

صدّر جلسة تصحيح الأخطاء إلى debugging/traces/<date>.json.✓ تم النسخ
langsmith-fetch-skill + github

أرفق ملخص الأثر بتقرير الخطأ

لخص الأثر <id> ونشر كتعليق على مشكلة GitHub #42.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
fetch_recent project, limit التشخيص الواسع LangSmith quota
fetch_trace trace_id الغوص العميق في تشغيل واحد LangSmith quota
analyze_failures traces تحليل ما بعد الجلب 0
export_session traces الأرشفة لاحقاً 0

التكلفة والحدود

تكلفة التشغيل

حصة API
LangSmith: يعتمد على الخطة؛ Studio لديه حصص سخية
الرموز لكل استدعاء
منخفض — الآثار منظمة
التكلفة المالية
مهارة مجانية؛ المستوى المجاني من LangSmith يغطي معظم المطورين
نصيحة
استخدم fetch_recent بنطاق ضيق، وليس السجل الكامل

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: LangSmith: قراءة على مشروعك (مشاريعك)
تخزين بيانات الاعتماد: LANGCHAIN_API_KEY في البيئة
نقل البيانات الخارجي: فقط إلى LangSmith (حيث الآثار موجودة بالفعل)
لا تمنح أبدًا: الكتابة إلى LangSmith — المهارة تقرأ فقط

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

langsmith-fetch: command not found

ثبت LangSmith CLI أو تأكد من أنه في PATH

تحقق: which langsmith-fetch
Empty results

تحقق من اسم المشروع والفترة الزمنية؛ الآثار محدودة بالمشروع

البدائل

langsmith-fetch-skill مقابل البدائل

البديلمتى تستخدمهاالمقايضة
واجهة LangSmith الويبإذا فضلت النقرلا يوجد تحليل Claude

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills