Views: 283 · Update time: 2025-12-29 21:56:51

この記事では、よくある問題、トラブルシューティングの手順、および利用可能なテクニカルサポートの範囲をまとめ、「キューが進まない、タスクが失敗する、配信が失敗する、請求が異常である」といった問題を迅速に特定するのに役立ちます。


I.よくある質問(FAQ)

1) サポートされているウェブサイトとコンテンツの種類は何ですか?

WPMLで管理される多言語コンテンツ(記事、ページ、WPMLでサポートされているカスタムコンテンツタイプなど)をサポートします(実際のサイト構成によります)。
翻訳タスクはWPMLキュー内のXLIFFタスクに基づいており、完了すると自動的にWPMLに返送されます。

2) 無料版と有料版の主な違いは何ですか?

  • 無料版:機械翻訳(MT)のみサポートされています。

  • 有料購読: LLM翻訳、選択可能なプロンプトテンプレートをサポート (b2b / b2c / tech_doc / creativeカスタムウェブサイトプロファイルプロンプトの設定をサポートし、ユーザーが独自のAPIキーを持ち込むことを可能にします(サブスクリプションクレジットを消費しません)。

3) LLM翻訳の料金はどのように請求されますか?費用が予想より少ない/多いのはなぜですか?

LLMは実際の入出力トークンに基づいて決済され、コストは選択されたモデルの単価に関連しています。
このシステムは翻訳可能なテキスト/ノードを抽出し、無効なコンテンツ(HTMLタグや構造など)を最小限に抑えるため、通常は「テキスト全体を直接翻訳する」よりも少ないトークンで済みます。
消費量が多い原因としては、重複コンテンツ、長い段落、大量の表示テキスト、または再試行回数の増加などが考えられます。最終的な消費量記録が決定的な指標として使用されます。

4) なぜタスクが失敗したのですか?失敗した場合、料金は発生しますか?

不具合は、以下の理由によって発生する可能性があります。

  • モデル出力が不安定、サーバー側のレート制限/タイムアウト

  • コンテンツ構造が複雑です(プレースホルダー、ネストされたタグ、異常なエンコーディング)。

  • 無効なAPIキー/残高不足/権限不足/地域制限

  • ネットワークエラーまたはサイトプッシュバック権限の不足

失敗したタスクでも部分的なコストが発生する場合があります(例えば、リクエストが送信され、部分的な結果が返された場合など)。その場合、決済はシステムに記録された実際のコストに基づいて行われます。

5) 組み込みのAPIキーを有効にした後も、購読料は引き落とされますか?

組み込みAPIキーを有効にすると、翻訳リクエストには組み込みキーが使用され、サブスクリプションクレジットは消費されません。料金は、サードパーティサービスプロバイダーによる組み込みキーの請求に含まれます。
システムは引き続き、タスク、ステータス、および消費量の詳細を記録します(照合およびトラブルシューティングのため)。

6) プロンプトテンプレートの選び方とは?カスタムウェブサイトプロフィールのプロンプトには何を含めるべきか?

  • b2b製品・ソリューション、企業向けサービスにおいて、プロ意識と厳格さを強く重視する。

  • b2c消費者志向で、自然と親しみやすさを重視している。

  • tech_doc技術文書/ヘルプセンター、正確性は一貫している

  • creativeマーケティング/クリエイティブコピーライティング、表現とスタイルに重点を置く

カスタムウェブサイトのプロフィールには、理想的には以下の内容を含めるべきです。

  • ブランドのトーン(簡潔/権威的/活気があるなど)

  • 対象顧客と製品の背景

  • 用語の好みと障害者表現

  • タイトル/ボタン/CTAのスタイル設定

7)用語集はありますか?

用語集機能は近日中にリリース予定です。最終バージョンは、機能ページの説明およびエンジンのサポート情報に基づいて決定されます。


II.トラブルシューティングガイド(症状に基づいて問題を素早く特定する)

症状A:WPMLキューにタスクが存在するが、タスクリストに表示されないか、処理されない。

優先順位チェック:

  1. サイトは正常に接続されましたか?「サイト管理」に移動して、ステータスが正常であることを確認してください。

  2. サイト認証/キーの有効期限が切れていますか?ドメイン名、HTTPS、またはキャッシュ戦略を変更した場合は、バインディングを再確認することをお勧めします。

  3. WPMLのキューは本当に「翻訳待ち」段階に入ったのでしょうか?タスクがキューに割り当てられており、他の翻訳サービスに引き継がれていないことを確認してください。

  4. サイトタスクがパッケージのサイト制限を超えましたか?制限を超えると、タスクが引き継がれない場合があります。

  5. システムには待ち行列による遅延がありますか?ピーク時には待ち時間が発生する場合があります。しばらくしてからタスクのステータスを更新してください。

