Azure AI 文本翻译 Python SDK

要解决什么问题

在应用里接入 Azure AI Translator 时，REST 端点、请求头（区域、Ocp-Apim-Subscription-Key）和批量参数容易写错；生产环境还要在 Entra 令牌凭据 与既有 密钥 + 全局端点 之间做选择。本技能围绕官方 Python SDK（azure-ai-translation-text）整理调用方式，让 Agent 能按场景写出可维护的翻译、检测与词典相关代码。

核心能力与用法要点

• 基础翻译：translate 支持单次请求多种目标语言；已知源语言时应显式传入，而不是完全依赖自动检测。
• 语言与书写系统：detect 做语言识别；transliterate 在书写系统间转换；find_sentence_boundaries 用于断句。
• 词典能力：lookup_dictionary_entries 查备选译法与释义；lookup_dictionary_examples 取用法示例。
• 元数据：get_supported_languages 结果适合缓存，列表不常变。
• 鉴权与客户端生命周期：新代码优先 DefaultAzureCredential（本地 Azure CLI / VS Code，云端托管标识）；生产可通过 AZURE_TOKEN_CREDENTIALS 收紧凭据链。令牌鉴权通常需要 自定义子域（https://<resource>.cognitiveservices.azure.com）；若只有全局端点 api.cognitive.microsofttranslator.com，需 密钥 + 区域（Ocp-Apim-Subscription-Region）。同步与异步（azure.*.aio）二选一并整条链路一致；客户端与异步凭据均用 上下文管理器（with / async with）释放连接与令牌缓存。
• 吞吐与质量：单次最多约 100 段文本批量翻译；高并发用异步客户端；HTML 内容用 text_type=html；需要词级对应时开启 alignment；按需配置 profanity 策略。

边界与注意点

技能聚焦 SDK 方法与 Azure 侧约束，不替代你在 Azure 门户中的资源创建、配额与计费配置。非核心场景与生产检查项见 SKILL 内 references/capabilities.md、references/non-hero-scenarios.md。