集成MCP的多智能体语义内核系统
概述
一个基于语义内核构建的多智能体系统，能够智能地将查询路由到专门的智能体，并通过MCP服务器在HTTP上访问SQL数据库。
建筑
代理；经纪人
- 路由器代理 - 分析意图并将请求转至相应的专家
- SQL专家代理 - 通过MCP服务器执行数据库查询
- 数据分析师代理 - 分析SQL查询结果
- 网络搜索代理 - 使用Azure AI Foundry结合Bing Grounding进行网页搜索
- 答案创作代理 - 将所有代理的输出综合成连贯的响应
流量（或流动）
User Query → Router → [Specialist Agents] → Answer Composer → User项目结构
semantic-kernal/
├── src/
│ ├── agents/ # Individual agent modules
│ │ ├── router_agent.py
│ │ ├── sql_specialist_agent.py
│ │ ├── data_analyst_agent.py
│ │ ├── web_search_agent.py
│ │ └── answer_composer_agent.py
│ ├── plugins/ # Kernel plugins
│ │ ├── mcp_sql_plugin.py
│ │ └── bing_search_plugin.py
│ ├── mcp/ # MCP client implementation
│ │ └── http_client.py
│ ├── orchestration/ # Orchestration logic
│ │ └── agent_orchestrator.py
│ └── config/ # Configuration
│ └── settings.py
├── tests/ # Tests
├── main.py # Entry point
├── requirements.txt
└── .env.example安装说明
1. 安装依赖项
pip install -r requirements.txt2. 配置环境变量
复制 .env.example to .env 并填写您的凭据：
cp .env.example .env快速入门见 docs/CHECKLIST.md 翻译为中文是：文档/检查清单.md 进行引导式设置
详细指南:
- 快速参考 - 快速设置指南
- Azure AI Foundry 配置 - 完整的说明
所需配置：
- Azure OpenAI 端点和 API 密钥（用于 SQL 代理）
- Azure AI Foundry 端点和模型部署（用于网页搜索代理）
- 通过APIM网关和OAuth 2.0认证访问MCP服务器URL（用于数据库访问）
- （可选）Bing 接地连接（用于网页搜索功能）
3. 跑
python main.py文档
- 配置检查清单 - 分步骤指南：收集所有 .env 文件中的值
- MCP 认证 - 使用APIM设置Azure AD OAuth 2.0
- 快速入门指南 - 快速配置参考
- Azure AI Foundry 设置 - 完整的安装说明
- 配置更新摘要 - 这种设置中发生了什么变化
特点/功能
- ✅ 模块化代理设计（每个代理一个文件）
- ✅ 通过Azure API管理（APIM）在HTTP上进行MCP集成
- ✅ 使用 Azure AD 进行 OAuth 2.0 认证
- ✅ 通过MCP内省实现动态工具发现
- ✅ 为专家选择定制路由逻辑
- ✅ 配备Bing Grounding的Azure AI Foundry代理，用于网页搜索
- ✅ 答案构成以确保连贯回应
- ✅ 无需单独订阅Bing API
- ✅ 可扩展的架构，用于添加新代理
技术栈
- 框架语义内核（Python）
- LLMAzure OpenAI GPT-5（注：GPT-5并非已发布或官方确认的版本，仅为假设或未来可能的版本）
- 网络搜索代理带Bing Grounding的Azure AI Foundry代理
- 数据库Azure SQL Server（通过APIM上的MCP）
- 认证Azure AD OAuth 2.0
- API网关Azure API 管理（APIM）
- 编曲；管弦乐编排自定义路由与直接调用客服代表