Azure 文本翻译 Python 技能
为 Python 应用接入 Azure 实时文本翻译能力。
文档优先推荐 DefaultAzureCredential，说明了 API key 的遗留用途、环境变量和客户端资源清理，未见恶意行为或越权操作；但缺少输入文本敏感性、数据出境、服务端日志/保留、用户确认和失败回滚说明，因此未接近满分。
安装和同步/异步生命周期示例较完整，但主文档与 references 对请求参数和模型用法存在明显不一致，例如 translate 使用 body 字符串与 to，而参考文件使用 InputTextItem、to_language；方法表列出 detect 但没有示例。静态证据不足，按上限未超过10分，并因潜在不可运行路径扣分。
触发词、目标 SDK、主要翻译/转写/语言操作场景较清楚，也覆盖同步和异步；但未明确非适用边界、错误输入约束、配额/限流限制、区域可用性或中文使用说明，且依赖 Azure 远程服务，未说明中国大陆网络可达性，因此扣分。
具备名称、描述、MIT 许可、作者和版本字段，采用主文档加 references 的分层结构，并提供多个示例和能力索引；但没有该技能的变更记录、维护责任人/更新路径、依赖版本约束、FAQ 或系统化故障排查，且参考资料与主文档不一致，因此扣分。
能够覆盖常见文本翻译及若干高级操作，示例通常可直接作为起点；但 API 参数、输入模型和方法列表冲突，缺少生产级错误处理、重试、隐私处理和可验证输出，用户可能需要较多人工校正，故未超过静态评估上限7分并进一步扣分。
提供了具体代码、环境变量、能力索引和仓库级 CI/评估工作流，具备一定审计线索；但给定材料没有该技能对应的提交测试、运行结果或第三方交叉验证，CI 也未证明此技能关键路径，因此仅给有限静态证据分。
- 主文档与 references 使用了不一致的 SDK 调用签名和输入模型；在采用前应以该 revision 对应的官方 SDK API 文档和实际包版本核对。
- 示例未覆盖异常、限流、超时、重试、敏感文本处理、日志脱敏和成本控制。
- 翻译内容会发送到 Azure 远程服务；材料未说明数据保留、区域合规或中国大陆网络可达性。
- 方法表包含 detect，但未提供对应实现示例，且部分操作仅在 references 中说明。
它能做什么 & 适用场景
该技能指导开发者使用 Azure AI Text Translation SDK for Python。它覆盖文本翻译、脚本转写、语言检测、词典查询、句子边界识别和支持语言查询。示例同时涵盖同步与异步客户端，并建议使用 DefaultAzureCredential 和上下文管理器。适合已经使用 Azure Translator、需要在应用中处理多语言文本的 Python 开发者。
安装并使用 azure-ai-translation-text 包，创建 TextTranslationClient，调用 translate、transliterate、lookup_dictionary_entries、lookup_dictionary_examples、get_supported_languages 和 find_sentence_boundaries。它可将文本翻译为一个或多个目标语言，检测源语言，执行脚本转换，返回词典释义与示例，并支持 HTML、亵渎内容处理、词对齐和句子长度信息。
- Python 开发者需要将用户界面或应用文本实时翻译成一种或多种语言时。
- 多语言应用需要判断输入文本语言并获取检测置信度时。
- 应用需要把文本从一种书写系统转换为另一种脚本时。
- 学习、搜索或内容工具需要查询词语的替代翻译、词性和使用示例时。
- 高吞吐服务需要使用异步客户端批量处理文本时。
优缺点一览
- 覆盖翻译、转写、语言检测和词典操作。
- 提供同步和异步客户端示例。
- 明确建议使用 Entra ID 凭据和上下文管理器。
- 包含批处理、HTML、亵渎内容、词对齐和句子边界等选项。
- Token credential 认证要求自定义子域端点；全球端点通常需要 API 密钥和区域。
- 源材料没有给出 Python 版本、服务价格或配额的说明。
- 该技能本身是指导文件，不包含可直接运行的完整项目或独立测试套件。
如何安装
在 Agent Skills 兼容客户端中运行 npx skills add microsoft/skills，在安装向导中选择 azure-ai-translation-text-py。README 未提供该单个技能的独立安装命令。使用 SDK 时运行 pip install azure-ai-translation-text。
如何使用
向编码代理输入包含触发词的请求，例如“使用 TextTranslationClient 将文本翻译成西班牙语”或“用 Azure Translator 将拉丁字母转写为日文脚本”。代码应配置 AZURE_TRANSLATOR_ENDPOINT，并优先使用 DefaultAzureCredential；生产环境可设置 AZURE_TOKEN_CREDENTIALS=prod。使用 API 密钥时配置 AZURE_TRANSLATOR_KEY，并在全球端点场景配置 AZURE_TRANSLATOR_REGION。
对比同类
技能将 DefaultAzureCredential 作为新代码的首选，并保留 API 密钥认证作为既有部署的兼容路径。自定义子域端点支持令牌凭据；全球端点的常见 API 密钥配置需要区域。