azure-face

Provides expert guidance for Azure AI Face detection, identification, verification, and liveness development.

730|117|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/MicrosoftDocs/Agent-Skills --skill azure-face
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-face
Source: https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-face
Command: npx skills add https://github.com/MicrosoftDocs/Agent-Skills --skill azure-face

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers building with Azure AI Face often struggle to find the right guidance on error codes, model selection, quotas, security configuration, and API integration patterns scattered across documentation. This Skill consolidates that expert knowledge into categorized, fetchable references.

Core Features & Use Cases

  • Troubleshooting & Error Resolution: Diagnose Face API failures by interpreting error codes and applying recommended fixes for quota, authentication, and input issues.
  • Decision & Best Practices Guidance: Choose detection and recognition models, scale PersonGroup/PersonDirectory, optimize latency, and build consent-aware enrollment workflows.
  • Security & Integration Patterns: Configure abuse monitoring, token-based access, network isolation, CMK encryption, and call Face API endpoints for detect, identify, verify, and find-similar operations.
  • Use Case: When your face verification endpoint returns a cryptic error, ask the agent to look up the error code and get the cause plus resolution steps from official Microsoft Learn documentation.

Quick Start

Ask the agent to explain how to resolve a specific Azure Face API error code or how to choose between detection models for your application.

Frequently Asked Questions about azure-face

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Azure Face API error codes?

Azure Face API errors can be diagnosed by matching the returned error code to documented causes such as quota exhaustion, authentication failures, or invalid input. This Skill fetches the official error code reference from Microsoft Learn and applies the recommended resolution steps.

How to choose between Azure Face detection and recognition models?

Azure Face offers multiple detection and recognition models with different accuracy, capability, and latency trade-offs. The Skill provides decision guidance on specifying detection models and configuring recognition models based on your scenario requirements.

What are the Azure Face API quotas and limits?

Azure Face enforces quotas on rate limits, persons, faces per person, and training operations, with separate limits for PersonGroup and PersonDirectory. The Skill references the official quotas and limits documentation plus guidance on scaling to large face datasets.

Does Azure Face support liveness detection with network isolation?

Yes, Azure Face liveness detection supports network isolation configurations along with token-based access control and abuse monitoring. The Skill covers security setup including encryption with customer-managed keys and shared responsibility guidance.

When should I use PersonDirectory instead of PersonGroup?

PersonDirectory is designed for high-capacity face storage scenarios that exceed PersonGroup scaling limits. The Skill provides guidance on when to migrate to PersonDirectory and how to add many faces efficiently at scale.