[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6FCX3NJDB962D6XMXFCRKRY":3,"skill-same:01M6FCX3NJDB962D6XMXFCRKRY":53},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":26,"linkOnly":27,"markdownContent":28,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":6,"ownerDescription":37,"updatedAt":38,"install":39,"resources":52},"01M6FCX3NJDB962D6XMXFCRKRY","azure-ai-contentunderstanding-py",null,"ComeOnOliver\u002Fskillshub","ComeOnOliver","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F43215937?v=4","01M6E5JNFECJAAVFE0W7SMWWD2","Haoran Shu","01M6E5JNNDQS7AJZDYFQ8TPZCK",66,"MIT","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fmicrosoft\u002Fskills\u002Fazure-ai-contentunderstanding-py\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000016","图像与多媒体","SCENARIO","使用场景",[23,24,25],"azure ai","azure","azure ai contentunderstanding py","2026-11-10 10:12:30",false,"# Azure AI Content Understanding SDK for Python\n\nMultimodal AI service that extracts semantic content from documents, video, audio, and image files for RAG and automated workflows.\n\n## Installation\n\n```bash\npip install azure-ai-contentunderstanding\n```\n\n## Environment Variables\n\n```bash\nCONTENTUNDERSTANDING_ENDPOINT=https:\u002F\u002F\u003Cresource>.cognitiveservices.azure.com\u002F\n```\n\n## Authentication\n\n```python\nimport os\nfrom azure.ai.contentunderstanding import ContentUnderstandingClient\nfrom azure.identity import DefaultAzureCredential\n\nendpoint = os.environ[\"CONTENTUNDERSTANDING_ENDPOINT\"]\ncredential = DefaultAzureCredential()\nclient = ContentUnderstandingClient(endpoint=endpoint, credential=credential)\n```\n\n## Core Workflow\n\nContent Understanding operations are asynchronous long-running operations:\n\n1. **Begin Analysis** — Start the analysis operation with `begin_analyze()` (returns a poller)\n2. **Poll for Results** — Poll until analysis completes (SDK handles this with `.result()`)\n3. **Process Results** — Extract structured results from `AnalyzeResult.contents`\n\n## Prebuilt Analyzers\n\n| Analyzer | Content Type | Purpose |\n|----------|--------------|---------|\n| `prebuilt-documentSearch` | Documents | Extract markdown for RAG applications |\n| `prebuilt-imageSearch` | Images | Extract content from images |\n| `prebuilt-audioSearch` | Audio | Transcribe audio with timing |\n| `prebuilt-videoSearch` | Video | Extract frames, transcripts, summaries |\n| `prebuilt-invoice` | Documents | Extract invoice fields |\n\n## Analyze Document\n\n```python\nimport os\nfrom azure.ai.contentunderstanding import ContentUnderstandingClient\nfrom azure.ai.contentunderstanding.models import AnalyzeInput\nfrom azure.identity import DefaultAzureCredential\n\nendpoint = os.environ[\"CONTENTUNDERSTANDING_ENDPOINT\"]\nclient = ContentUnderstandingClient(\n    endpoint=endpoint,\n    credential=DefaultAzureCredential()\n)\n\n# Analyze document from URL\npoller = client.begin_analyze(\n    analyzer_id=\"prebuilt-documentSearch\",\n    inputs=[AnalyzeInput(url=\"https:\u002F\u002Fexample.com\u002Fdocument.pdf\")]\n)\n\nresult = poller.result()\n\n# Access markdown content (contents is a list)\ncontent = result.contents[0]\nprint(content.markdown)\n```\n\n## Access Document Content Details\n\n```python\nfrom azure.ai.contentunderstanding.models import MediaContentKind, DocumentContent\n\ncontent = result.contents[0]\nif content.kind == MediaContentKind.DOCUMENT:\n    document_content: DocumentContent = content  # type: ignore\n    print(document_content.start_page_number)\n```\n\n## Analyze Image\n\n```python\nfrom azure.ai.contentunderstanding.models import AnalyzeInput\n\npoller = client.begin_analyze(\n    analyzer_id=\"prebuilt-imageSearch\",\n    inputs=[AnalyzeInput(url=\"https:\u002F\u002Fexample.com\u002Fimage.jpg\")]\n)\nresult = poller.result()\ncontent = result.contents[0]\nprint(content.markdown)\n```\n\n## Analyze Video\n\n```python\nfrom azure.ai.contentunderstanding.models import AnalyzeInput\n\npoller = client.begin_analyze(\n    analyzer_id=\"prebuilt-videoSearch\",\n    inputs=[AnalyzeInput(url=\"https:\u002F\u002Fexample.com\u002Fvideo.mp4\")]\n)\n\nresult = poller.result()\n\n# Access video content (AudioVisualContent)\ncontent = result.contents[0]\n\n# Get transcript phrases with timing\nfor phrase in content.transcript_phrases:\n    print(f\"[{phrase.start_time} - {phrase.end_time}]: {phrase.text}\")\n\n# Get key frames (for video)\nfor frame in content.key_frames:\n    print(f\"Frame at {frame.time}: {frame.description}\")\n```\n\n## Analyze Audio\n\n```python\nfrom azure.ai.contentunderstanding.models import AnalyzeInput\n\npoller = client.begin_analyze(\n    analyzer_id=\"prebuilt-audioSearch\",\n    inputs=[AnalyzeInput(url=\"https:\u002F\u002Fexample.com\u002Faudio.mp3\")]\n)\n\nresult = poller.result()\n\n# Access audio transcript\ncontent = result.contents[0]\nfor phrase in content.transcript_phrases:\n    print(f\"[{phrase.start_time}] {phrase.text}\")\n```\n\n## Custom Analyzers\n\nCreate custom analyzers with field schemas for specialized extraction:\n\n```python\n# Create custom analyzer\nanalyzer = client.create_analyzer(\n    analyzer_id=\"my-invoice-analyzer\",\n    analyzer={\n        \"description\": \"Custom invoice analyzer\",\n        \"base_analyzer_id\": \"prebuilt-documentSearch\",\n        \"field_schema\": {\n            \"fields\": {\n                \"vendor_name\": {\"type\": \"string\"},\n                \"invoice_total\": {\"type\": \"number\"},\n                \"line_items\": {\n                    \"type\": \"array\",\n                    \"items\": {\n                        \"type\": \"object\",\n                        \"properties\": {\n                            \"description\": {\"type\": \"string\"},\n                            \"amount\": {\"type\": \"number\"}\n                        }\n                    }\n                }\n            }\n        }\n    }\n)\n\n# Use custom analyzer\nfrom azure.ai.contentunderstanding.models import AnalyzeInput\n\npoller = client.begin_analyze(\n    analyzer_id=\"my-invoice-analyzer\",\n    inputs=[AnalyzeInput(url=\"https:\u002F\u002Fexample.com\u002Finvoice.pdf\")]\n)\n\nresult = poller.result()\n\n# Access extracted fields\nprint(result.fields[\"vendor_name\"])\nprint(result.fields[\"invoice_total\"])\n```\n\n## Analyzer Management\n\n```python\n# List all analyzers\nanalyzers = client.list_analyzers()\nfor analyzer in analyzers:\n    print(f\"{analyzer.analyzer_id}: {analyzer.description}\")\n\n# Get specific analyzer\nanalyzer = client.get_analyzer(\"prebuilt-documentSearch\")\n\n# Delete custom analyzer\nclient.delete_analyzer(\"my-custom-analyzer\")\n```\n\n## Async Client\n\n```python\nimport asyncio\nimport os\nfrom azure.ai.contentunderstanding.aio import ContentUnderstandingClient\nfrom azure.ai.contentunderstanding.models import AnalyzeInput\nfrom azure.identity.aio import DefaultAzureCredential\n\nasync def analyze_document():\n    endpoint = os.environ[\"CONTENTUNDERSTANDING_ENDPOINT\"]\n    credential = DefaultAzureCredential()\n    \n    async with ContentUnderstandingClient(\n        endpoint=endpoint,\n        credential=credential\n    ) as client:\n        poller = await client.begin_analyze(\n            analyzer_id=\"prebuilt-documentSearch\",\n            inputs=[AnalyzeInput(url=\"https:\u002F\u002Fexample.com\u002Fdoc.pdf\")]\n        )\n        result = await poller.result()\n        content = result.contents[0]\n        return content.markdown\n\nasyncio.run(analyze_document())\n```\n\n## Content Types\n\n| Class | For | Provides |\n|-------|-----|----------|\n| `DocumentContent` | PDF, images, Office docs | Pages, tables, figures, paragraphs |\n| `AudioVisualContent` | Audio, video files | Transcript phrases, timing, key frames |\n\nBoth derive from `MediaContent` which provides basic info and markdown representation.\n\n## Model Imports\n\n```python\nfrom azure.ai.contentunderstanding.models import (\n    AnalyzeInput,\n    AnalyzeResult,\n    MediaContentKind,\n    DocumentContent,\n    AudioVisualContent,\n)\n```\n\n## Client Types\n\n| Client | Purpose |\n|--------|---------|\n| `ContentUnderstandingClient` | Sync client for all operations |\n| `ContentUnderstandingClient` (aio) | Async client for all operations |\n\n## Best Practices\n\n1. **Use `begin_analyze` with `AnalyzeInput`** — this is the correct method signature\n2. **Access results via `result.contents[0]`** — results are returned as a list\n3. **Use prebuilt analyzers** for common scenarios (document\u002Fimage\u002Faudio\u002Fvideo search)\n4. **Create custom analyzers** only for domain-specific field extraction\n5. **Use async client** for high-throughput scenarios with `azure.identity.aio` credentials\n6. **Handle long-running operations** — video\u002Faudio analysis can take minutes\n7. **Use URL sources** when possible to avoid upload overhead\n",{},"main","def8531e65114c0fca8fb8551c1871ee0eed705c","skills\u002Fmicrosoft\u002Fskills\u002Fazure-ai-contentunderstanding-py",24,"https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub","https:\u002F\u002Fskillshub.wtf","https:\u002F\u002Fgithub.com\u002FComeOnOliver","AI & Blockchain Engineer\r\n","2026-06-24 22:07:19",{"source":7,"skillName":5,"commands":40,"prompt":50,"zipAvailable":51},[41,44,47],{"tool":42,"command":43},"npx","npx skills add ComeOnOliver\u002Fskillshub --skill azure-ai-contentunderstanding-py",{"tool":45,"command":46},"bunx","bunx skills add ComeOnOliver\u002Fskillshub --skill azure-ai-contentunderstanding-py",{"tool":48,"command":49},"pnpm","pnpm dlx skills add ComeOnOliver\u002Fskillshub --skill azure-ai-contentunderstanding-py","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fmicrosoft\u002Fskills\u002Fazure-ai-contentunderstanding-py\u002FSKILL.md",true,[],[54,66,76,85,91,98],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":62,"publishedAt":26},"01M6FKJN13GMG4KY57J3QD8GY5","model-hierarchy-skill","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzscole\u002Fmodel-hierarchy-skill\u002Fmodel-hierarchy-skill\u002FSKILL.md",[59],{"categoryNo":60,"categoryName":61,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发",[63,64,65],"model","model hierarchy","model hierarchy skill",{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":72,"publishedAt":26},"01M6FKJJJ6GCAMR4PPPRD12M5X","zoom-mcp","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-mcp\u002FSKILL.md",[71],{"categoryNo":60,"categoryName":61,"taxonomyType":20,"taxonomyTypeDesc":21},[73,74,75],"MCP","zoom","zoom mcp",{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":26},"01M6FKJE3KYT3KPEZMEEHYKA6K","zoom-apps-sdk","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[82,83,84,74],"sdk","zoom apps sdk","apps",{"skillNo":86,"name":87,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":26},"01M6FKJ9EDH9Q5VWDF8HAJRSP0","windows","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwindows\u002FSKILL.md",[],[87],{"skillNo":92,"name":93,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":97,"publishedAt":26},"01M6FKJ666BEEFC3AE9GJ72Q93","whiteboard","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwhiteboard\u002FSKILL.md",[96],{"categoryNo":60,"categoryName":61,"taxonomyType":20,"taxonomyTypeDesc":21},[93],{"skillNo":99,"name":100,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":26},"01M6FKJ21WFCDGTJQ2Q91T9DVW","websockets","https:\u002F\u002Fgithub.com\u002FComeOnOliver\u002Fskillshub\u002Fblob\u002Fmain\u002Fskills\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[100]]