# DataStandardizationAgent

**Repository Path**: ethanYuan/data-standardization-agent

## Basic Information

- **Project Name**: DataStandardizationAgent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DataStandardizationAgent

## 介绍

这是一个使用 LangGraph 进行 Agent 调用的项目。项目使用 Python 3.12 开发，集成 LangGraph 作为 SDK，实现 Agent 的初始化和 LLM 调用功能。

## 项目结构

```
data-standardization-agent/
├── demo.py                              # Hello World Demo 入口
├── pyproject.toml                       # 项目配置和依赖
├── .env.example                         # 环境变量示例
└── src/
    └── data_standardization_agent/
        ├── __init__.py                  # 包初始化
        └── agent.py                     # Agent 核心实现
```

## 快速开始

### 1. 安装依赖

```bash
pip install -e .
```

### 2. 配置环境变量

复制环境变量示例文件并配置：

```bash
cp .env.example .env
```

编辑 `.env` 文件，设置必需的环境变量：

```bash
# OpenAI API密钥（必需）
OPENAI_API_KEY=your-api-key-here

# LLM Base URL（可选，默认使用 OpenAI API）
# LLM_BASE_URL=https://api.openai.com/v1

# 模型名称（可选，默认 gpt-4o-mini）
# MODEL_NAME=gpt-4o-mini
```

### 3. 运行 Demo

```bash
python demo.py
```

## 功能特性

- **Agent 初始化**: 创建可配置的 LangGraph Agent 实例
- **LLM URL 配置**: 支持自定义 LLM 服务地址
- **简单调用**: 提供简洁的 API 进行 Agent 调用

## API 使用

### 创建 Agent

```python
from data_standardization_agent.agent import create_agent, run_agent

# 创建 Agent 工作流
workflow = create_agent(llm_url="https://your-llm-service.com/v1")
app = workflow.compile()
```

### 运行 Agent

```python
# 直接调用
response = run_agent("Hello, World!")
print(response)

# 或指定自定义 LLM URL
response = run_agent(
    prompt="Hello!",
    llm_url="https://your-llm-service.com/v1",
    model_name="your-model-name"
)
```

## 环境变量说明

| 变量名 | 必需 | 默认值 | 说明 |
|--------|------|--------|------|
| `OPENAI_API_KEY` | 是 | - | OpenAI API 密钥 |
| `LLM_BASE_URL` | 否 | `https://api.openai.com/v1` | LLM 服务地址 |
| `MODEL_NAME` | 否 | `gpt-4o-mini` | 使用的模型名称 |

## 技术栈

- Python 3.12
- LangGraph >= 0.2.0
- LangChain Core >= 0.3.0
- LangChain OpenAI >= 0.2.0

## 开发

### 安装开发依赖

```bash
pip install -e ".[dev]"
```

### 代码检查

```bash
ruff check src/
```