口袋妖怪AI演示
一个全方位的应用程序,用于探索神奇宝贝数据、比较神奇宝贝、建议计数器以及使用AI生成团队。该系统具有Django REST API后端和React/MUI前端。
______________________________________________________________________
目录
______________________________________________________________________
系统设置和部署
先决条件
- Python 3.8+ (用于后端)
- Node.js 16+和npm (前端)
- 点 (Python包管理器)
后端设置(Django/DRF)
- 导航到后端目录:
cd mcp_server- 安装依赖项:
pip install -r requirements.txt- 运行迁移:
python manage.py migrate- 启动后端服务器:
python manage.py runserverAPI将于 http://127.0.0.1:8000/api/.
前端设置(反应/MUI)
- 导航到前端目录:
cd mcp_frontend- 安装依赖项:
npm install
npm install @mui/material @emotion/react @emotion/styled
npm install @mui/icons-material
- 启动前端服务器:
npm start该应用程序将在 http://localhost:5173/.
- 自动启动应用程序-
在终端运行命令start.bat(适用于windows)
start.sh for(linux发行版)
环境变量
- 默认情况下,前端期望后端处于
http://127.0.0.1:8000/api/agent/.调整API_BASE在……里面mcp_frontend/src/App.jsx如果需要的话。
______________________________________________________________________
dotenv结构(.env)
- 在mcpserver文件夹中创建.env文件
- 内容-
" POKE_API_URL=“https://pokeapi.co/api/v2/" GOOGLE_API_KEY=“您的API密钥” "
______________________________________________________________________
可用模块及其使用
后端暴露了四个主要端点:
- 神奇宝贝信息 (
POST /api/agent/pokemon-info/)
- 输入: { "name": "pikachu" } - 输出:基本信息、统计数据、能力、动作、进化和风味文本。
- 比较 Pokémon (
POST /api/agent/compare/)
- 输入: { "pokemon1": "pikachu", "pokemon2": "bulbasaur" } - 输出:统计比较、类型优势、共享/独特能力。
- 建议计数器 (
POST /api/agent/strategy/)
- 输入: { "name": "charizard" } - 输出:弱点和推荐的对策宝可梦。
- 队伍编辑器 (
POST /api/agent/team/)
- 输入: { "description": "balanced team with fire and water types" } - 输出:人工智能生成的带有角色和图像的团队。
______________________________________________________________________
如何使用Team Builder
- 目的: 根据自然语言描述(例如,“具有良好类型覆盖的进攻性团队”)生成一个口袋妖怪团队。
- 如何使用:
1. 转到web UI中的“生成团队”部分。 1. 在输入框中输入您的团队描述。 1. 点击“生成”。 1. AI将返回一个口袋妖怪团队,每个团队都有一个名字、角色和图像。
- API用法:
- 向发送POST请求 /api/agent/team/ 随着 { "description": "your team idea" }. - 在回复中收到结构化的团队建议。
______________________________________________________________________
Web界面详解
web应用程序分为四个主要卡片:
- 搜寻宝可梦
- 输入宝可梦名称以查看其属性、类型、能力、移动、进化链和风味文本。
- 比较两个神奇宝贝
- 输入两个宝可梦名称,并排比较它们的属性、类型优势和能力。
- 建议计数器
- 输入宝可梦名称,查看其弱点和建议的对策。
- 组建团队
- 描述你想要的团队,并获得一个由人工智能生成的团队,其中包含角色和图像。
每个部分都提供即时反馈、加载指示器和错误消息,以获得流畅的用户体验。
______________________________________________________________________
代理集成说明
您可以将外部代理或脚本与后端API集成。示例用法:
- Python示例:
import requests
response = requests.post('http://127.0.0.1:8000/api/agent/pokemon-info/', json={"name": "pikachu"})
print(response.json())- 终点:
- /api/agent/pokemon-info/ (职位) - /api/agent/compare/ (职位) - /api/agent/strategy/ (职位) - /api/agent/team/ (职位)
- 请求/响应格式: 所有端点都接受并返回JSON。
______________________________________________________________________
许可证
本项目用于教育/演示目的,与任天堂、Game Freak或神奇宝贝公司无关。
