← Back to Blog

LangGraph Financial Analyst Agent 设置指南

Xiao Wu
Xiao WuAuthor
June 25, 2025AGENT
Tags:
AgentLangGraph

LangGraph Financial Analyst Agent 设置指南

本指南将帮助您快速设置和运行基于LangGraph的Financial Analyst Agent。

快速开始

1. 环境准备

确保您已经安装了必要的依赖：

# 安装依赖
npm install
 
# 或使用pnpm
pnpm install

2. 环境变量配置

创建或更新 .env 文件：

# OpenAI API (如果使用LLM功能)
OPENAI_API_KEY=your_openai_api_key
 
# LangSmith追踪 (可选，用于调试)
LANGCHAIN_TRACING_V2=true
LANGCHAIN_API_KEY=your_langsmith_api_key
LANGCHAIN_PROJECT=Financial-Agent-System
 
# SEC API (如果使用官方SEC数据)
SEC_API_KEY=your_sec_api_key

3. 验证安装

运行基本测试确保一切正常：

# 验证LangGraph结构
npm run test:financial-analyst

可用命令

开发和调试

# 启动LangGraph开发服务器
npm run langgraph:dev
 
# 启动LangGraph Studio (可视化调试)
npm run langgraph:studio
 
# 运行演示脚本
npm run test:langgraph
 
# 运行完整测试套件
npm run test:financial-analyst

LangGraph Studio

LangGraph Studio是一个强大的可视化调试工具：

  1. 启动Studio：

    npm run langgraph:studio

  2. 访问：http://localhost:2024

  3. 在Studio中您可以：

    • 实时查看工作流执行
    • 监控状态变化
    • 调试节点逻辑
    • 查看执行轨迹

API使用

基本API调用

# 测试LangGraph API
curl -X POST http://localhost:3000/api/chat/agent/langgraph \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "分析Apple Inc. (AAPL)的财务状况",
    "userId": "test-user"
  }'

流式API调用

# 测试流式响应
curl -X POST http://localhost:3000/api/chat/agent/langgraph \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "分析Apple Inc. (AAPL)的财务状况",
    "userId": "test-user",
    "stream": true
  }'

配置选项

LangGraph配置

在 langgraph.json 中配置图：

{
  "graphs": {
    "financial_analyst_loop": "./lib/agents/core/financial-analyst-langgraph.ts:financialAnalystGraph"
  },
  "node_version": "20",
  "env": ".env"
}

工作流参数

可以通过初始状态调整工作流行为：

const initialState = {
  userQuery: "您的查询",
  userId: "user-id",
  maxSteps: 10,        // 最大执行步数
  // ... 其他参数
};

测试用例

预定义测试

系统包含以下预定义测试用例：

  1. Apple完整分析 - 测试完整的五阶段分析流程
  2. 微软收入分析 - 测试收入分析专项功能
  3. 谷歌增长分析 - 测试增长分析专项功能

自定义测试

修改 scripts/test-financial-analyst-langgraph.ts 中的 testCases 数组来添加自定义测试：

const customTestCase = {
  name: "自定义测试",
  description: "测试特定功能",
  userQuery: "您的查询",
  companyIdentifier: "TICKER",
  expectedPhases: ['document_acquisition', 'revenue_analysis'],
  maxSteps: 8,
  timeout: 30000
};

故障排除

常见问题

  1. LangGraph启动失败

    # 检查依赖
npm list @langchain/langgraph
 
# 重新安装
npm install @langchain/langgraph

  2. 测试超时

    • 增加测试用例的timeout值
    • 检查网络连接
    • 验证API密钥配置

  3. 状态循环

    • 启用LangGraph Studio查看执行流程
    • 检查条件路由逻辑
    • 增加maxSteps限制

调试技巧

  1. 启用详细日志

    // 在代码中添加
console.log('🔍 调试信息:', state);

  2. 使用LangGraph Studio

    • 实时监控执行过程
    • 查看状态变化
    • 分析性能瓶颈

  3. 分步测试

    # 修改测试用例，限制执行步数
maxSteps: 3

性能优化

建议设置

// 生产环境推荐配置
const productionConfig = {
  maxSteps: 15,
  timeout: 300000,     // 5分钟
  enableTracing: false, // 关闭追踪以提高性能
  retryAttempts: 3
};

监控指标

关注以下性能指标：

  • 总执行时间
  • 各阶段执行时间
  • 工具选择准确率
  • 验证通过率
  • 错误恢复成功率

扩展开发

添加新工具

  1. 创建工具类继承 BaseFinancialTool
  2. 实现 execute 方法
  3. 更新工具选择逻辑
  4. 添加验证逻辑

添加新阶段

  1. 更新 AnalysisPhase 类型
  2. 创建对应的分析工具
  3. 更新 planningNode 逻辑
  4. 添加验证规则

修改状态流程

  1. 更新状态转换逻辑
  2. 修改条件路由
  3. 测试新的执行路径
  4. 更新文档

部署建议

开发环境

# 启动开发服务器
npm run dev
 
# 在另一个终端启动LangGraph Studio
npm run langgraph:studio

生产环境

# 构建项目
npm run build
 
# 启动生产服务器
npm start

Docker部署

# 示例Dockerfile片段
FROM node:20-alpine
 
# 安装LangGraph CLI
RUN npm install -g @langchain/langgraph-cli
 
# ... 其他配置

支持和反馈

如果遇到问题：

  1. 查看详细日志
  2. 使用LangGraph Studio调试
  3. 运行测试套件验证
  4. 检查环境配置

更多详细信息请参考：

Comments