azure-translator

Azure Translator スキル

このスキルでは、Azure Translator に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを網羅しています。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。

このスキルの使い方

エージェント向けの重要事項：関連するセクションは、以下のカテゴリインデックスを使って探してください。行番号の範囲が記載されたカテゴリ（例：L35-L120）では、指定された行を read_file で読み取ってください。ファイルへのリンクがあるカテゴリ（例：[security.md](security.md)）では、リンク先の参照ファイルを read_file で読み取ってください。

エージェント向けの重要事項：metadata.generated_at が3か月より前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocs ツールを利用できない場合は、インストールするようユーザーに提案してください：インストールガイド

このスキルでドキュメントの内容を取得するには、ネットワークアクセスが必要です。

• 推奨：from=learn-agent-skill をクエリ文字列に指定して、mcp_microsoftdocs:microsoft_docs_fetch を使用します。Markdown が返されます。
• フォールバック：from=learn-agent-skill&accept=text/markdown をクエリ文字列に指定して、fetch_webpage を使用します。Markdown が返されます。

カテゴリインデックス

カテゴリ	行	説明
トラブルシューティング	L36-L41	Azure Translator のエラーの診断と修正：コンテナーの起動時／実行時の問題、使用方法や FAQ に関する問題、既知のサービスのバグ、トラブルシューティングのための HTTP ステータスコード／エラーコードの解釈。
ベストプラクティス	L42-L51	トレーニングデータの準備、Custom Translator モデルのトレーニング、用語集の使用、信頼性の高いバッチドキュメントワークフローの構築、Azure Translator の運用ガイダンス／FAQ に関するベストプラクティス。
意思決定	L52-L61	Translator のモデル、リージョン、インフラストラクチャの選択、および Translator API のバージョンと Custom Translator プラットフォーム間の移行／アップグレードの計画と実施に関するガイド。
制限とクォータ	L62-L67	Azure Translator／Translator Pro で利用できる言語、ロケール、機能に加え、テキストとドキュメントのサイズ、レート、使用量の制限とクォータ。
セキュリティ	L68-L79	Azure Translator のセキュリティ保護：認証（キー、Entra ID、SAS、マネージド ID）、ファイアウォール／VNet アクセス、カスタマー マネージド キー、安全なデプロイ（Foundry Tools を含む）。
構成	L80-L101	Azure Translator の構成：リソースのセットアップ、コンテナー、Custom Translator プロジェクト、API パラメーター（translate／detect／dictionary）、タグ付け、不適切な表現のフィルター、アラインメント、翻字、使用状況の監視。
統合とコーディングパターン	L102-L141	テキスト、翻字、ドキュメント翻訳のための Translator REST／SDK API とコンテナーの呼び出し、ジョブ／ステータスの管理、形式、用語集、カスタム／適応型モデルや Power Automate フローとの統合方法。
デプロイ	L142-L145	Translator を Docker コンテナーとして実行する方法：ローカルまたはオンプレミスのインフラストラクチャでのセットアップ、構成、認証、環境変数、デプロイのベストプラクティス。

トラブルシューティング

トピック	URL
Azure Translator の既知の問題を診断して軽減する	https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/known-issues
Azure Translator の HTTP ステータスコードとエラーコードを解釈する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/status-response-codes

ベストプラクティス

トピック	URL
Custom Translator 用のトレーニングデータを準備してフィルター処理する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/data-filtering
Custom Translator のトレーニングドキュメントを準備してアップロードする	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-training-documents
適切なデータセットで Custom Translator モデルをトレーニングする	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/train-custom-model
Document translation で用語集を作成して適用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-glossaries
信頼性の高いエンドツーエンドのバッチドキュメント翻訳ワークフローを実装する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/end-to-end-batch-workflow
Azure Translator の運用ガイダンスと FAQ	https://learn.microsoft.com/en-us/azure/ai-services/translator/faq

意思決定

トピック	URL
Custom Translator モデルとベースライン Translator モデルを評価して比較する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/test-your-model
Custom Translator プラットフォームのアップグレードを計画して実施する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/platform-upgrade
Document Translation API 用のインフラストラクチャを選択して設定する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/prerequisites
Azure Translator のリージョンとエンドポイントを選択する	https://learn.microsoft.com/en-us/azure/ai-services/translator/region-support
Translator v3.0 から 2026-06-06 への移行を判断して実施する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-2026-06-06
Translator V2 から V3 へアプリケーションを移行する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/migrate-to-v3

制限とクォータ

トピック	URL
Azure Translator の言語と機能のサポート状況を確認する	https://learn.microsoft.com/en-us/azure/ai-services/translator/language-support
Azure Translator のテキストサービスとドキュメントサービスの制限	https://learn.microsoft.com/en-us/azure/ai-services/translator/service-limits

セキュリティ

トピック	URL
保存データを保護するために Azure Translator のカスタマー管理キーを設定する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/encrypt-data-at-rest
VNet サービスエンドポイントを使用して Custom Translator を保護する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/enable-vnet-service-endpoint
Document translation のストレージアクセス用に SAS トークンを作成する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-sas-tokens
Document translation のストレージアクセス用にマネージド ID を設定する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities
Translator の Microsoft Entra ID 認証を設定する	https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/microsoft-entra-id-auth
ファイアウォールで Azure Translator のアクセスを保護する	https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/use-firewalls
Foundry Tools で Azure Translator のデプロイを保護する	https://learn.microsoft.com/en-us/azure/ai-services/translator/secure-deployment
Azure Translator への要求を認証および承認する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/authentication

