Multi-Agent Custom Automation Engine Solution Accelerator部署常见问题与解决方案：新手也能轻松搞定

【免费下载链接】Multi-Agent-Custom-Automation-Engine-Solution-AcceleratorThe Multi-Agent Custom Automation Engine Solution Accelerator is an AI-driven system that manages a group of AI agents to accomplish tasks based on user input. Powered by Microsoft Agent Framework, Azure Foundry, Azure Cosmos DB, and infrastructure services, it provides a reference application, allowing you to hit the ground running.项目地址: https://gitcode.com/gh_mirrors/mu/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator

Multi-Agent Custom Automation Engine Solution Accelerator是一款由AI驱动的系统，它能管理一组AI代理，根据用户输入完成任务。该解决方案基于Microsoft Agent Framework、Azure Foundry、Azure Cosmos DB和基础设施服务构建，为用户提供了一个参考应用，让你能够快速上手。在部署过程中，新手用户可能会遇到各种问题，本文将为你详细介绍常见问题及解决方案，助你轻松完成部署。

部署前准备工作

在开始部署Multi-Agent Custom Automation Engine Solution Accelerator之前，做好充分的准备工作至关重要，这能有效减少后续部署过程中出现问题的概率。

检查Azure账户权限

确保你拥有一个Azure订阅，并且具有以下权限：

• Contributor（订阅级别）：用于创建和管理Azure资源。
• User Access Administrator（订阅级别）：管理用户访问和角色分配。
• Role Based Access Control Admin（订阅/资源组级别）：配置RBAC权限。
• App Registration Creation（Azure Active Directory）：创建和配置身份验证。

你可以按照以下步骤检查权限：

1. 进入Azure Portal。
2. 在顶部搜索栏搜索“subscriptions”，点击进入“Subscriptions”。
3. 选择你的目标订阅。
4. 在左侧菜单中点击Access control (IAM)。
5. 在下方的表格中查看你的 assigned roles，应包含上述提到的角色。

对于应用注册权限，可进入Microsoft Entra ID→Manage→App registrations，尝试点击New registration，若能访问该页面则表示拥有所需权限。详细设置可参考Azure Account Set Up。

确认服务可用性与配额

在部署前，需要确保你选择的Azure区域支持所有必要的服务，包括Azure AI Foundry、Azure OpenAI Service、Azure AI Search等。你可以通过Azure Products by Region查询服务可用性。推荐的部署区域有East US、East US2、Australia East等。

同时，检查Azure OpenAI配额也很重要。默认配额配置为GPT-4.1（150k tokens）、o4-mini（50k tokens）、GPT-4.1-mini（50k tokens）。你可以参考Quota Check Instructions进行检查，若配额不足，可按照Azure AI Model Quota Settings进行调整。

常见部署问题及解决方案

资源组相关问题

ResourceGroupNotFound（资源组不存在）

当出现此错误时，可能是因为指定的资源组不存在，或者使用了之前部署的.env文件。

解决方案：

• Option 1：进入Azure Portal，点击**"Resource groups"**选项，在搜索栏中搜索资源组，确认其是否存在。
• Option 2：若使用了旧的.env文件，可创建新环境后重新部署：azd env new <env-name>。

ResourceGroupBeingDeleted（资源组正在删除中）

当资源组正在删除时，无法对其进行操作。

解决方案：

1. 进入Azure Portal。
2. 进入资源组选项，搜索目标资源组。
3. 若资源组正在删除，需等待删除完成后，创建新的资源组或使用其他资源组进行部署。

配额与容量限制问题

InsufficientQuota（订阅配额不足）

此错误表示订阅中没有足够的配额来部署资源。

解决方案：

• 在部署前检查订阅中的可用配额，可参考quota_check文件了解详情。
• 若配额不足，可参考VM Quota Request申请更多配额。

SkuNotAvailable（请求的SKU在所选位置或区域不可用）

当选择的资源SKU（如VM大小）在目标位置或可用区不可用时，会出现此错误。在该部署中，跳转框VM默认为Standard_D2s_v5，虽然在大多数地区可用，但某些地区或区域可能不支持。

解决方案：

• 检查目标区域的SKU可用性：az vm list-skus --location <region> --size Standard_D2s --output table。
• 若默认SKU不可用，可覆盖VM大小：azd env set AZURE_ENV_VM_SIZE Standard_D2s_v4。
• 推荐的替代方案有Standard_D2s_v4、Standard_D2as_v5、Standard_D2s_v3等，注意避免使用不支持加速网络和Premium SSD的A系列VM。

