春节生肖 Agent（NY-Agent）

一个基于 LangChain + FastAPI 的春节主题智能体项目，提供春节祝福、红包金额、春联生成、生肖查询/运势、生肖知识问答、年夜饭菜单、抽签、拜年文案等功能，并带有简单 Web 页面。

线上页面

地址：https://ny-agent.onrender.com/

功能简介

• 智能模式：自然语言输入，自动识别意图并调用对应功能
• 随机春节祝福
• 红包金额 + 祝福语生成
• 春联生成（新春 / 事业 / 学业）
• 生肖查询（今年或指定年份）
• 生肖运势（事业 / 财运 / 感情 / 健康 / 综合）
• 生肖知识问答（顺序、三合、相冲等）
• 年夜饭菜单生成（人数、地区、预算、是否带寓意）
• 春节抽签（上上签 / 中签 / 下签）
• 拜年文案生成（对象、场景、风格）

项目结构

NY-Agent/
├── new_year_zodiac_agent.py   # 核心 Agent 与 CLI 菜单
├── web_app.py                 # FastAPI Web 服务
├── web/
│   └── index.html             # 简单前端页面
└── requirements.txt           # Python 依赖

运行环境

• Python 3.10+（建议 3.11/3.12）
• DashScope API Key（用于通义模型调用）

安装依赖

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Windows（PowerShell）：

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt

环境变量配置

本项目会从环境变量读取 DashScope Key：

• DASHSCOPE_API_KEY

macOS / Linux：

export DASHSCOPE_API_KEY="你的Key"

Windows（PowerShell）：

$env:DASHSCOPE_API_KEY="你的Key"

启动方式

1) 命令行模式（CLI）

python new_year_zodiac_agent.py

启动后会进入交互菜单，可直接选择各项春节相关功能。

2) Web 模式（FastAPI + 静态页面）

python web_app.py

默认监听：

• http://127.0.0.1:8001

打开首页即可使用前端页面。

Web API（简要）

GET /

• 返回前端页面 web/index.html

GET /api/functions

• 返回可用功能列表（用于前端动态渲染）

POST /api/run

• 执行指定功能

请求示例：

{
  "function_id": "smart_mode",
  "args": {
    "query": "给我写一段给客户的新年开工祝福，正式一点"
  }
}

返回示例：

{
  "ok": true,
  "result": "......",
  "duration_ms": 123
}

常见问题

1. 启动后调用失败 / 模型无响应

优先检查：

• DASHSCOPE_API_KEY 是否已设置
• 网络是否可以访问 DashScope 服务
• 依赖是否已正确安装（尤其是 langchain、dashscope）

2. 生肖年份判断和春节分界

项目中包含按春节分界的生肖处理逻辑；若提出“某年某月某日的生肖”类问题，结果会受农历换年日期影响。

说明

• 本项目主要用于学习和演示 LangChain 多工具/多功能 Agent 的实现方式。
• 输出内容包含随机性与模型生成结果，适合娱乐与参考，不作为严肃命理结论。