● مجتمع
OthmanAdi
⚡ فوري
langsmith-fetch-skill
بواسطة OthmanAdi · OthmanAdi/langsmith-fetch-skill
تصحيح أخطاء وكلاء LangChain / LangGraph من خط أوامرك — يجلب آثار LangSmith Studio إلى Claude Code ويحلل الأعطال والزمن الكامن واستدعاءات الأدوات.
مهارة الملاحظة المركزة. عندما تطلب من Claude تصحيح أخطاء وكيل، يقوم بتشغيل langsmith-fetch مقابل LangSmith Studio، وسحب بيانات الآثار، وتحليل أنماط التنفيذ، وإبراز الأعطال والأسباب الجذرية ونقاط الزمن الكامن الحرجة ومشاكل استدعاءات الأدوات. تصدير الجلسات للمراجعة لاحقاً.
لماذا تستخدمه
الميزات الأساسية
- يسحب الآثار مباشرة من LangSmith Studio عبر CLI
- ينشط تلقائياً عند المطالبات ذات نكهة تصحيح الأخطاء
- يتتبع الأعطال والأسباب الجذرية
- تحليل الزمن الكامن واستخدام الرموز
- مراجعة استدعاءات الأدوات وعمليات الذاكرة
- تصدير الجلسة
عرض مباشر
كيف يبدو في الممارسة
langsmith-fetch-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: langsmith-fetch-skill
متى تستخدمه: وكيل كان سريعاً في السابق أصبح بطيئاً الآن؛ تريد معرفة السبب الجذري.
الخطوات
-
اطلب من Claude التشخيص
لماذا وكيلي <name> بطيء؟ اسحب آخر 20 آثار من LangSmith وجد نقطة الاختناق.✓ تم النسخ
→ المهارة تسحب الآثار؛ تقارير بالزمن الكامن حسب الخطوة
-
التعمق
ركز على الأثر <id> — حلل أوقات استدعاءات الأدوات.✓ تم النسخ
→ الزمن الكامن لكل أداة مع استدعاء القيم الشاذة
النتيجة: خطوة محددة للتحسين، وليس تخمين.
المزالق
- تحسين المتوسط عندما يكون الزمن الكامن الطرفي هو المشكلة — اطلب p95/p99 بشكل محدد
متى تستخدمه: قام مستخدم بالإبلاغ عن خطأ؛ لديك معرف الأثر.
الخطوات
-
جلب وتحليل
صحح أخطاء الأثر <id>. ما الخطأ الفوري، ما السبب الجذري في الرسم البياني؟✓ تم النسخ
→ خطوة الخطأ + القرار السابق الذي أدى إليه
النتيجة: إصلاح يستهدف نقطة القرار الفعلية، وليس العرض.
متى تستخدمه: المراجعة الشهرية لنفقات الوكيل.
الخطوات
-
دمج استخدام الرموز
عبر آثار آخر 7 أيام، رتب عقد الرسم البياني حسب إجمالي استخدام الرموز.✓ تم النسخ
→ جدول مرتب مع حصة %
-
اقترح التشديد
بالنسبة للـ 3 الأفضل، اقترح خيارات ضغط المطالبة أو خفض النموذج.✓ تم النسخ
→ قائمة تحسين مستهدفة
النتيجة: تقليل نفقات قابل للقياس دون مطاردة المدخرات الصغيرة.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
احفظ التصديرات إلى جانب كود الوكيل لتتبع النسب
صدّر جلسة تصحيح الأخطاء إلى debugging/traces/<date>.json.✓ تم النسخ
langsmith-fetch-skill +
githubأرفق ملخص الأثر بتقرير الخطأ
لخص الأثر <id> ونشر كتعليق على مشكلة GitHub #42.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة 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 |