🤖 Dialogflow CX MCP Server 🚀
2025.04.04
2
Python对话服务AI 集成交流协作
mcp-server-conversation-agents 是一个基于 Model Control Protocol (MCP) 的服务，专为 Google Dialogflow CX 设计，旨在实现 AI 助手与 Google 高级对话平台之间的无缝集成。该服务提供了一套工具，使 AI 助手能够通过标准化协议与 Dialogflow CX 代理进行交互，处理对话管理、意图检测以及与 Google 强大的自然语言理解系统的接口。
View on GitHub
Overview
基本能力
产品定位
mcp-server-conversation-agents 是一个桥梁，连接 AI 助手和 Dialogflow CX，提供强大的对话能力。
核心功能
- 与 Dialogflow CX 的双向通信
- 意图检测和匹配能力
- 语音识别的音频处理
- Webhook 请求/响应处理
- 持久对话的会话管理
- 安全的 API 认证
适用场景
- AI 助手与 Dialogflow CX 的集成
- 语音识别和意图检测
- 会话管理和持久化
- 外部服务通过 Webhook 集成
工具列表
- initialize_dialogflow: 初始化 Dialogflow CX 客户端
- detect_intent: 从文本输入中检测意图
- detect_intent_from_audio: 从音频文件中检测意图
- match_intent: 匹配意图而不影响会话
- Webhook Handling: 解析和创建 Webhook 请求/响应
常见问题解答
- 如何配置 Dialogflow CX 的 API 密钥？
- 通过环境变量
DIALOGFLOW_API_KEY设置。 - 如何运行 Docker 容器？
- 使用命令
docker run -it dialogflow-cx-mcp。
使用教程
使用依赖
- Python 3.12+
- Google Cloud 项目（启用 Dialogflow CX）
- Dialogflow CX 代理
- Google 服务的 API 凭证
安装教程
使用 Docker
git clone https://github.com/Yash-Kavaiya/mcp-server-conversation-agents.git
cd mcp-server-conversation-agents
docker build -t dialogflow-cx-mcp .
docker run -it dialogflow-cx-mcp
手动安装
git clone https://github.com/Yash-Kavaiya/mcp-server-conversation-agents.git
cd mcp-server-conversation-agents
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -e .
调试方式
- 确保环境变量已设置：
bash export DIALOGFLOW_API_KEY=your_api_key export PROJECT_ID=your_project_id export LOCATION=your_location export AGENT_ID=your_agent_id - 使用
initialize_dialogflow初始化客户端。 - 使用
detect_intent或detect_intent_from_audio测试意图检测。