> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LangSmith 技能

> 使用代理技能从您的编码代理中操作 LangSmith 追踪、数据集和评估器。

代理技能是可复用的、按需提供的能力，它们捆绑了指令以及可选的辅助脚本。本页总结了您可以添加到兼容编码代理中的、面向 LangSmith 的技能，用于查询追踪、生成数据集和定义评估器。要直接从终端操作相同的 LangSmith 数据，请使用 [LangSmith CLI](/langsmith/langsmith-cli)。

<Note>
  这些技能遵循代理技能规范，并在 [`langsmith-skills` GitHub 仓库](https://github.com/langchain-ai/langsmith-skills) 中维护。您可以将 `SKILL.md` 和任何引用的 `scripts/` 复制到您的代理技能目录中。下面的安装程序仅安装 LangSmith 技能（追踪、数据集、评估器）。
</Note>

## 快速安装

使用 `npx skills` 仅安装 LangSmith 技能（追踪、数据集、评估器）：

<CodeGroup>
  ```bash 本地（当前项目） theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  npx skills add langchain-ai/langsmith-skills --skill '*' --yes
  ```

  ```bash 全局（所有项目） theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  npx skills add langchain-ai/langsmith-skills --skill '*' --yes --global
  ```

  ```bash 链接到特定代理（例如 Claude Code） theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  npx skills add langchain-ai/langsmith-skills --agent claude-code --skill '*' --yes --global
  ```
</CodeGroup>

<Tip>
  要更新，请重新运行该命令。如果目标技能文件夹已存在，请先将其删除（例如 `rm -rf ~/.claude/skills/langsmith-*`）。
</Tip>

## 配置环境

安装技能后，设置所有 LangSmith 技能、辅助脚本和 [LangSmith CLI](/langsmith/langsmith-cli) 使用的环境变量：

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
export LANGSMITH_API_KEY=<your-key>
# 可选默认值
export LANGSMITH_PROJECT=<default-project>
# 高级：仅适用于多工作区或某些自托管设置
# export LANGSMITH_WORKSPACE_ID=<workspace-id>
```

## 这些技能涵盖的内容

* [追踪](/langsmith/observability-concepts#traces)：为应用添加追踪；列出、过滤、检查和导出追踪以进行调试和分析。
* [数据集](/langsmith/evaluation-concepts#datasets)：将追踪转换为评估数据集（final\_response、single\_step、trajectory、RAG），并可选择上传到 LangSmith。
* [评估器](/langsmith/evaluation-concepts#evaluators)：定义代码或 LLM 作为评判的评估器，并将其附加到数据集（离线）或项目（在线）。

每个技能目录都包含一个 `SKILL.md` 以及可选的 `scripts/` 辅助脚本，您可以运行或调整这些脚本。这些技能旨在插入兼容的编码代理（如 Claude Code 或 DeepAgents CLI），不过如果您不想设置完整的代理，也可以直接重用辅助脚本。对于更复杂的查询、导出或自动化，您可以将这些技能与 [LangSmith CLI](/langsmith/langsmith-cli) 结合使用，从终端对相同的项目、数据集和评估器进行脚本化操作。

## 手动安装

克隆仓库并运行安装脚本以获取更多选项：

```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
git clone https://github.com/langchain-ai/langsmith-skills.git
cd langsmith-skills

# 在当前目录为 Claude Code 安装（默认）
./install.sh

# 全局为 Claude Code 安装
./install.sh --global

# 在当前目录为 DeepAgents CLI 安装
./install.sh --deepagents

# 全局为 DeepAgents CLI 安装（包含代理角色）
./install.sh --deepagents --global

# 仅安装 LangSmith 技能（任何目标）
./install.sh --langsmith
```

如果您更喜欢只复制特定技能，请将所需目录从 `config/skills/` 复制到您的代理技能文件夹中。

包含的 LangSmith 技能：

* langsmith-trace — 追踪（查询/导出）
* langsmith-dataset — 数据集（生成/上传）
* langsmith-evaluator — 评估器（创建/附加）

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档连接](/use-these-docs)到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/skills.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>