# langgraph

**Repository Path**: li-zhenyi/langgraph

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-06
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LangGraph Multi-Agent Service

基于 **LangGraph** 的多智能体协作系统，集成 **MCP 协议**（标准化工具调用）和 **A2A 协议**（标准化 Agent 通信）。

## 快速开始

```bash
# 安装依赖
uv sync

# 配置环境变量
cp .env.example .env
# 编辑 .env，设置 OPENAI_API_KEY

# 启动服务
uv run python -m src.main

# 测试
curl -X POST http://localhost:8000/api/v1/query \
  -H "Content-Type: application/json" \
  -d '{"query": "你好"}'
```

## 项目架构

```
API 层 (FastAPI + WebSocket)
  ↓
编排层 (LangGraph StateGraph: Supervisor + Router + Agent 子图)
  ↓
协议层 (MCP: 工具发现/调用 | A2A: 跨服务 Agent 通信)
  ↓
工具/Agent 层 (MCP Tools | A2A Remote Agents)
```

## 开发

```bash
# 安装开发依赖
uv sync --extra dev

# 运行测试
uv run pytest

# 代码格式化
uv run ruff format src/ tests/

# 类型检查
uv run mypy src/
```

## 目录结构

- `src/graph/` — LangGraph 编排核心（State、Supervisor、Router、Agent 子图）
- `src/mcp/` — MCP 协议集成（Server、Client、插件）
- `src/a2a/` — A2A 协议集成（Server、Client、Registry）
- `src/rag/` — RAG 智能工具选择
- `src/infra/` — 基础设施（熔断器、负载均衡、日志、指标）
- `src/api/` — API 接口（REST、WebSocket）

详细设计文档见 [docs/design.md](docs/design.md)。