Azure AI 文档翻译 Python SDK

要解决什么问题

企业里常见需求是整批翻译合同、手册、报表，而不是逐段粘贴到通用翻译 API。Office、PDF、结构化 CSV/JSON 等格式一旦走纯文本管线，版式、表格和标记往往会丢。Azure AI Document Translation 面向 Blob 上的源文件做批量作业，并在目标语言侧尽量保留原格式。

技能如何帮你写客户端代码

本技能围绕 Azure AI Document Translation Python SDK 的组织方式，把鉴权、提交作业、轮询与结果处理串成可落地的调用路径：

• 鉴权：新代码优先用 DefaultAzureCredential（本地 Azure CLI / VS Code，云端托管标识）；遗留密钥部署才考虑 AzureKeyCredential。同步与异步客户端、以及异步凭据，都应放在 上下文管理器 里释放连接与令牌缓存。
• 存储与权限：源容器与目标容器必须是 Azure Blob Storage；SAS 按最小权限——源侧读/列出，目标侧写/列出；多目标语言时建议 每种语言独立目标容器。
• 作业生命周期：批量提交后通过 poller.status() 跟踪长任务；需要时可列出/查询单文档状态，并处理 文档级错误（不要只盯作业级成功）。
• 质量与并发：领域术语用 术语表（glossary）；高并发批量场景优先 异步客户端，且同一路径不要混用同步 azure.xxx 与 azure.xxx.aio。

支持的文档类型包括 DOCX、PDF、PPTX、XLSX、HTML、TXT、RTF，以及 CSV、TSV、JSON、XML、XLIFF 等；提交前应对照技能内格式表核对。

适用边界

这是 Python SDK 用法与 Azure 文档翻译服务约束 的编辑指引，不能替代你在 Azure 门户里创建 Translator 资源、配置 Blob 容器与网络策略。服务支持的语言列表以 Azure 官方为准；受监管环境里 Entra 迁移未完成时，密钥方式可能仍会出现，但新集成应默认走 Entra 审计链。