Chatbot bancario con integración MCP
Una sofisticada aplicación de chatbot bancario que utiliza Azure OpenAI y Model Context Protocol (MCP) para un manejo seguro y eficiente de mensajes.
Características
- Asistente bancario impulsado por IA : utiliza Azure OpenAI para proporcionar respuestas inteligentes a consultas bancarias
- Protocolo de contexto de modelo (MCP) : implementa un protocolo de comunicación de mensajes seguro
- Interfaz de chat en tiempo real : interfaz de usuario moderna y adaptable para una interacción fluida con el usuario
- Registro completo : sistema de registro detallado para monitoreo y depuración
- Integración de información bancaria : visualización dinámica de detalles y servicios bancarios
- Compatibilidad con Markdown : formato de texto enriquecido para respuestas
Estructura del proyecto
.
├── app.py # Main Flask application
├── mcp_server.py # MCP server implementation
├── mcp_client.py # MCP client implementation
├── requirements.txt # Python dependencies
├── .env # Environment variables
├── templates/ # HTML templates
│ └── index.html # Chat interface
└── logs/ # Log files
├── client_messages.log
├── mcp_client.log
└── mcp_server.log
Prerrequisitos
- Python 3.8 o superior
- Acceso a la API de Azure OpenAI
- Paquetes de Python necesarios (consulte requirements.txt)
Instalación
- Clonar el repositorio:
git clone <repository-url>
cd banking-chatbot
- Crear y activar un entorno virtual:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- Instalar dependencias:
pip install -r requirements.txt
- Crea un archivo
.env con tus credenciales:ENDPOINT_URL=your_azure_endpoint
AZURE_OPENAI_API_KEY=your_api_key
DEPLOYMENT_NAME=your_deployment_name
Uso
- Inicie el servidor MCP:
- En una nueva terminal, inicie la aplicación Flask:
- Acceda a la interfaz del chatbot en
http://localhost:5000
Protocolo MCP
El Protocolo de Contexto de Modelo (MCP) se implementa para gestionar la comunicación de mensajes entre el chatbot y el servidor. Proporciona:
- Transmisión segura de mensajes
- Colas de mensajes y confiabilidad
- Registro detallado
- Manejo de mensajes en tiempo real
Tipos de mensajes
- Mensajes de chat : consultas de usuarios y respuestas de IA
- Mensajes del sistema : Mensajes administrativos y de control
Explotación florestal
La aplicación mantiene registros detallados en el directorio logs :
client_messages.log : Historial de mensajes de chatmcp_client.log : registros de conexión y operación del clientemcp_server.log : registros de operaciones del servidor
El chatbot está configurado con información bancaria completa que incluye:
- Horario comercial
- Ubicaciones de sucursales
- Servicios disponibles
- Información del contacto
- Canales de soporte
Desarrollo
Añadiendo nuevas funciones
- Actualice el diccionario
BANK_INFO en app.py para obtener nueva información bancaria - Modificar
SYSTEM_MESSAGE para un comportamiento de IA actualizado - Agregue nuevos controladores de mensajes en
mcp_client.py para obtener funcionalidad adicional
Pruebas
Ejecute el cliente de prueba para verificar la funcionalidad de MCP:
Borrar registros para pruebas:
Seguridad
- Las claves API y la información confidencial se almacenan en
.env - MCP proporciona transmisión segura de mensajes
- Se implementan la validación de entrada y el manejo de errores.
Contribuyendo
- Bifurcar el repositorio
- Crear una rama de características
- Confirme sus cambios
- Empujar hacia la rama
- Crear una solicitud de extracción
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.