Agent MCP Docs Qa

Microsoft Docs 问答助手

一个用……构建的Python代理 Microsoft 代理框架 那个使用官方方法回答问题的 Microsoft Learn MCP（Microsoft Certified Professional）服务器 用于文档检索。

特点

• ✅ 内置DevUI 带有聊天界面和追踪功能
• ✅ MCP工具集成 - 3种访问Microsoft文档的工具
• ✅ Azure OpenAI 或 Ollama - 选择您的大型语言模型（LLM）后端
• ✅ 实时文档 通过MCP来自Microsoft Learn
• ✅ 完全可观测性 使用Agent Framework进行追踪

快速入门

1. 安装uv

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

或者参见 紫外线（UV）安装指南

2. 安装依赖项

uv sync

3. 配置环境

copy .env.example .env

编辑 .env 并设置您的大型语言模型（LLM）提供商：

对于Azure OpenAI（推荐）：

MODEL_PROVIDER=azure
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
AZURE_OPENAI_KEY=your-api-key
AZURE_OPENAI_DEPLOYMENT=gpt-4

对于Ollama（本地）：

MODEL_PROVIDER=ollama
OLLAMA_URL=http://localhost:11434/v1
OLLAMA_MODEL=llama2

4. 跑

uv run python src/main.py

5. 使用

代理框架DevUI 将自动在 http://127.0.0.1:8000 打开

开始聊天并询问有关微软技术的问题吧！

它是如何工作的

1. 用户提出问题 通过Agent Framework DevUI
2. 代理评估可用工具 并决定调用哪个MCP工具
3. MCP工具检索文档 来自 https://learn.microsoft.com/api/mcp
4. 代理处理上下文 并使用大型语言模型（LLM）生成答案
5. 用户看到了答案 完全追踪工具调用

可用的MCP工具

该代理可以访问三种Microsoft Learn MCP工具：

1. 微软文档搜索 - 搜索 Microsoft/Azure 文档

- 从 Microsoft Learn 返回相关的内容片段

1. Microsoft文档获取 - 获取完整的文档页面

- 从特定的 Microsoft Learn URL 获取完整内容

1. Microsoft 代码样本搜索 - 查找代码示例

- 搜索代码片段，并可选择语言过滤

所有工具均连接至官方的 Microsoft Learn MCP 服务器，地址为 https://learn.microsoft.com/api/mcp

项目结构

agent-mcp-docs-qa/
├── src/
│   └── main.py          # Main application with agent & MCP tools
├── pyproject.toml       # uv project configuration & dependencies
├── uv.lock             # Locked dependencies
├── .env                # Environment configuration (create from .env.example)
├── .env.example        # Environment template
└── README.md           # This file

关键依赖项

• 代理框架 - Microsoft的Agent框架，内置DevUI
• mcp的中文翻译是“最小化”或“最小化窗口”，在计算机操作中通常指将当前窗口缩小到任务栏或屏幕角落，使其不遮挡其他界面元素，同时保持程序在后台运行 - 官方模型上下文协议Python客户端
• Azure 身份 - Azure 认证
• python-dotenv - 环境变量管理

示例问题

试着问：

• “什么是Azure Functions？”
• “如何使用 Azure CLI 创建容器应用？”
• “给我展示一下用于Azure OpenAI聊天完成功能的Python代码”
• “ASP.NET Core 认证的最佳实践是什么？”
• “解释Azure AI Foundry评估SDK”

追踪

Agent Framework 内置的追踪显示：

• 📊 代币使用情况和成本
• 🔧 带参数的工具调用及响应
• ⏱️ 每个步骤的执行时间
• 🔄 完整对话流程

在DevUI的追踪查看器中进行访问追踪。

参考文献

• Microsoft 代理框架
• Microsoft Learn MCP 服务器
• 模型上下文协议
• 代理框架与MCP（管理控制平面/中间件控制平台）集成

许可证

麻省理工学院（MIT）