README.md

metadata

title: Customer Support Chatbot
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.1.0
app_file: app.py
pinned: false
license: mit

Customer Support Chatbot

A prototype customer support chatbot for a computer products company, built with Gradio, OpenAI GPT-4o-mini, and MCP server integration.

Features

• Product Inquiries: Browse, search, and get details about products (no authentication required)
• Order Management: View and manage orders (requires authentication)
• Session Memory: Maintains conversation context within each session
• Authentication: Simple email/PIN authentication for order access

How to Use

Product Queries (No Authentication)

• "Show me monitors"
• "What products do you have?"
• "Tell me about product COM-0001"
• "Search for printers"

Order Queries (Requires Authentication)

• "Show my orders"
• "What's the status of my order?"
• "I want to place an order"

Authentication

To authenticate, include in your message:

email: your@email.com, pin: 1234

Test Customers

The following test customers are available:

• donaldgarcia@example.net / 7912
• michellejames@example.com / 1520
• laurahenderson@example.org / 1488
• spenceamanda@example.org / 2535
• glee@example.net / 4582
• williamsthomas@example.net / 4811
• justin78@example.net / 9279
• jason31@example.com / 1434
• samuel81@example.com / 4257
• williamleon@example.net / 9928

Architecture

• app.py: Gradio UI and session management
• agent.py: LLM agent with tool calling
• mcp_client.py: MCP server JSON-RPC client
• auth.py: Authentication handler
• memory.py: Session-based conversation memory
• config.py: Configuration management

Environment Variables

Set these in your HuggingFace Space settings:

• OPENAI_API_KEY: Your OpenAI API key
• MCP_SERVER_URL: MCP server URL (default: https://vipfapwm3x.us-east-1.awsapprunner.com/mcp)