创建账户和 API 密钥

要开始使用 LangSmith，你需要创建一个账户。你可以在 LangSmith UI 注册一个免费账户。LangSmith 支持通过 Google、GitHub 和电子邮件登录。

API 密钥

LangSmith 支持两种类型的 API 密钥。你可以使用这两种类型的令牌来验证对 LangSmith API 的请求，但它们有不同的使用场景。

要使用 LangSmith 记录跟踪并运行评估，请创建一个 API 密钥来验证你的请求。

打开 API 密钥设置

导航到设置页面并选择 API 密钥 (API Keys) 部分。

配置密钥类型

对于服务密钥，请选择组织范围密钥或工作区范围密钥。如果密钥是工作区范围的，你必须指定具体的工作区。企业版用户还可以为服务密钥分配特定的工作区角色，从而独立于任何用户来调整其权限。

设置有效期

设置密钥的过期时间。密钥在选择的天数之后将无法使用，如果选择“永不过期”，则密钥永久有效。

创建密钥

点击 创建 API 密钥 (Create API Key)。LangSmith 只会显示一次 API 密钥，因此请务必将其复制并妥善保存。

要删除 API 密钥，请导航到设置页面，在 API 密钥 部分找到该密钥，然后点击操作 (Actions) 列中的垃圾桶图标。

为你的语言安装 SDK

pip install langsmith

npm install langsmith

有关详细信息，请参阅 Python SDK 或 JS/TS SDK 参考文档。然后，设置你的 API 密钥并启用跟踪：

export LANGSMITH_API_KEY=<your-api-key>
export LANGSMITH_TRACING=true

你可能还需要以下额外的环境变量。 LANGSMITH_ENDPOINT 控制 SDK 将数据发送到哪个 LangSmith 服务器。默认值为 https://api.smith.langchain.com（美国云）。仅当你使用不同的部署时才设置它：

仅当你的 API 密钥范围跨越多个工作区时，才需要设置 LANGSMITH_WORKSPACE_ID。你可以在设置页面的 常规 (General) 部分找到你的工作区 ID： LANGSMITH_WORKSPACE_ID=<工作区 ID>

将这些文档连接到 Claude、VSCode 等，以获得实时答案。