💸 FinancialAssistant

💸 FinancialAssistant

FinancialAssistant 是一款智能财务助手，利用 LLM（语言模型）和基于 Agent 的模块化架构，帮助用户：

• 📊 计算自己的应急储备金
• 💰 评估自己的储蓄能力
• 📈 获取投资建议
• 🤝 交流一般性的金融知识

它集成外部工具（API）进行财务计算和模拟，并使用 LLM 以人性化、共情且个性化的方式解释结果。

---

🚀 使用的技术

• Python 3.10+
• LangGraph
• LangChain
• Google Gemini (via langchain_google_genai)
• Requests
• .env + dotenv

---

🧠 架构

该项目由以下部分组成：

1. 专用 Agent（agents/ 文件夹）

每个 Agent 负责一种类型的协助：

• GenericAgent → 发起一般性和教育性对话
• EmergencyFundAgent → 帮助建立应急储备金
• SavingsAgent → 分析每月储蓄能力
• InvestmentAgent → 根据用户的个人情况提出投资建议

所有 Agent 都使用 LLM，以清晰且富有同理心的方式解释工具的结果。

2. 对话图（LangGraph）

• 带有 LLM 的路由器会检测用户意图，并将其交给合适的 Agent
• 每个 Agent 都可以通过使用 state["intencao_pendente"]，在多条消息中持续掌控对话

3. 外部工具（API）

外部 API 用于计算：

• 月平均支出
• 理想的应急储备金金额
• 储蓄能力
• 投资建议

---

🛠 如何在本地运行项目

# 1. Clone o repositório
$ git clone https://github.com/seu-usuario/FinancialAssistant.git
$ cd FinancialAssistant

# 2. Crie um ambiente virtual
$ python -m venv venv
$ source venv/bin/activate  # ou venv\Scripts\activate no Windows

# 3. Instale as dependências
$ pip install -r requirements.txt

# 4. Configure sua chave .env
GOOGLE_API_KEY=xxxxxx
MCP_SERVER_URL=http://localhost:8000

# 5. Rode o assistente
$ python main.py

---

📁 文件结构

FinancialAssistant/
├── agents/
│   ├── base_agent.py
│   ├── emergency_fund_agent.py
│   ├── generic_agent.py
│   ├── investment_agent.py
│   └── savings_agent.py
├── llm/
│   └── gemini_model.py
├── main.py
├── .env
└── requirements.txt

---

✨ 对话示例

Você: Quero montar uma reserva de emergência
Assistente: Para calcular sua reserva de emergência, preciso saber o valor médio das suas despesas mensais. Pode me informar?

Você: Gasto cerca de 2000 reais por mês
Assistente: Com base nisso, sua reserva ideal seria de aproximadamente R$ 12.000,00 (6 meses de despesas). Assim você fica protegido em caso de imprevistos. Posso te ajudar a começar esse planejamento se quiser!

---

🤝 贡献

欢迎提交 Pull Request！如果要进行重大更改，请先创建 issue，讨论您希望修改的内容。

---

📄 许可证

MIT

---

由 Nielsen 倾力打造 💙，并借助 LLM 助力人们实现财务自主