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-AcceleratorMulti-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 CreationAzure 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.1150k tokens、o4-mini50k tokens、GPT-4.1-mini50k 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 Identityfrom azure.identity import DefaultAzureCredential from azure.appconfiguration import AzureAppConfigurationClient credential DefaultAzureCredential() client AzureAppConfigurationClient( endpointhttps://your-appconfig.azconfig.io, credentialcredential )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.shFor 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），仅供参考