🛍️ 电子商务聊天机器人mcp
使用Chatbot系统支持客户 快速API, 谷歌双子座 耦合模式 MCP（模型上下文协议）.
🚀 安装
1.安装依赖项
执行
uv sync2.配置程序API密钥
创建新文件 .env 使用您的谷歌密钥API：
GOOGLE_API_KEY=tu_api_key_aqui获得者API密钥： https://makersuite.google.com/app/apikey
3.启动服务器
uvicorn main:app --reload服务器将位于： http://localhost:8000
______________________________________________________________________
📡 与邮递员一起使用
1. 向聊天机器人发送消息
发布 http://localhost:8000/chat
正文（JSON）：
{
"session_id": "usuario123",
"message": "¿Tienen zapatillas talle 40?"
}回答：
{
"session_id": "usuario123",
"response": "¡Sí! Tenemos 12 unidades de Zapatillas Deportivas en talle 40 disponibles por $15,000...",
"tool_calls": [
{
"tool": "consultar_stock",
"input": {"producto": "zapatillas", "talle": "40"},
"result": {"stock": 12, "precio": 15000, "disponible": true}
}
]
}______________________________________________________________________
2. 查看可用工具
获取 http://localhost:8000/tools
______________________________________________________________________
3. 查看活动会话
获取 http://localhost:8000/sessions
______________________________________________________________________
4. 清理会话
发布 http://localhost:8000/clear
正文（JSON）：
{
"session_id": "usuario123"
}______________________________________________________________________
🎯 可用的工具
| 工具 | 它做什么 |
|---|---|
consultar_stock | 验证产品的可用性 |
listar_productos | 显示整个目录 |
consultar_categorias | 列出可用类别 |
rastrear_pedido | 查询发货状态 |
explicar_politica_devolucion | 退货信息 |
consultar_info_plataforma | 付款信息，发货，联系方式 |
______________________________________________________________________
💬 信息示例
在Postman中测试这些消息：
- “你要吃什么？”
- “他们有什么产品？”
- “我的订单ORD-002在哪里？”
- “他们接受什么付款方式？”
- “我想退货”
______________________________________________________________________
📁 项目结构
📁 proyecto/
├── main.py # API principal
├── tools.py # Herramientas MCP
├── database.py # Datos simulados
├── prompts.py # Instrucciones del bot
├── .env # API key (no subir a git)______________________________________________________________________
🎓 它是如何工作的
- 用户发送消息 →Fastapi接收请求
- Gemini 分析 →决定是否需要使用工具
- 系统执行工具 → 查询库存、订单等
- 双子座产生反应 →根据获得的数据
- 用户接收响应 →自然而完整
______________________________________________________________________
这就是全部。 在Postman中安装、配置密钥API和测试。🚀