使用说明
口袋妖怪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 - 启动后端服务器:API将于
python manage.py runserverhttp://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
- 目的: 根据自然语言描述(例如,“具有良好类型覆盖的进攻性团队”)生成一个口袋妖怪团队。
- 如何使用:
- 转到web UI中的“生成团队”部分。
- 在输入框中输入您的团队描述。
- 点击“生成”。
- AI将返回一个口袋妖怪团队,每个团队都有一个名字、角色和图像。
- API用法:
- 向发送POST请求
/api/agent/team/随着{ "description": "your team idea" }. - 在回复中收到结构化的团队建议。
- 向发送POST请求
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或神奇宝贝公司无关。