Azure认知搜索添加自定义技能集时无法识别Azure Function App

算力阿峰

2026-7-10

排查Azure Function App未在认知搜索技能集下拉中显示的问题

检查Function App定价层：必须使用高级（Premium）或专用（Dedicated）定价层，消费（Consumption）层的Function App因动态IP和冷启动特性，无法被认知搜索的技能集下拉列表识别。
确认区域一致性：Function App与认知搜索服务必须部署在同一Azure区域，跨区域资源不会出现在下拉列表中。
细化权限配置：除了基础读取权限，需确保搜索服务的系统分配托管标识被授予Function App的Microsoft.Web/sites/functions/read权限，且权限作用域直接指向目标Function App（而非仅资源组）。
检查触发器类型：只有配置了HTTP触发器的Function才能被识别为自定义Web API技能，其他触发器类型不会出现在列表中。
排查私有端点配置：若Function App启用了私有端点，需确保认知搜索服务在同一虚拟网络内，或已通过对等连接建立访问通路，否则下拉列表无法加载该资源。
验证资源可见性与用户权限：确认Function App未设置为隐藏资源，且当前登录Azure账户对该Function App拥有至少**读者（Reader）**权限——门户展示资源需要当前用户具备相应权限，仅搜索服务有权限不足以在下拉列表中显示。
确认Function App运行状态：确保Function App处于**运行（Running）**状态，已停止或已删除的资源不会被加载到列表中。