Multi-Agent Custom Automation Engine Solution Accelerator部署常见问题与解决方案：新手也能轻松搞定
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）：创建和配置身份验证。
你可以按照以下步骤检查权限：
- 进入Azure Portal。
- 在顶部搜索栏搜索“subscriptions”，点击进入“Subscriptions”。
- 选择你的目标订阅。
- 在左侧菜单中点击Access control (IAM)。
- 在下方的表格中查看你的 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（资源组正在删除中）
当资源组正在删除时，无法对其进行操作。
解决方案：
- 进入Azure Portal。
- 进入资源组选项，搜索目标资源组。
- 若资源组正在删除，需等待删除完成后，创建新的资源组或使用其他资源组进行部署。
配额与容量限制问题
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：
- 打开Azure Portal。
- 导航到你的资源组。
- 找到Frontend App Service。
- 复制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环境。
测试应用
你可以按照以下快速测试步骤验证应用是否正常工作：
- 使用获取到的URL访问应用。
- 使用经过身份验证的账户登录。
- 从步骤5.1中上传的可用场景中选择一个用例。
- 提出与所选用例相关的示例问题。
- 验证响应是否包含适当的多代理协作。
- 在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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考