azure-video-indexer

Original🇺🇸 English
Translated

Expert knowledge for Azure AI Video Indexer development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Video Indexer APIs/widgets, live camera indexing, custom speech/brand models, or Azure OpenAI integrations, and other Azure AI Video Indexer related development tasks. Not for Azure AI services (use microsoft-foundry-tools), Azure AI Vision (use azure-ai-vision).

7installs
Added on

NPX Install

npx skill4agent add microsoftdocs/agent-skills azure-video-indexer

Tags

Translated version includes tags in frontmatter

Azure AI Video Indexer Skill

This skill provides expert guidance for Azure AI Video Indexer. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120
), use
read_file
with the specified lines. For categories with file links (e.g.,
[security.md](security.md)
), use
read_file
on the linked reference file
IMPORTANT for Agent: If
metadata.generated_at
is more than 3 months old, suggest the user pull the latest version from the repository. If
mcp_microsoftdocs
tools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
  • Preferred: Use
    mcp_microsoftdocs:microsoft_docs_fetch
    with query string
    from=learn-agent-skill
    . Returns Markdown.
  • Fallback: Use
    fetch_webpage
    with query string
    from=learn-agent-skill&accept=text/markdown
    . Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L41Diagnosing and resolving issues when running Azure Video Indexer on Arc, including connectivity, deployment, configuration, and runtime troubleshooting steps.
Best PracticesL42-L49Guidance on using AI agents for live analysis, scaling Video Indexer, training custom speech models, and interpreting text-based emotion detection insights.
Decision MakingL50-L55Guidance on selecting the right Azure Video Indexer account type and designing multi-tenant setups, including isolation, scaling, and management strategies for multiple customers or apps.
Architecture & Design PatternsL56-L60Guidance on architecting disaster recovery and failover for Azure Video Indexer, including redundancy, regional failover, backup, and high-availability design considerations.
Limits & QuotasL61-L68Service limits, supported languages/capabilities, and how to use live camera indexing features like event summaries and viewing live recordings.
SecurityL69-L81Securing Video Indexer: roles and access control, restricted/limited features, custom person models, NSGs/service tags, private endpoints, and firewall-protected storage best practices.
ConfigurationL82-L99Configuring Video Indexer: custom models (brand, language, speech), transcripts and speakers, indexing/live presets, regions, monitoring, and advanced upload/search settings.
Integrations & Coding PatternsL100-L123Using Video Indexer APIs, widgets, and Logic Apps/Power Automate to extract, use, or redact insights (faces, objects, text, audio, topics) and integrate with Azure OpenAI.
DeploymentL124-L129Guides for deploying Azure Video Indexer using Arc extensions, ARM, and Bicep templates, including provisioning accounts and configuring infrastructure as code.

Troubleshooting

Best Practices

Decision Making

TopicURL
Choose between Azure Video Indexer account typeshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/accounts-overview
Choose multi-tenant management strategies for Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/manage-multiple-tenants

Architecture & Design Patterns

TopicURL
Design disaster recovery and failover for Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/video-indexer-disaster-recovery

Limits & Quotas

TopicURL
Review Azure Video Indexer support matrix and service limitshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/avi-support-matrix
Check language support and capabilities in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/language-support
Generate event summaries for live camera footagehttps://learn.microsoft.com/en-us/azure/azure-video-indexer/live-event-summary
View live camera recordings in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/live-watch-recordings

Security

TopicURL
Create Azure Video Indexer accounts with restricted face featureshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/create-account
Configure and use custom person models in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/customize-person-model-how-to
Request access to limited Azure Video Indexer featureshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/limited-access-features
Use NSGs and service tags to secure Video Indexer traffichttps://learn.microsoft.com/en-us/azure/azure-video-indexer/network-security
Configure private endpoints for Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/private-endpoint-how-to
Secure Azure Video Indexer with private endpointshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/private-endpoint-overview
Manage Video Indexer account access with built-in roleshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/restricted-viewer-role
Implement security baseline and best practices for Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/security-baseline-video-indexer
Secure Video Indexer with firewall-protected storage accountshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/storage-behind-firewall

Configuration

TopicURL
Customize brand detection models in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/customize-brands-model-how-to
Configure custom language models in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/customize-language-model-how-to
Create and manage custom speech models in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/customize-speech-model-how-to
Edit speaker identities in Azure Video Indexer transcriptshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/edit-speakers
Edit and manage transcriptions in Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/edit-transcript-lines-portal
Configure indexing options for Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/indexing-configuration-guide
Configure custom live AI insights presets in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/live-ai-insights-catalog
Configure areas of interest for live camera analysishttps://learn.microsoft.com/en-us/azure/azure-video-indexer/live-area-interest
Configure Azure Video Indexer real-time extensionshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/live-extension
Configure monitoring for Azure Video Indexer with Azure Monitorhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/monitor-video-indexer
Reference for Azure Video Indexer monitoring datahttps://learn.microsoft.com/en-us/azure/azure-video-indexer/monitor-video-indexer-data-reference
Configure region and location parameters for Video Indexer APIshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/regions
Upload and index media with advanced Video Indexer settingshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/upload-index-media
Search and filter video libraries in Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/video-indexer-search

Integrations & Coding Patterns

TopicURL
Retrieve audio effects detection insights via Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/audio-effects-detection-insight
Retrieve clapper board detection insights via Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/clapper-board-insight
Connect Azure Video Indexer accounts to Azure OpenAIhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/connect-azure-open-ai-task
Use digital patterns and color bars insights in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/digital-patterns-color-bars-insight
Retrieve face detection insights from Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/face-detection-insight
Redact faces in videos using Video Indexer APIhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/face-redaction-with-api
Access keyword extraction insights from Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/keywords-insight
Get labels identification insights from Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/labels-identification-insight
Integrate Video Indexer with Logic Apps and Power Automatehttps://learn.microsoft.com/en-us/azure/azure-video-indexer/logic-apps-connector-arm-accounts
Use named entities extraction insights in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/named-entities-insight
Access object detection insights from Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/object-detection-insight
Use observed people and matched faces insights in Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/observed-matched-people-insight
Enable featured clothing insights for observed peoplehttps://learn.microsoft.com/en-us/azure/azure-video-indexer/observed-people-featured-clothing
Get OCR insights from Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/ocr-insight
Access scene, shot, and keyframe detection insightshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/scene-shot-keyframe-detection-insight
Use Azure OpenAI text summarization with Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/text-summarization-task
Get topics inference insights from Azure Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/topics-inference-insight
Use transcription and translation insights from Video Indexerhttps://learn.microsoft.com/en-us/azure/azure-video-indexer/transcription-translation-lid-insight
Embed Azure Video Indexer widgets in applicationshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/video-indexer-embed-widgets
Use Azure Video Indexer REST API with paid accountshttps://learn.microsoft.com/en-us/azure/azure-video-indexer/video-indexer-use-apis

Deployment