[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69ARNJFJ9TQGHAHBCX7JESV":3,"skill-same:01M69ARNJFJ9TQGHAHBCX7JESV":81},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":52,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M69ARNJFJ9TQGHAHBCX7JESV","azure-ai-translation-text-py",null,"Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications.\nTriggers: \"text translation\", \"translator\", \"translate text\", \"transliterate\", \"TextTranslationClient\".","microsoft\u002Fskills","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69AJYYW4E1RMSYCQDJ4FJSH",3204,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-python\u002Fskills\u002Fazure-ai-translation-text-py\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,9,37],"azure ai","azure","azure ai translation text py","ai translation","text","translation","for","sdk","ai-translation","dictionary","triggers","time","use","translator","applications","real-time","detection","lookup","translate","2026-11-10 10:12:30",false,"---\nname: azure-ai-translation-text-py\ndescription: |\n  Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications.\n  Triggers: \"text translation\", \"translator\", \"translate text\", \"transliterate\", \"TextTranslationClient\".\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: \"1.0.0\"\n  package: azure-ai-translation-text\n---\n\n# Azure AI Text Translation SDK for Python\n\nClient library for Azure AI Translator text translation service for real-time text translation, transliteration, and language operations.\n\n## Installation\n\n```bash\npip install azure-ai-translation-text\n```\n\n## Environment Variables\n\n```bash\nAZURE_TRANSLATOR_ENDPOINT=https:\u002F\u002F\u003Cresource>.cognitiveservices.azure.com  # Required for Entra ID auth (must be a custom subdomain endpoint)\nAZURE_TOKEN_CREDENTIALS=prod # Required only if DefaultAzureCredential is used in production\n# Only required for the legacy API-key auth path below:\nAZURE_TRANSLATOR_KEY=\u003Cyour-api-key>\nAZURE_TRANSLATOR_REGION=\u003Cyour-region>  # e.g., eastus, westus2; required when authenticating with a key against the global endpoint\n```\n\n## Authentication & Lifecycle\n\n> **? Two rules apply to every code sample below:**\n>\n> 1. **Prefer `DefaultAzureCredential`.** It works locally (Azure CLI \u002F VS Code \u002F Developer CLI) and in Azure (managed identity, workload identity) with no code change. Avoid connection strings, account\u002FAPI keys — they bypass Entra audit and rotation.\n>    - Local dev: `DefaultAzureCredential` works as-is.\n>    - Production: set `AZURE_TOKEN_CREDENTIALS=prod` (or `AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>`) to constrain the credential chain to production-safe credentials.\n> 2. **Wrap every client in a context manager** so HTTP transports, sockets, and token caches are released deterministically:\n>    - Sync: `with \u003CClient>(...) as client:`\n>    - Async: `async with \u003CClient>(...) as client:` **and** `async with DefaultAzureCredential() as credential:` (from `azure.identity.aio`)\n>\n> Snippets may abbreviate this setup, but production code should always follow both rules.\n\n```python\nimport os\nfrom azure.identity import DefaultAzureCredential, ManagedIdentityCredential\nfrom azure.ai.translation.text import TextTranslationClient\n\n# Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\ncredential = DefaultAzureCredential(require_envvar=True)\n# Or use a specific credential directly in production:\n# See https:\u002F\u002Flearn.microsoft.com\u002Fpython\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-python#credential-classes\n# credential = ManagedIdentityCredential()\n\nwith TextTranslationClient(\n    endpoint=os.environ[\"AZURE_TRANSLATOR_ENDPOINT\"],\n    credential=credential,\n) as client:\n    result = client.translate(body=[\"Hello, world!\"], to=[\"es\"])\n```\n\n### Legacy: API Key (existing keyed deployments)\n\nNew code should use `DefaultAzureCredential` above. The Translator service has two specifics that make API-key auth still common in existing deployments:\n\n- **Token-credential auth requires a custom subdomain endpoint** (`https:\u002F\u002F\u003Cresource>.cognitiveservices.azure.com`). If you only have the global endpoint (`https:\u002F\u002Fapi.cognitive.microsofttranslator.com`), you must either provision a custom subdomain or stay on the key-based path until you do.\n- **Key + region** is the canonical setup against the global endpoint. The region is sent as the `Ocp-Apim-Subscription-Region` header and is required whenever you use a multi-service or global Translator key.\n\n```python\nimport os\nfrom azure.core.credentials import AzureKeyCredential\nfrom azure.ai.translation.text import TextTranslationClient\n\n# Key + region against the global endpoint (most common keyed setup)\nwith TextTranslationClient(\n    credential=AzureKeyCredential(os.environ[\"AZURE_TRANSLATOR_KEY\"]),\n    region=os.environ[\"AZURE_TRANSLATOR_REGION\"],\n) as client:\n    result = client.translate(body=[\"Hello, world!\"], to=[\"es\"])\n\n# Key against a custom subdomain endpoint (no region required)\nwith TextTranslationClient(\n    endpoint=os.environ[\"AZURE_TRANSLATOR_ENDPOINT\"],\n    credential=AzureKeyCredential(os.environ[\"AZURE_TRANSLATOR_KEY\"]),\n) as client:\n    result = client.translate(body=[\"Hello, world!\"], to=[\"es\"])\n```\n\n## Basic Translation\n\n```python\n# Translate to a single language\nresult = client.translate(\n    body=[\"Hello, how are you?\", \"Welcome to Azure!\"],\n    to=[\"es\"]  # Spanish\n)\n\nfor item in result:\n    for translation in item.translations:\n        print(f\"Translated: {translation.text}\")\n        print(f\"Target language: {translation.to}\")\n```\n\n## Translate to Multiple Languages\n\n```python\nresult = client.translate(\n    body=[\"Hello, world!\"],\n    to=[\"es\", \"fr\", \"de\", \"ja\"]  # Spanish, French, German, Japanese\n)\n\nfor item in result:\n    print(f\"Source: {item.detected_language.language if item.detected_language else 'unknown'}\")\n    for translation in item.translations:\n        print(f\"  {translation.to}: {translation.text}\")\n```\n\n## Specify Source Language\n\n```python\nresult = client.translate(\n    body=[\"Bonjour le monde\"],\n    from_parameter=\"fr\",  # Source is French\n    to=[\"en\", \"es\"]\n)\n```\n\n## Language Detection\n\n```python\nresult = client.translate(\n    body=[\"Hola, como estas?\"],\n    to=[\"en\"]\n)\n\nfor item in result:\n    if item.detected_language:\n        print(f\"Detected language: {item.detected_language.language}\")\n        print(f\"Confidence: {item.detected_language.score:.2f}\")\n```\n\n## Transliteration\n\nConvert text from one script to another:\n\n```python\nresult = client.transliterate(\n    body=[\"konnichiwa\"],\n    language=\"ja\",\n    from_script=\"Latn\",  # From Latin script\n    to_script=\"Jpan\"      # To Japanese script\n)\n\nfor item in result:\n    print(f\"Transliterated: {item.text}\")\n    print(f\"Script: {item.script}\")\n```\n\n## Dictionary Lookup\n\nFind alternate translations and definitions:\n\n```python\nresult = client.lookup_dictionary_entries(\n    body=[\"fly\"],\n    from_parameter=\"en\",\n    to=\"es\"\n)\n\nfor item in result:\n    print(f\"Source: {item.normalized_source} ({item.display_source})\")\n    for translation in item.translations:\n        print(f\"  Translation: {translation.normalized_target}\")\n        print(f\"  Part of speech: {translation.pos_tag}\")\n        print(f\"  Confidence: {translation.confidence:.2f}\")\n```\n\n## Dictionary Examples\n\nGet usage examples for translations:\n\n```python\nfrom azure.ai.translation.text.models import DictionaryExampleTextItem\n\nresult = client.lookup_dictionary_examples(\n    body=[DictionaryExampleTextItem(text=\"fly\", translation=\"volar\")],\n    from_parameter=\"en\",\n    to=\"es\"\n)\n\nfor item in result:\n    for example in item.examples:\n        print(f\"Source: {example.source_prefix}{example.source_term}{example.source_suffix}\")\n        print(f\"Target: {example.target_prefix}{example.target_term}{example.target_suffix}\")\n```\n\n## Get Supported Languages\n\n```python\n# Get all supported languages\nlanguages = client.get_supported_languages()\n\n# Translation languages\nprint(\"Translation languages:\")\nfor code, lang in languages.translation.items():\n    print(f\"  {code}: {lang.name} ({lang.native_name})\")\n\n# Transliteration languages\nprint(\"\\nTransliteration languages:\")\nfor code, lang in languages.transliteration.items():\n    print(f\"  {code}: {lang.name}\")\n    for script in lang.scripts:\n        print(f\"    {script.code} -> {[t.code for t in script.to_scripts]}\")\n\n# Dictionary languages\nprint(\"\\nDictionary languages:\")\nfor code, lang in languages.dictionary.items():\n    print(f\"  {code}: {lang.name}\")\n```\n\n## Break Sentence\n\nIdentify sentence boundaries:\n\n```python\nresult = client.find_sentence_boundaries(\n    body=[\"Hello! How are you? I hope you are well.\"],\n    language=\"en\"\n)\n\nfor item in result:\n    print(f\"Sentence lengths: {item.sent_len}\")\n```\n\n## Translation Options\n\n```python\nresult = client.translate(\n    body=[\"Hello, world!\"],\n    to=[\"de\"],\n    text_type=\"html\",           # \"plain\" or \"html\"\n    profanity_action=\"Marked\",  # \"NoAction\", \"Deleted\", \"Marked\"\n    profanity_marker=\"Asterisk\", # \"Asterisk\", \"Tag\"\n    include_alignment=True,      # Include word alignment\n    include_sentence_length=True # Include sentence boundaries\n)\n\nfor item in result:\n    translation = item.translations[0]\n    print(f\"Translated: {translation.text}\")\n    if translation.alignment:\n        print(f\"Alignment: {translation.alignment.proj}\")\n    if translation.sent_len:\n        print(f\"Sentence lengths: {translation.sent_len.src_sent_len}\")\n```\n\n## Async Client\n\n```python\nfrom azure.ai.translation.text.aio import TextTranslationClient\nfrom azure.identity.aio import DefaultAzureCredential\n\nasync def translate_text():\n    async with DefaultAzureCredential() as credential:\n        async with TextTranslationClient(\n            credential=credential,\n            endpoint=endpoint,\n        ) as client:\n            result = await client.translate(\n                body=[\"Hello, world!\"],\n                to=[\"es\"]\n            )\n            print(result[0].translations[0].text)\n```\n\n## Client Methods\n\n| Method | Description |\n|--------|-------------|\n| `translate` | Translate text to one or more languages |\n| `transliterate` | Convert text between scripts |\n| `detect` | Detect language of text |\n| `find_sentence_boundaries` | Identify sentence boundaries |\n| `lookup_dictionary_entries` | Dictionary lookup for translations |\n| `lookup_dictionary_examples` | Get usage examples |\n| `get_supported_languages` | List supported languages |\n\n## Best Practices\n\n1. **Pick sync OR async and stay consistent.** Do not mix `azure.xxx` sync clients with `azure.xxx.aio` async clients in the same call path. Choose one mode per module.\n2. **Always use context managers for clients and async credentials.** Wrap every client in `with Client(...) as client:` (sync) or `async with Client(...) as client:` (async). For async `DefaultAzureCredential` from `azure.identity.aio`, also use `async with credential:` so tokens and transports are cleaned up.\n3. **Batch translations** — Send multiple texts in one request (up to 100)\n4. **Specify source language** when known to improve accuracy\n5. **Use async client** for high-throughput scenarios\n6. **Cache language list** — Supported languages don't change frequently\n7. **Handle profanity** appropriately for your application\n8. **Use html text_type** when translating HTML content\n9. **Include alignment** for applications needing word mapping\n\n## Reference Files\n\n| File | Contents |\n|------|----------|\n| [references\u002Fcapabilities.md](references\u002Fcapabilities.md) | Additional non-hero capabilities, operation-group coverage, and production checklists. |\n| [references\u002Fnon-hero-scenarios.md](references\u002Fnon-hero-scenarios.md) | Dedicated non-hero examples for secondary\u002Fadvanced scenarios. |\n","# Azure AI Text Translation SDK for Python\n\nClient library for Azure AI Translator text translation service for real-time text translation, transliteration, and language operations.\n\n## Installation\n\n```bash\npip install azure-ai-translation-text\n```\n\n## Environment Variables\n\n```bash\nAZURE_TRANSLATOR_ENDPOINT=https:\u002F\u002F\u003Cresource>.cognitiveservices.azure.com  # Required for Entra ID auth (must be a custom subdomain endpoint)\nAZURE_TOKEN_CREDENTIALS=prod # Required only if DefaultAzureCredential is used in production\n# Only required for the legacy API-key auth path below:\nAZURE_TRANSLATOR_KEY=\u003Cyour-api-key>\nAZURE_TRANSLATOR_REGION=\u003Cyour-region>  # e.g., eastus, westus2; required when authenticating with a key against the global endpoint\n```\n\n## Authentication & Lifecycle\n\n> **? Two rules apply to every code sample below:**\n>\n> 1. **Prefer `DefaultAzureCredential`.** It works locally (Azure CLI \u002F VS Code \u002F Developer CLI) and in Azure (managed identity, workload identity) with no code change. Avoid connection strings, account\u002FAPI keys — they bypass Entra audit and rotation.\n>    - Local dev: `DefaultAzureCredential` works as-is.\n>    - Production: set `AZURE_TOKEN_CREDENTIALS=prod` (or `AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>`) to constrain the credential chain to production-safe credentials.\n> 2. **Wrap every client in a context manager** so HTTP transports, sockets, and token caches are released deterministically:\n>    - Sync: `with \u003CClient>(...) as client:`\n>    - Async: `async with \u003CClient>(...) as client:` **and** `async with DefaultAzureCredential() as credential:` (from `azure.identity.aio`)\n>\n> Snippets may abbreviate this setup, but production code should always follow both rules.\n\n```python\nimport os\nfrom azure.identity import DefaultAzureCredential, ManagedIdentityCredential\nfrom azure.ai.translation.text import TextTranslationClient\n\n# Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\ncredential = DefaultAzureCredential(require_envvar=True)\n# Or use a specific credential directly in production:\n# See https:\u002F\u002Flearn.microsoft.com\u002Fpython\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-python#credential-classes\n# credential = ManagedIdentityCredential()\n\nwith TextTranslationClient(\n    endpoint=os.environ[\"AZURE_TRANSLATOR_ENDPOINT\"],\n    credential=credential,\n) as client:\n    result = client.translate(body=[\"Hello, world!\"], to=[\"es\"])\n```\n\n### Legacy: API Key (existing keyed deployments)\n\nNew code should use `DefaultAzureCredential` above. The Translator service has two specifics that make API-key auth still common in existing deployments:\n\n- **Token-credential auth requires a custom subdomain endpoint** (`https:\u002F\u002F\u003Cresource>.cognitiveservices.azure.com`). If you only have the global endpoint (`https:\u002F\u002Fapi.cognitive.microsofttranslator.com`), you must either provision a custom subdomain or stay on the key-based path until you do.\n- **Key + region** is the canonical setup against the global endpoint. The region is sent as the `Ocp-Apim-Subscription-Region` header and is required whenever you use a multi-service or global Translator key.\n\n```python\nimport os\nfrom azure.core.credentials import AzureKeyCredential\nfrom azure.ai.translation.text import TextTranslationClient\n\n# Key + region against the global endpoint (most common keyed setup)\nwith TextTranslationClient(\n    credential=AzureKeyCredential(os.environ[\"AZURE_TRANSLATOR_KEY\"]),\n    region=os.environ[\"AZURE_TRANSLATOR_REGION\"],\n) as client:\n    result = client.translate(body=[\"Hello, world!\"], to=[\"es\"])\n\n# Key against a custom subdomain endpoint (no region required)\nwith TextTranslationClient(\n    endpoint=os.environ[\"AZURE_TRANSLATOR_ENDPOINT\"],\n    credential=AzureKeyCredential(os.environ[\"AZURE_TRANSLATOR_KEY\"]),\n) as client:\n    result = client.translate(body=[\"Hello, world!\"], to=[\"es\"])\n```\n\n## Basic Translation\n\n```python\n# Translate to a single language\nresult = client.translate(\n    body=[\"Hello, how are you?\", \"Welcome to Azure!\"],\n    to=[\"es\"]  # Spanish\n)\n\nfor item in result:\n    for translation in item.translations:\n        print(f\"Translated: {translation.text}\")\n        print(f\"Target language: {translation.to}\")\n```\n\n## Translate to Multiple Languages\n\n```python\nresult = client.translate(\n    body=[\"Hello, world!\"],\n    to=[\"es\", \"fr\", \"de\", \"ja\"]  # Spanish, French, German, Japanese\n)\n\nfor item in result:\n    print(f\"Source: {item.detected_language.language if item.detected_language else 'unknown'}\")\n    for translation in item.translations:\n        print(f\"  {translation.to}: {translation.text}\")\n```\n\n## Specify Source Language\n\n```python\nresult = client.translate(\n    body=[\"Bonjour le monde\"],\n    from_parameter=\"fr\",  # Source is French\n    to=[\"en\", \"es\"]\n)\n```\n\n## Language Detection\n\n```python\nresult = client.translate(\n    body=[\"Hola, como estas?\"],\n    to=[\"en\"]\n)\n\nfor item in result:\n    if item.detected_language:\n        print(f\"Detected language: {item.detected_language.language}\")\n        print(f\"Confidence: {item.detected_language.score:.2f}\")\n```\n\n## Transliteration\n\nConvert text from one script to another:\n\n```python\nresult = client.transliterate(\n    body=[\"konnichiwa\"],\n    language=\"ja\",\n    from_script=\"Latn\",  # From Latin script\n    to_script=\"Jpan\"      # To Japanese script\n)\n\nfor item in result:\n    print(f\"Transliterated: {item.text}\")\n    print(f\"Script: {item.script}\")\n```\n\n## Dictionary Lookup\n\nFind alternate translations and definitions:\n\n```python\nresult = client.lookup_dictionary_entries(\n    body=[\"fly\"],\n    from_parameter=\"en\",\n    to=\"es\"\n)\n\nfor item in result:\n    print(f\"Source: {item.normalized_source} ({item.display_source})\")\n    for translation in item.translations:\n        print(f\"  Translation: {translation.normalized_target}\")\n        print(f\"  Part of speech: {translation.pos_tag}\")\n        print(f\"  Confidence: {translation.confidence:.2f}\")\n```\n\n## Dictionary Examples\n\nGet usage examples for translations:\n\n```python\nfrom azure.ai.translation.text.models import DictionaryExampleTextItem\n\nresult = client.lookup_dictionary_examples(\n    body=[DictionaryExampleTextItem(text=\"fly\", translation=\"volar\")],\n    from_parameter=\"en\",\n    to=\"es\"\n)\n\nfor item in result:\n    for example in item.examples:\n        print(f\"Source: {example.source_prefix}{example.source_term}{example.source_suffix}\")\n        print(f\"Target: {example.target_prefix}{example.target_term}{example.target_suffix}\")\n```\n\n## Get Supported Languages\n\n```python\n# Get all supported languages\nlanguages = client.get_supported_languages()\n\n# Translation languages\nprint(\"Translation languages:\")\nfor code, lang in languages.translation.items():\n    print(f\"  {code}: {lang.name} ({lang.native_name})\")\n\n# Transliteration languages\nprint(\"\\nTransliteration languages:\")\nfor code, lang in languages.transliteration.items():\n    print(f\"  {code}: {lang.name}\")\n    for script in lang.scripts:\n        print(f\"    {script.code} -> {[t.code for t in script.to_scripts]}\")\n\n# Dictionary languages\nprint(\"\\nDictionary languages:\")\nfor code, lang in languages.dictionary.items():\n    print(f\"  {code}: {lang.name}\")\n```\n\n## Break Sentence\n\nIdentify sentence boundaries:\n\n```python\nresult = client.find_sentence_boundaries(\n    body=[\"Hello! How are you? I hope you are well.\"],\n    language=\"en\"\n)\n\nfor item in result:\n    print(f\"Sentence lengths: {item.sent_len}\")\n```\n\n## Translation Options\n\n```python\nresult = client.translate(\n    body=[\"Hello, world!\"],\n    to=[\"de\"],\n    text_type=\"html\",           # \"plain\" or \"html\"\n    profanity_action=\"Marked\",  # \"NoAction\", \"Deleted\", \"Marked\"\n    profanity_marker=\"Asterisk\", # \"Asterisk\", \"Tag\"\n    include_alignment=True,      # Include word alignment\n    include_sentence_length=True # Include sentence boundaries\n)\n\nfor item in result:\n    translation = item.translations[0]\n    print(f\"Translated: {translation.text}\")\n    if translation.alignment:\n        print(f\"Alignment: {translation.alignment.proj}\")\n    if translation.sent_len:\n        print(f\"Sentence lengths: {translation.sent_len.src_sent_len}\")\n```\n\n## Async Client\n\n```python\nfrom azure.ai.translation.text.aio import TextTranslationClient\nfrom azure.identity.aio import DefaultAzureCredential\n\nasync def translate_text():\n    async with DefaultAzureCredential() as credential:\n        async with TextTranslationClient(\n            credential=credential,\n            endpoint=endpoint,\n        ) as client:\n            result = await client.translate(\n                body=[\"Hello, world!\"],\n                to=[\"es\"]\n            )\n            print(result[0].translations[0].text)\n```\n\n## Client Methods\n\n| Method | Description |\n|--------|-------------|\n| `translate` | Translate text to one or more languages |\n| `transliterate` | Convert text between scripts |\n| `detect` | Detect language of text |\n| `find_sentence_boundaries` | Identify sentence boundaries |\n| `lookup_dictionary_entries` | Dictionary lookup for translations |\n| `lookup_dictionary_examples` | Get usage examples |\n| `get_supported_languages` | List supported languages |\n\n## Best Practices\n\n1. **Pick sync OR async and stay consistent.** Do not mix `azure.xxx` sync clients with `azure.xxx.aio` async clients in the same call path. Choose one mode per module.\n2. **Always use context managers for clients and async credentials.** Wrap every client in `with Client(...) as client:` (sync) or `async with Client(...) as client:` (async). For async `DefaultAzureCredential` from `azure.identity.aio`, also use `async with credential:` so tokens and transports are cleaned up.\n3. **Batch translations** — Send multiple texts in one request (up to 100)\n4. **Specify source language** when known to improve accuracy\n5. **Use async client** for high-throughput scenarios\n6. **Cache language list** — Supported languages don't change frequently\n7. **Handle profanity** appropriately for your application\n8. **Use html text_type** when translating HTML content\n9. **Include alignment** for applications needing word mapping\n\n## Reference Files\n\n| File | Contents |\n|------|----------|\n| [references\u002Fcapabilities.md](references\u002Fcapabilities.md) | Additional non-hero capabilities, operation-group coverage, and production checklists. |\n| [references\u002Fnon-hero-scenarios.md](references\u002Fnon-hero-scenarios.md) | Dedicated non-hero examples for secondary\u002Fadvanced scenarios. |\n",{"name":5,"license":15,"metadata":43,"description":46},{"author":12,"package":44,"version":45},"azure-ai-translation-text","1.0.0","Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications.\nTriggers: \"text translation\", \"translator\", \"translate text\", \"transliterate\", \"TextTranslationClient\".\n","main","3f5b461b2314e01c400564051e92469114c5b68f",".github\u002Fplugins\u002Fazure-sdk-python\u002Fskills\u002Fazure-ai-translation-text-py",368,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills","https:\u002F\u002Fmicrosoft.github.io\u002Fskills\u002F","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-14 06:48:25",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add microsoft\u002Fskills --skill azure-ai-translation-text-py",{"tool":63,"command":64},"bunx","bunx skills add microsoft\u002Fskills --skill azure-ai-translation-text-py",{"tool":66,"command":67},"pnpm","pnpm dlx skills add microsoft\u002Fskills --skill azure-ai-translation-text-py","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-python\u002Fskills\u002Fazure-ai-translation-text-py\u002FSKILL.md",true,[71,77],{"path":72,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Fcapabilities.md","REFERENCE","参考文档",2235,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-python\u002Fskills\u002Fazure-ai-translation-text-py\u002Freferences\u002Fcapabilities.md",{"path":78,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Fnon-hero-scenarios.md",4683,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-python\u002Fskills\u002Fazure-ai-translation-text-py\u002Freferences\u002Fnon-hero-scenarios.md",[82,90,117,154,181,201],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":89},"01M741JBE1VH8A2Y3FXX2P7386","azure-advisor-cost-optimization","Analyze Azure Advisor Cost\u002FIdleResources findings and prevalidate deletion safety, including Service Groups. WHEN: \"find unused Azure resources\", \"what resources am I paying for but no longer using\", \"idle-resource savings\", \"historical idle-resource savings\", \"are these idle resources safe to delete\". Generic Cost, other subcategories, and cross-category requests use azure-advisor.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-advisor\u002Fskills\u002Fazure-advisor-cost-optimization\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":101,"publishedAt":38},"01M69B4JCRQV5SPXAFCKXQRV0H","skill-creator","Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fskill-creator\u002FSKILL.md",[96],{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[102,103,104,105,9,20,106,107,108,109,25,31,110,111,112,113,114,115,116],"skill creator","creator","ai coding agents","coding agents","foundry","microsoft foundry","coding","guide","Existing","services","new","when","sdks","with","ai coding",{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":133,"publishedAt":38},"01M69B4FD57V1MYKRWAJJECTZ7","podcast-generation","Generate AI-powered podcast-style audio narratives using Azure OpenAI's GPT Realtime Mini model via WebSocket. Use when building text-to-speech features, audio narrative generation, podcast creation from content, or integrating with Azure OpenAI Realtime API for real audio output. Covers full-stack implementation from React frontend to Python FastAPI backend with WebSocket streaming.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fpodcast-generation\u002FSKILL.md",[123,126,129,132],{"categoryNo":124,"categoryName":125,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":127,"categoryName":128,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":130,"categoryName":131,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},[134,135,136,137,20,138,139,140,141,142,143,144,145,146,147,113,148,149,23,150,151,152,153],"podcast generation","generation","podcast","frontend","azure openai","realtime","react","python","Audio","creation","model","fastapi backend","python fastapi","fastapi","api","streaming","narrative","stack","generate","features",{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":161,"publishedAt":38},"01M69B4CYPM5SESY5ZWEFDXEQZ","microsoft-docs","Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention \"docs.\" If the question is about understanding a concept rather than writing code, this is the right skill.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[160],{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},[162,9,163,164,165,166,167,20,168,169,170,171,172,173,174,175,25,176,60,177,31,178,179,180],"microsoft docs","docs","documentation","windows","official","cli","MCP","writing","power platform","mcp server","back","concept","power","platform","technology","question","learn mcp","learn","best practices",{"skillNo":182,"name":183,"nameZh":6,"description":184,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":185,"categories":186,"keywords":188,"publishedAt":38},"01M69B49C3YPD1ZJ3NC0HPCY58","mcp-builder","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP), Node\u002FTypeScript (MCP SDK), or C#\u002F.NET (Microsoft MCP SDK).","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmcp-builder\u002FSKILL.md",[187],{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},[189,168,190,191,26,9,141,192,193,144,194,113,195,196,197,109,198,199,25,200,31,115],"mcp builder","builder","llms","typescript","model context protocol","building mcp servers","node","integrate","Tools","context","fastmcp","mcp sdk",{"skillNo":202,"name":203,"nameZh":6,"description":204,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":205,"categories":206,"keywords":219,"publishedAt":38},"01M69B467A7CDMFQ0T6Q0ZA12Q","kql","KQL language expertise for writing correct, efficient Kusto Query Language queries. Covers syntax gotchas, join patterns, dynamic types, datetime pitfalls, regex patterns, serialization, memory management, result-size discipline, and advanced functions (geo, vector, graph). USE THIS SKILL whenever writing, debugging, or reviewing KQL queries — even simple ones — because the gotchas section prevents the most common errors that waste tool calls and cause expensive retry cascades. Trigger on: KQL, Kusto, ADX, Azure Data Explorer, Fabric Real-Time Intelligence, EventHouse, Log Analytics, log analysis, data exploration, time series, anomaly detection, summarize, where clause, join, extend, project, let statement, parse operator, extract function, any mention of pipe-forward query syntax.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fkql\u002FSKILL.md",[207,210,211,216],{"categoryNo":208,"categoryName":209,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},{"categoryNo":212,"categoryName":213,"taxonomyType":214,"taxonomyTypeDesc":215},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",{"categoryNo":217,"categoryName":218,"taxonomyType":214,"taxonomyTypeDesc":215},"01JBSEEDCAT000000000000036","内容创作者",[203,20,169,220,221,222,223,224,225,30,226,227,228,229,230,231,232,233,234,25,235,236,237],"analytics","memory","summarize","exploration","parse","project","vector","join","log","pipe","datetime","discipline","time series","regex","anomaly","section","tool","geo"]