構成

トピック	URL
Azure Translator コンテナーのランタイム設定を構成する	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/configuration
Custom Translator でドキュメントの形式と命名規則を適用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/concepts/document-formats-naming-convention
Custom Translator のプロジェクトを構成、管理する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-project
Custom Translator のワークスペースを構成、管理する	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/create-manage-workspace
Azure Translator リソースを作成、構成する	https://learn.microsoft.com/en-us/azure/ai-services/translator/how-to/create-translator-resource
Azure のソブリンクラウド環境で Translator を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/reference/sovereign-clouds
Translator 2026-06-06 translate API のパラメーターを使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/translate-api
Azure Translator でコンテンツにタグを付け、翻訳を防止する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/prevent-translation
Azure Translator で動的辞書のマークアップを使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-dynamic-dictionary
Azure Translator で不適切な表現のフィルタリングを構成する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-profanity-filtering
Azure Translator の応答で単語のアラインメントを有効にする	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/word-alignment
Azure Monitor メトリックで Azure Translator の使用状況を監視する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/metrics
文の境界を判定するために Translator V3 BreakSentence メソッドを使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/break-sentence
言語を識別するために Translator V3 detect メソッドを呼び出す	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/detect
文脈に応じた用法を確認するために Translator V3 の辞書の例を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-examples
別の翻訳を確認するために Translator V3 の辞書検索を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/dictionary-lookup
Translator V3 translate メソッドのパラメーターを使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/translate
Translator V3 でスクリプトの音訳を構成する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/transliterate

統合とコーディングパターン

トピック	URL
Translator コンテナーにユーザー管理の用語集をデプロイする	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/deploy-user-managed-glossary
Translator コンテナーのドキュメント翻訳 API を呼び出す	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-document-parameters
Translator コンテナーのテキスト翻訳パラメーターを使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/translate-text-parameters
Translator コンテナーの翻字 API パラメーターを使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/transliterate-text-parameters
Custom Translator モデルを使用して Translator API を呼び出す	https://learn.microsoft.com/en-us/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model
Azure で非同期のバッチドキュメント翻訳を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/asynchronous
同期単一ファイルドキュメント翻訳 API を統合する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/quickstarts/synchronous
非同期ドキュメント翻訳ジョブをキャンセルする	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/cancel-translation
ジョブ内のすべてのドキュメントの状態を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-documents
REST 経由ですべてのドキュメント翻訳ジョブを一覧表示する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-all-translations
翻訳済みドキュメントの状態を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-document
特定の翻訳ジョブの状態を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-status-specific-translation
翻訳でサポートされているドキュメント形式を照会する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-document-formats
翻訳でサポートされている用語集形式を照会する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/get-supported-glossary-formats
Azure Document Translation の非同期 REST API を呼び出す	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-asynchronous
同期ドキュメント翻訳 REST エンドポイントを呼び出す	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/latest/rest-api/translate-synchronous
バッチドキュメント翻訳ジョブをキャンセルする	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/cancel-translation
Translator Document Translation でドキュメントの状態を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-document-status
翻訳ジョブ内のすべてのドキュメントの状態を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-documents-status
REST 経由でサポートされているドキュメント形式を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-document-formats
REST 経由でサポートされている用語集形式を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats
ドキュメント翻訳リクエストの状態を取得する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translation-status
REST 経由で翻訳ジョブと状態を一覧表示する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/get-translations-status
Document Translation REST API の操作を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/rest-api-guide
REST 経由でバッチドキュメント翻訳を開始する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/start-batch-translation
ドキュメント向けの同期テキスト翻訳 REST API を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/reference/translate-document
適応型カスタム翻訳（AdaptCT）API と統合する	https://learn.microsoft.com/en-us/azure/ai-services/translator/foundry/adaptive-custom-translation
Translator v3 コネクタでドキュメント翻訳フローを構築する	https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/document-translation-flow
Translator v3 コネクタを使用してテキスト翻訳フローを構成する	https://learn.microsoft.com/en-us/azure/ai-services/translator/solutions/connector/text-translator-flow
Azure Translator のテキスト翻訳 REST API を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/rest-api-guide
Azure Translator の transliterate REST メソッドを呼び出す	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/2026-06-06/transliterate-api
アプリで Azure Translator のニューラル辞書を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-neural-dictionary
コード例を使って Azure Translator REST API を使用する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/how-to/use-rest-api
SDK クライアントライブラリを介して Azure Translator と統合する	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/client-library-sdk
Azure Translator REST API をプログラムから呼び出す	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/quickstart/rest-api
Translator V3 API のパラメーターとリクエストスキーマ	https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/reference/v3/reference

デプロイ

トピック	URL
Docker で Azure Translator コンテナーをデプロイして実行する	https://learn.microsoft.com/en-us/azure/ai-services/translator/containers/install-run