azure-face

Azure AI Face 技能

此技能提供 Azure AI Face 方面的专家指导，涵盖故障排除、最佳实践、决策、限制和配额、安全性，以及集成和编码模式。它结合了本地快速参考内容与远程文档获取功能。

如何使用此技能

IMPORTANT for Agent：使用下方的类别索引查找相关章节。对于带有行号范围的类别（例如 L35-L120），使用 read_file 读取指定行。对于带有文件链接的类别（例如 [security.md](security.md)），使用 read_file 读取链接的参考文件

IMPORTANT for Agent：如果 metadata.generated_at 距今已超过 3 个月，请建议用户从仓库拉取最新版本。如果无法使用 mcp_microsoftdocs 工具，请建议用户安装该工具：安装指南

此技能需要网络访问权限才能获取文档内容：

• 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并附带查询字符串 from=learn-agent-skill。返回 Markdown。
• 备用：使用 fetch_webpage，并附带查询字符串 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别	行号	描述
故障排除	L34-L38	通过解读错误代码、了解原因（配额、身份验证、输入问题）并应用建议的解决方法，诊断和修复 Azure Face API 故障。
最佳实践	L39-L47	有关人脸注册、扩展 PersonGroup/PersonDirectory、优化性能/延迟，以及构建兼顾同意要求且支持高容量的 Azure Face 注册工作流的指导。
决策	L48-L53	有关选择、配置和调整 Azure Face 检测与识别模型的指导，包括模型类型、功能、参数及选择权衡。
限制和配额	L54-L59	如何为大型人脸数据集扩展 PersonGroup，以及了解 Face API 配额、速率限制，以及人员、人脸和训练操作的最大规模。
安全性	L60-L69	Face 和活体检测的安全性与合规性：滥用监控、基于令牌的访问控制、网络隔离、加密/CMK、共同责任，以及安全的 SDK 版本管理。
集成和编码模式	L70-L73	如何调用 Azure Face API 终结点、使用关键操作（检测、识别、验证、查找相似项），并在应用程序中构建请求和响应。

故障排除

主题	URL
使用错误代码解决 Azure Face API 错误	https://learn.microsoft.com/en-us/azure/ai-services/face/reference-face-error-codes

最佳实践

主题	URL
应用 Azure Face 注册的最佳实践	https://learn.microsoft.com/en-us/azure/ai-services/face/enrollment-overview
高效地向 PersonGroup 添加大量人脸	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/add-faces
优化 Azure Face 性能并降低延迟	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/mitigate-latency
使用 PersonDirectory 存储大量人脸	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/use-persondirectory
实现注重同意的 Face 注册应用	https://learn.microsoft.com/en-us/azure/ai-services/face/tutorials/build-enrollment-app

决策

主题	URL
选择并指定 Azure Face 检测模型	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/specify-detection-model
选择并配置 Azure Face 识别模型	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/specify-recognition-model

限制与配额

主题	URL
将 PersonGroup 对象扩展到大型 Face 数据集	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/use-large-scale
查看 Azure Face 服务配额和限制	https://learn.microsoft.com/en-us/azure/ai-services/face/identity-quotas-limits

安全性

主题	URL
为 Face 活体检测配置滥用监控	https://learn.microsoft.com/en-us/azure/ai-services/face/concept-liveness-abuse-monitoring
使用有限令牌管理 Face API 访问权限	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/identity-access-token
在网络隔离环境中使用 Face 活体检测	https://learn.microsoft.com/en-us/azure/ai-services/face/how-to/liveness-use-network-isolation
为 Azure Face 数据配置加密和 CMK	https://learn.microsoft.com/en-us/azure/ai-services/face/identity-encrypt-data-at-rest
使用共同责任模型保护 Face 活体检测解决方案	https://learn.microsoft.com/en-us/azure/ai-services/face/liveness-detection-shared-responsibility
管理活体检测客户端 SDK 版本以确保安全	https://learn.microsoft.com/en-us/azure/ai-services/face/sdk/understand-the-liveness-sdk-versions

集成与编码模式

主题	URL
使用 Azure Face API 终结点和操作	https://learn.microsoft.com/en-us/azure/ai-services/face/identity-api-reference