AI语音酒店CRM系统

一个基于AI语音交互的智能酒店客户关系管理系统,提供实时语音交互、工作流自动化和知识管理等功能,适用于酒店客户服务和运营管理。

  • by BlazeWild
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 BlazeWild/Hotel-CRM

使用说明

酒店CRM-人工智能语音助手

一个由人工智能语音交互驱动的智能酒店客户关系管理系统。该项目结合了尖端技术,为酒店客人和员工创造了无缝的对话体验。

🌟 特性

  • 实时语音交互:由LiveKit提供支持,采用Google Gemini Live模型,实现自然、对话式人工智能
  • 视觉头像界面:与Tavus AI化身集成,进行视觉交流
  • 工作流程自动化:n8n MCP(模型上下文协议)服务器集成,用于复杂的业务逻辑
  • AI代理系统:用于处理酒店运营的定制代理架构
  • 知识管理:用于酒店信息和客户服务的内置KMS

🛠️ 技术

  • LiveKit 的:实时音频/视频通信基础设施
  • 谷歌Gemini Live:用于自然语言理解的高级AI模型
  • 塔武斯:人工智能驱动的化身生成和交互
  • n8n MCP服务器:工作流自动化和集成平台
  • python:代理系统的核心编程语言

📋 先决条件

  • Python 3.8或更高版本
  • LiveKit帐户和凭据
  • 谷歌人工智能API密钥
  • Tavus API账户
  • n8n MCP服务器实例

🚀 安装

  1. 克隆存储库:
git clone https://github.com/blazewild/Hotel-CRM.git
cd Hotel-CRM
  1. 安装依赖项:
pip install -r requirements.txt
  1. 配置环境变量:

    • 复制 .env.example 到 .env
    • 填写API密钥和凭据
  2. 运行服务器:

python server.py

⚙️ 配置

所有配置都通过环境变量进行管理。看 .env.example 对于所需变量:

  • LiveKit 的:连接URL、API密钥和机密
  • 谷歌人工智能:用于Gemini模型访问的API密钥
  • 塔武斯:API密钥、角色ID和副本ID
  • n8n:MCP服务器URL

📁 项目结构

Hotel-CRM/
├── agent.py           # Core agent logic
├── server.py          # Main server application
├── tools.py           # Agent tools and utilities
├── prompts.py         # AI prompts and templates
├── mcp_client/        # MCP client implementation
│   ├── agent_tools.py
│   ├── server.py
│   └── util.py
├── KMS/               # Knowledge Management System
│   └── logs/
├── test/              # Test files
└── requirements.txt   # Python dependencies

🎯 用例

  • 客人入住/退房协助
  • 客房服务请求
  • 酒店信息和设施
  • 预定管理
  • 礼宾服务
  • 自动化客户支持

🔒 安全

  • 所有敏感凭据都存储在 .env 文件(未提交到存储库)
  • API密钥应保持安全并定期轮换
  • 遵循生产部署的最佳实践

🤝 贡献

欢迎投稿!请随时提交拉取请求。

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

👤 作者

野火

🙏 致谢

  • LiveKit团队负责实时通信基础设施
  • 谷歌推出Gemini AI模型
  • Tavus用于化身技术
  • n8n工作流自动化工具社区