配置与属性错误

InvalidRequestContent（部署包含无法识别或缺少必填值）

此错误意味着部署值包含无法识别的值或缺少必填值。

解决方案：

• 确认资源类型的部署值是否正确，可参考Invalid Request Content error文档。

Conflict - Local authentication is disabled（应用配置存储已禁用本地身份验证，但应用正在使用本地身份验证模式）

当Azure App Configuration存储已禁用本地身份验证（disableLocalAuth: true），但应用尝试使用连接字符串或访问密钥而非Azure AD/Managed Identity身份验证时，会出现此错误。

解决方案：

• Option 1（推荐）：更新应用以使用Managed Identity：

  from azure.identity import DefaultAzureCredential from azure.appconfiguration import AzureAppConfigurationClient credential = DefaultAzureCredential() client = AzureAppConfigurationClient( endpoint="https://your-appconfig.azconfig.io", credential=credential )

• Option 2（不推荐用于生产环境）：在Bicep/ARM模板中设置disableLocalAuth: false以重新启用本地身份验证。
• 确保Managed Identity已分配App Configuration Data Reader或App Configuration Data Owner角色。

容器部署问题

ContainerAppOperationError（容器镜像构建或部署问题）

此错误可能是由于容器镜像构建不当导致的。

解决方案：

• 参考Azure Container Registry (ACR) – Build & Push Guide中的解决步骤。

ContainerOperationFailure（容器镜像或存储资源不存在）

当操作失败是因为指定的容器资源不存在时，会出现此错误，可能涉及Azure Container Registry镜像或Azure Storage blob容器。

解决方案：

• 验证容器镜像是否存在：az acr repository show-tags --name <registry-name> --repository <image-name>。
• 检查部署中的镜像标签是否与注册表中的现有标签匹配。
• 验证存储容器是否存在：az storage container list --account-name <storage-account-name> --auth-mode login。
• 确保Container App的托管标识在容器注册表上具有AcrPull角色，在存储账户上具有Storage Blob Data Contributor角色。
• 若镜像缺失，按照ACR Build & Push Guide重建和推送容器镜像。
• 验证App Configuration中的APP_STORAGE_BLOB_URL和APP_STORAGE_QUEUE_URL是否指向正确的存储账户。

部署成功后的验证与测试

完成部署后，进行适当的验证和测试能确保应用正常运行。

获取应用URL

部署成功后，你可以通过以下步骤获取应用URL：

1. 打开Azure Portal。
2. 导航到你的资源组。
3. 找到Frontend App Service。
4. 复制Default domain。

部署成功的终端提示如下：

运行部署后脚本

部署完成后，需要运行部署后脚本来上传团队配置和示例数据：

• For Bash (Linux/macOS/WSL)：

  bash infra/scripts/selecting_team_config_and_data.sh

• For PowerShell (Windows)：

  infra\scripts\Selecting-Team-Config-And-Data.ps1

执行脚本后，系统会呈现可用的用例场景供选择，选择后相应的数据集和配置文件将上传到Azure环境。

测试应用

你可以按照以下快速测试步骤验证应用是否正常工作：

1. 使用获取到的URL访问应用。
2. 使用经过身份验证的账户登录。
3. 从步骤5.1中上传的可用场景中选择一个用例。
4. 提出与所选用例相关的示例问题。
5. 验证响应是否包含适当的多代理协作。
6. 在Azure门户中检查日志以确认后端处理情况。

详细的测试流程可参考Sample Workflow指南。

总结

Multi-Agent Custom Automation Engine Solution Accelerator的部署过程中可能会遇到各种问题，但只要按照本文介绍的方法进行准备和排查，新手也能轻松搞定。从部署前的权限和配额检查，到常见问题的解决方案，再到部署后的验证与测试，每一个环节都至关重要。希望本文能帮助你顺利完成部署，充分体验该解决方案带来的强大功能。如果在部署过程中遇到其他问题，可参考故障排除指南或查看支持指南获取更多帮助。

【免费下载链接】Multi-Agent-Custom-Automation-Engine-Solution-AcceleratorThe Multi-Agent Custom Automation Engine Solution Accelerator is an AI-driven system that manages a group of AI agents to accomplish tasks based on user input. Powered by Microsoft Agent Framework, Azure Foundry, Azure Cosmos DB, and infrastructure services, it provides a reference application, allowing you to hit the ground running.项目地址: https://gitcode.com/gh_mirrors/mu/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator