azure-terminal-copilot

🚀 Azure 终端 Copilot

Azure 终端 Copilot 是一款基于 Python 的 Azure CLI 助手，借助强大的自然语言处理能力，利用 Azure MCP 服务器，为用户提供便捷的 Azure 命令操作体验。

🚀 快速开始

Azure 终端 Copilot 可帮助你通过自然语言与 Azure CLI 进行交互，以下是使用前的准备和操作步骤。

✨ 主要特性

• 基于 Python 开发，提供自然语言处理功能，便于用户使用自然语言生成 Azure 命令。
• 利用 Azure MCP 服务器，增强命令处理能力。

📦 安装指南

先决条件

• Python 3.11+（如 pyproject.toml 中所指定）
• Azure CLI 已安装并配置
• Ollama 已安装且下载了模型
• uv 用于 Python 包管理
• Azure MCP 服务器已安装并运行

安装步骤

1. 克隆仓库

   git clone https://github.com/yourusername/azure-terminal-copilot.git
   cd azure-terminal-copilot
   

2. 打开终端并启动 uv 环境

   uv venv
   

3. 使用 uv 安装包

   uv pip install .
   

4. 运行 Ollama 并记下其本地地址。
5. 运行 Azure MCP 服务器并记下其本地地址。
6. 将 .env-sample 文件重命名为 .env。
7. 我在其中提供了示例值，因此请确保根据您运行的本地 Ollama、Azure MCP 和使用的模型更新这些值。
8. 现在您可以运行 python main.py。

💻 使用示例

基础用法

一旦程序运行，你可以尝试以下操作：

1. 提供一个查询，如“列出所有我的资源组”，查看预期执行的命令是否被执行。
2. 尝试不同的模型，注意哪些模型表现更好。
3. 调整系统提示，思考如何改进它。

📚 详细文档

学习建议

• 提供一个查询，如“列出所有我的资源组”，观察预期执行的命令是否被执行。
• 尝试不同的模型，留意哪些模型表现更好。
• 调整系统提示，思考如何改进它。

故障排除

• 确保您的 Azure CLI 已登录，Azure MCP 使用该进行身份验证。

📄 许可证

此项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。