MCP Agent Ecommerce

🛍️ 电子商务聊天机器人mcp

使用Chatbot系统支持客户 快速API, 谷歌双子座 耦合模式 MCP（模型上下文协议）.

🚀 安装

1.安装依赖项

执行

uv sync

2.配置程序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"
}

______________________________________________________________________

🎯 可用的工具

______________________________________________________________________

💬 信息示例

在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)

______________________________________________________________________

🎓 它是如何工作的

1. 用户发送消息 →Fastapi接收请求
2. Gemini 分析 →决定是否需要使用工具
3. 系统执行工具 → 查询库存、订单等
4. 双子座产生反应 →根据获得的数据
5. 用户接收响应 →自然而完整

______________________________________________________________________

这就是全部。 在Postman中安装、配置密钥API和测试。🚀