Azure Terminal Copilot

🚀 Azure 終端 Copilot

Azure 終端 Copilot 是一個基於 Python 的 Azure CLI 助手，藉助自然語言處理技術，能讓用戶以自然語言的方式生成 Azure 命令，其背後依託於 Azure MCP 服務器。

🚀 快速開始

Azure 終端 Copilot 是一款強大的工具，能幫助您更便捷地使用 Azure CLI。以下是使用前的準備工作和安裝步驟。

✨ 主要特性

• 支持自然語言處理，可將自然語言轉化為 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 文件。