# x-langsmith

**Repository Path**: chain-engine/x-langsmith

## Basic Information

- **Project Name**: x-langsmith
- **Description**: 一个完整的 LangSmith（可观测性平台） 学习与实践项目
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-02-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# x-langsmith

## 项目定位
`x-langsmith` 是一个完整的 LangSmith（可观测性平台）学习与实践项目，旨在帮助开发者快速掌握 LangSmith 的核心功能和最佳实践，构建可观测、可调试、可优化的大语言模型应用。

## 什么是 LangSmith
`LangSmith` 是一个专为 LLM 应用设计的可观测性平台，由 LangChain 团队开发和维护。它提供了一套完整的工具链，用于追踪、评估、监控和优化基于大语言模型的应用。

### LangSmith 与 LangChain 的关系
- **同属生态系统**：LangSmith 和 LangChain 都属于 LangChain 生态系统，由同一团队开发
- **功能互补**：LangChain 提供了构建 LLM 应用的框架和工具，而 LangSmith 则提供了观测、评估和监控这些应用的能力
- **无缝集成**：LangSmith 与 LangChain 应用可以无缝集成，自动捕获和分析应用的运行数据
- **独立使用**：虽然与 LangChain 深度集成，但 LangSmith 也可以独立用于监控非 LangChain 构建的 LLM 应用

## 软件架构
项目采用模块化架构设计，主要包含以下组件：
- **核心示例**：展示 LangSmith 各种功能的示例代码
- **配置模块**：LangSmith 连接和配置管理
- **工具集**：辅助开发和测试的实用工具

## 项目结构
项目目录结构如下：
```
x-langsmith/
├── .gitee/            # Gitee 相关配置文件
├── examples/          # LangSmith 示例代码
│   └── basic_tracing.py  # 基本追踪功能示例
├── .gitignore         # Git 忽略文件配置
├── .python-version    # Python 版本指定
├── LICENSE            # MIT 许可证文件
├── README.en.md       # 英文 README 文档
├── README.md          # 中文 README 文档
├── pyproject.toml     # 项目配置和依赖管理
└── uv.lock            # 依赖版本锁定文件
```

## 安装教程

1. **环境要求**：Python 3.9 及以上版本
2. **安装依赖**：使用 uv 管理项目依赖
   ```bash
   uv install
   ```
3. **配置 LangSmith**：设置环境变量
   ```bash
   export LANGSMITH_TRACING=true
   export LANGSMITH_API_KEY=your_api_key
   ```

## 使用说明

1. **克隆项目**：
   ```bash
   git clone https://gitee.com/chain-engine/x-langsmith.git
   cd x-langsmith
   ```
2. **运行示例**：
   ```bash
   python examples/basic_tracing.py
   ```
3. **查看追踪数据**：访问 LangSmith 控制台查看应用运行数据
4. **评估应用**：使用 LangSmith 的评估工具评估应用性能

## 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

## 许可证
本项目采用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。