langgraph-project-setup

用途

LangGraph Project Setup 用于初始化并配置 LangGraph 项目，覆盖本地开发与部署所需的项目结构、langgraph.json 配置、环境变量和依赖管理。它适合需要快速搭建 LangGraph 智能体项目骨架、并希望遵循规范目录结构的开发者。

主要能力

提供 Python 与 JavaScript/TypeScript 两种语言的初始化脚本。
支持两种项目模式：simple（单智能体、结构精简）与 multiagent（模块化、多智能体、适合复杂工作流与生产应用）。
自动生成项目目录结构、langgraph.json 配置、.env 模板、依赖文件（pyproject.toml 或 package.json）、.gitignore 以及带 TODO 注释的样板代码。
提供交互式环境变量配置脚本，可配置 OpenAI、Anthropic（Claude）、Google（Gemini）、AWS Bedrock、LangSmith（追踪）、Tavily（搜索）等提供方。
提供 langgraph.json 配置校验脚本，检查必填字段、文件路径引用、可选字段格式及常见配置错误。
说明如何启动开发服务器（langgraph dev，无需 Docker、内存状态持久化、热重载、默认端口 2024）或类生产测试（langgraph up，需要 Docker、PostgreSQL 状态持久化、默认端口 8123）。
说明如何连接 LangGraph Studio 进行可视化调试。

使用方式

Python 项目初始化：

uv run scripts/init_langgraph_project.py my-agent

若 uv 不可用：

python3 scripts/init_langgraph_project.py my-agent

带选项：

uv run scripts/init_langgraph_project.py my-agent \
  --pattern multiagent \
  --python-version 3.12

JavaScript/TypeScript 项目初始化：

node scripts/init_langgraph_project.js my-agent
node scripts/init_langgraph_project.js my-agent --typescript
node scripts/init_langgraph_project.js my-agent \
  --pattern multiagent \
  --typescript

安装依赖（Python）：

cd my-agent
uv venv --python 3.12
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e '.[dev]'

若 uv 不可用：

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e '.[dev]'

安装依赖（JavaScript）：

cd my-agent
npm install  # or: yarn install / pnpm install

交互式配置环境变量：

uv run scripts/setup_providers.py

手动编辑 .env 示例：

# Required: Choose at least one LLM provider
OPENAI_API_KEY=sk-...
# or
ANTHROPIC_API_KEY=sk-ant-...

# Optional: Enable tracing
LANGSMITH_API_KEY=lsv2_...
LANGSMITH_TRACING=true
LANGSMITH_PROJECT=my-project

langgraph.json 示例：

{
  "dependencies": ["."],
  "graphs": {
    "agent": "./my_agent/agent.py:graph"
  },
  "env": ".env",
  "python_version": "3.11"
}

启动开发服务器：

langgraph dev

类生产测试：

langgraph up

连接 LangGraph Studio：

https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024

Safari 用户可使用：

langgraph dev --tunnel

校验配置：

uv run scripts/validate_langgraph_config.py

本地测试智能体：

langgraph dev

curl -X POST http://localhost:2024/invoke \
  -H "Content-Type: application/json" \
  -d '{"input": {"messages": [{"role": "user", "content": "Hello"}]}}'

适用场景

快速创建 LangGraph 智能体项目骨架，避免手动搭建目录与配置文件。
需要区分简单单智能体与多智能体模块化架构的项目。
需要统一管理 LLM 提供方、追踪与搜索等环境变量的项目。
需要在本地开发（langgraph dev）与类生产环境（langgraph up）之间切换测试的项目。
需要连接 LangGraph Studio 进行可视化调试与验证的项目。

限制

资料未提供该技能的收费、价格或授权信息。
资料未提供支持的操作系统范围、性能指标或效果保证。
资料未提供除 OpenAI、Anthropic、Google、AWS Bedrock、LangSmith、Tavily 之外的其他提供方配置细节。
资料未提供部署到 LangSmith 的具体步骤，仅提示参考 langsmith-deployment 技能。
资料未提供测试与评估的具体方法，仅提示参考 langgraph-testing-evaluation 技能。

技能介绍

用途

主要能力

使用方式

适用场景

限制