それでも効果がない場合は、問題のあるタスクのタイムポイント、タスクID(またはタスクのタイトルと言語の組み合わせ)をエクスポートして、サポートチケットを送信してください。


症状B:タスクに「失敗/異常」と表示される。

チェック順:

  1. 失敗の原因を確認してください「翻訳タスク」でタスクの詳細を開き、エラーメッセージを記録してください。

  2. エンジンと権限を確認する

    • 無料パッケージ:LLMエンジンが選択されていないことを確認しました。

    • 組み込みのAPIキーが含まれています。キーの有効性、十分なクレジット限度額、および適切な権限を確認してください。

  3. 複雑さを軽減して再試行する

    • まず、機械翻訳を使用して、処理が成功したかどうかを確認してください。

    • LLMに切り替えて、より安定したプロンプトを使用してください(推奨)。tech_docまたはb2b

  4. コンテンツ構造の問題

    • コンテンツに多数のプレースホルダー、ショートコード、複雑なHTMLが含まれている場合は、ページを分割するか、1つのタスクで処理するコンテンツ量を減らすことをお勧めします。

  5. レート制限/タイムアウト

    • エンジン/モデルを交換する

    • 短期間に多くのタスクを提出することは避けてください。


症状C:翻訳は完了したがWPMLに反映されない/WPMLで結果が表示されない

主な検査項目:

  1. WPMLは書き戻し機能をサポートしていますか?サイトの権限設定とWPMLのステータスは正常ですか?

  2. サイトファイアウォール/WAF/セキュリティプラグインによるブロックこれは、コールバックインターフェースが傍受された場合によく発生します。

  3. キャッシュが原因で表示が遅れるページキャッシュ/オブジェクトキャッシュをクリアしてから再度お試しください。

  4. そのタスクは現在「審査待ち」の状態ですか?WPMLの一部のプロセスでは、公開前に手動による確認が必要です。


症状D:翻訳後に書式エラー、異常なタグ、プレースホルダーの欠落などが発生する。

推奨される対策:

  1. 切り替えを優先するtech_docプロンプトテンプレート

  2. カスタムWebサイトプロファイルプロンプトに制約を追加します。例:

    • 「すべてのプレースホルダー/変数/ショートコードは変更しないでください」

    • HTMLタグと属性は翻訳しないでください。

  3. 問題が一部のページでのみ発生する場合は、ページを分割するか、一度に翻訳するテキストブロックのサイズを小さくしてください。

  4. 問題が再現可能な場合は、元のページの種類と言語ペアを提供し、ロケーションサポートに提出してください。


症状E:請求額が予想と異なる/クレジット限度額が急激に減少する

検証手順:

  1. 「タスク消費の詳細」に存在するかどうかを確認してください。

    • 複数回の再試行は、追加のオーバーヘッドを発生させる。

    • 同じタスクの繰り返し実行

    • モデルの出力が長くなるほど、出力トークン数が増加します。

  2. 組み込みのAPIキーが有効になっているかどうか確認してください(組み込みキーはサブスクリプション料金を使用しませんが、サードパーティの請求額が増加する可能性があります)。

  3. 異常が疑われる場合は、「タスクID + 期間 + エンジン/モデル」を送信して検証を依頼してください。


III.利用可能な技術サポートの範囲

対応チャネル(ページへのアクセスを推奨します)

  • 作業指示書/メールによるサポート(推奨):障害のトラブルシューティング、ロールバック異常の処理、および料金の確認に使用します。

  • ドキュメントとよくある質問:一般的な設定、トラブルシューティング手順、ベストプラクティス

支援が受けられます

  • インストールとバインディングの問題のトラブルシューティング(サイト検証、権限、コールバックの失敗)

  • キューが処理されない場合/タスクが失敗した場合のトラブルシューティングと推奨事項

  • エンジン構成とプロンプトの使用に関する推奨事項(シナリオに応じて選択してください)

  • 取引詳細の検証および異常調査(タスク記録およびログに基づく)

サポート対象外です(詳細をご説明ください)。

  • お客様に代わってWPMLの設定またはサードパーティプラグインのコードを変更します

  • サードパーティのモデルプロバイダー(独自のAPIキーを持つ)からの請求に関する紛争および返金

  • サイトのセキュリティポリシー(ファイアウォールルールの無効化など)に抵触する強制的なバイパス。

Email
info@savantlook.com
Wechat
xxxiaoxiyy