AI导哈

电商聊天机器人

一个使用FastAPI、Google Gemini和MCP模式的客户支持聊天机器人系统，适用于电商平台的客户服务。

  • by maximilianotraghetti
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 maximilianotraghetti/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"
}

🎯 可用的工具

工具 它做什么
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)

🎓 它是如何工作的

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

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

相关 MCP