langsmith-fetch技能：调试LangChain和LangGraph代理的必备工具

langsmith-fetch技能调试LangChain和LangGraph代理的必备工具【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skillsLangSmith Fetch是一款强大的命令行工具专为调试LangChain和LangGraph代理而设计。它允许开发者直接从LangSmith Studio获取执行跟踪轻松分析代理行为、排查错误、检查工具调用和内存操作以及评估性能问题。无论是新手还是经验丰富的开发者这款工具都能显著提升你的工作流自动化调试效率。图LangSmith Fetch技能帮助开发者轻松调试LangChain和LangGraph代理快速开始安装与配置1. 安装langsmith-fetch要开始使用这个强大的调试工具首先需要通过pip安装pip install langsmith-fetch2. 设置环境变量安装完成后需要配置环境变量以连接到LangSmith Studioexport LANGSMITH_API_KEYyour_langsmith_api_key export LANGSMITH_PROJECTyour_project_name验证设置是否成功echo $LANGSMITH_API_KEY echo $LANGSMITH_PROJECT核心工作流程从简单到高级工作流程1快速调试最近活动当你需要快速了解代理最近的执行情况时只需运行langsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty这个命令会显示过去5分钟内的5条跟踪记录包括✅ 跟踪数量和状态⚠️ 错误或失败情况️ 调用的工具⏱️ 执行时间 令牌使用情况工作流程2深入分析特定跟踪当你需要详细分析某个特定跟踪时可以使用跟踪ID进行深入调试langsmith-fetch trace trace-id --format json这将提供完整的JSON格式跟踪数据帮助你了解 代理的目标️ 工具调用顺序✅ 工具结果❌ 错误信息 根本原因分析 建议的修复方案工作流程3导出调试会话当你需要保存当前调试会话供日后分析或与团队共享时可以导出跟踪和线程# 创建带时间戳的会话文件夹 SESSION_DIRlangsmith-debug/session-$(date %Y%m%d-%H%M%S) mkdir -p $SESSION_DIR # 导出跟踪 langsmith-fetch traces $SESSION_DIR/traces --last-n-minutes 30 --limit 50 --include-metadata # 导出线程对话 langsmith-fetch threads $SESSION_DIR/threads --limit 20导出的会话将包含所有必要的调试信息方便你进行深入分析或与团队协作解决问题。工作流程4错误检测与分析当你需要快速定位和分析错误时可以使用以下命令# 获取最近的跟踪 langsmith-fetch traces --last-n-minutes 30 --limit 50 --format json recent-traces.json # 搜索错误 grep -i error\|failed\|exception recent-traces.json这将帮助你识别错误类型、频率、发生时间以及涉及的代理/工具从而快速定位问题根源。常见用例解决实际问题用例1代理没有响应当你的代理没有按预期响应时首先检查是否有跟踪记录langsmith-fetch traces --last-n-minutes 5 --limit 5如果没有找到跟踪可能是因为跟踪功能未启用检查LANGCHAIN_TRACING_V2trueAPI密钥未正确设置代理实际上没有运行如果找到跟踪则需要检查错误、执行时间和工具调用完成情况。用例2调用了错误的工具当代理调用了错误的工具时你需要获取特定跟踪查看执行时可用的工具检查代理选择工具的推理过程检查工具描述和指令改进提示或工具配置用例3内存不工作当代理似乎不记得之前的对话时可以搜索内存操作langsmith-fetch traces --last-n-minutes 10 --limit 20 --format raw | grep -i memory\|recall\|store检查是否调用了内存工具、召回是否返回结果、记忆是否被正确存储以及检索到的记忆是否被使用。用例4性能问题当代理运行缓慢时可以导出带有元数据的跟踪进行性能分析langsmith-fetch traces ./perf-analysis --last-n-minutes 30 --limit 50 --include-metadata分析执行时间、工具调用延迟、令牌使用情况、迭代次数和最慢的操作以识别瓶颈并提出优化建议。输出格式指南选择适合你的格式漂亮格式默认langsmith-fetch traces --limit 5 --format pretty用途快速视觉检查向用户展示结果JSON格式langsmith-fetch traces --limit 5 --format json用途详细分析语法高亮显示原始格式langsmith-fetch traces --limit 5 --format raw用途管道传输到其他命令自动化处理高级功能提升调试效率基于时间的过滤# 特定时间戳之后 langsmith-fetch traces --after 2025-12-24T13:00:00Z --limit 20 # 最近N分钟最常用 langsmith-fetch traces --last-n-minutes 60 --limit 100包含元数据# 获取额外上下文 langsmith-fetch traces --limit 10 --include-metadata # 元数据包括代理类型、模型、标签、环境并发获取更快# 加速大型导出 langsmith-fetch traces ./output --limit 100 --concurrent 10故障排除解决常见问题未找到匹配条件的跟踪可能原因时间范围内没有代理活动跟踪功能被禁用项目名称错误API密钥问题解决方案# 1. 尝试更长的时间范围 langsmith-fetch traces --last-n-minutes 1440 --limit 50 # 2. 检查环境 echo $LANGSMITH_API_KEY echo $LANGSMITH_PROJECT # 3. 尝试获取线程 langsmith-fetch threads --limit 10 # 4. 验证代码中是否启用了跟踪 # 检查LANGCHAIN_TRACING_V2true项目未找到解决方案# 查看当前配置 langsmith-fetch config show # 设置正确的项目 export LANGSMITH_PROJECTcorrect-project-name # 或永久配置 langsmith-fetch config set project your-project-name环境变量不持久解决方案# 添加到shell配置文件~/.bashrc或~/.zshrc echo export LANGSMITH_API_KEYyour_key ~/.bashrc echo export LANGSMITH_PROJECTyour_project ~/.bashrc # 重新加载shell配置 source ~/.bashrc最佳实践提升调试体验1. 定期健康检查# 更改后快速检查 langsmith-fetch traces --last-n-minutes 5 --limit 52. 有组织的存储langsmith-debug/ ├── sessions/ │ ├── 2025-12-24/ │ └── 2025-12-25/ ├── error-cases/ └── performance-tests/3. 记录发现发现错误时导出有问题的跟踪保存到error-cases/文件夹在README中记录问题与团队分享跟踪ID4. 与开发集成# 提交代码前 langsmith-fetch traces --last-n-minutes 10 --limit 5 # 如果发现错误 langsmith-fetch trace error-id --format json pre-commit-error.json快速参考常用命令# 最常用命令 # 快速调试 langsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty # 特定跟踪 langsmith-fetch trace trace-id --format pretty # 导出会话 langsmith-fetch traces ./debug-session --last-n-minutes 30 --limit 50 # 查找错误 langsmith-fetch traces --last-n-minutes 30 --limit 50 --format raw | grep -i error # 包含元数据 langsmith-fetch traces --limit 10 --include-metadata通过掌握langsmith-fetch技能你可以轻松调试LangChain和LangGraph代理快速定位问题并优化性能。无论你是在开发新的代理还是维护现有系统这款工具都将成为你工作流中不可或缺的一部分。开始使用langsmith-fetch提升你的自动化调试效率吧要开始使用这个强大的技能只需克隆仓库git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills然后按照上述指南安装和配置langsmith-fetch开始你的高效调试之旅【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考