トラブルシューティング

このページでは、Solution Designer の使用時に発生する一般的な問題の解決方法を紹介します。

自動保存の問題

自動保存が繰り返し失敗する

自動保存が繰り返し失敗する場合や、エラー状態が表示される場合：

• 権限を確認する： ダイアグラムリソースの編集権限があることを確認します。ヘッダーのリソース名を選択して権限を表示します。
• 手動で保存する： ヘッダーで保存を選択して、ダイアグラムを手動で保存してみます。手動保存にも失敗する場合は、エラーメッセージを記録し、Foundry 管理者にお問い合わせください。
• 接続を確認する： 自動保存には Foundry バックエンドへの接続が必要なため、ネットワーク接続が安定していることを確認してください。
• ダイアグラムを再読み込みする： ダイアグラムを閉じて再度開きます。再読み込み後に自動保存が復旧する場合があります。
• バックアップとしてエクスポートする： 保存できない場合は、データの消失を防ぐためにダイアグラムを JSON ファイルとしてエクスポートしてから、Foundry 管理者にお問い合わせください。

保存時の競合

ダイアグラムの保存時に競合解決ダイアログが表示される場合：

• 同時に編集しているユーザーがいないか確認する： 別のユーザーがダイアグラムを同時に編集している可能性があります。競合を避けるため、共有ダイアグラムを編集する前にチームメンバーと調整してください。
• 変更を確認する： ご自身の変更をサーバー上のバージョンと比較します。
• オプションを選択してください：
  • 自分の変更を保持する： ご自身の変更でサーバー上のバージョンを上書きします。
  • サーバーの変更を保持する： ご自身の変更を破棄し、サーバー上のバージョンを読み込みます。
  • キャンセル： 保存操作を終了し、変更を手動でマージします。

AIP 機能

AIP Architect または AIP Critic が利用できない

Solution Designer に AIP 機能が表示されない場合：

• AIP のステータスを確認する： AIP 機能がお使いのエンロールメントで有効になっている必要があります。利用をご希望の場合は、Foundry 管理者にお問い合わせください。
• モデルの利用可否を確認する： Foundry 管理者が Model Catalog で、サポートされている LLM を1つ以上設定している必要があります。
• ブラウザーの互換性を確認する： サポートされているブラウザーを使用していることを確認してください。現在、Chrome、Edge、Firefox、Safari がサポートされています。

モデル選択に利用可能なモデルが表示されない

AI モデルの選択ドロップダウンが空の場合：

• Language Model Service が利用できない可能性がある： Language Model Service が設定されていないか、一時的に利用できない可能性があります。Foundry 管理者に問い合わせて、サポートされている LLM が1つ以上設定され、利用可能であることを確認してください。
• 権限を確認する： 言語モデルへのアクセス権限がない可能性があります。Foundry 管理者にお問い合わせください。

画像からダイアグラムへの変換が無効になっている

ダイアグラムに変換する画像をアップロードできない場合：

• 画像認識に対応したモデルにアクセスできることを確認する： 画像の変換には、画像認識に対応したモデル（GPT-4o など）が必要です。画像をアップロードモーダルのモデルドロップダウンメニューで、画像認識に対応したモデルが利用可能で、選択されていることを確認します。

AIP Architect の候補が不正確に見える

AIP Architect の候補が要件に合わない場合：

• ワークフローの概要を具体化する： ワークフローの概要を編集し、要件、制約、または希望するアプローチについて、より具体的な詳細を入力します。
• 異なる実装を試す： 提示された実装パターンを複数プレビューしてから、1つを選択します。
• 別のモデルを選択する： ワークフローの種類によっては、よりよい結果を生成するモデルがあります。
• 手動で調整する： AIP Architect が提供する候補は出発点です。生成された候補は、具体的なニーズに基づいて必ず確認し、調整してください。

エクスポートの問題

ダイアグラムをエクスポートできない

エクスポートオプションが無効になっている場合：

• ダイアグラムが保存されていることを確認する： エクスポートする前にダイアグラムを保存する必要があります。先に保存を選択します。
• 編集権限を確認する： エクスポート機能には、ダイアグラムリソースの編集権限が必要です。読み取り専用の閲覧者はダイアグラムをエクスポートできません。
• 再読み込みしてブラウザーの問題を解決する： ページを再読み込みするか、別のブラウザーを使用してみます。

エクスポートした画像の品質が低い

エクスポートした PNG ファイルの品質が低い場合：

• 解像度を変更する： 鮮明さを高めるため、画像は自動的に2倍のズームでエクスポートされます。より高い解像度が必要な場合は、ダイアグラムの特定の部分を拡大し、選択したノードをエクスポート機能を使用してみます。
• 複雑なダイアグラムをセクションに分割する： 非常に大きなダイアグラムは、ブラウザーのレンダリング上限を超える可能性があります。ダイアグラムを小さなセクションに分割することを検討してください。

AIP Critic からの PDF エクスポートに失敗する

AIP Critic の PDF エクスポートに失敗する場合：

• 会話の長さを確認する： 会話履歴が非常に長いと、サイズが大きすぎてエクスポートできない場合があります。追加のトピックについては、新しいレビュー会話を開始してみます。
• ブラウザーのメモリーへの負荷を軽減する： Solution Designer はブラウザー内で PDF を生成します。ブラウザーのメモリーが不足した場合は、ほかのタブを閉じて再試行します。

キャンバスとダイアグラムの問題

ノードまたはエッジが消える

ノードまたはエッジが表示されない場合：

• キャンバスの位置を調整する： キャンバスのツールバーにあるすべてのノードをビューに収めるボタンを使用して、表示位置を中央に戻します。
• ズームレベルを変更する： 拡大または縮小しすぎている可能性があります。ズームを調整するか、すべてのノードをビューに収めるを使用します。
• ミニマップでノードの位置を確認する： ミニマップ（グラフ設定で有効になっている場合）を使用して、ノードの位置を確認し、その位置に移動します。
• 誤って削除したノードを元に戻す： ノードを誤って削除した場合は、Cmd/Ctrl + Z を使用して操作を元に戻します。

ダイアグラムを編集できない

ノードを編集できない場合や、接続を作成できない場合：

• ダイアグラムがロックされているか確認する： キャンバスのツールバーでダイアグラムのロックが有効になっているかを確認します。ロックアイコンを選択してダイアグラムのロックを解除すると、パンモードが無効になり、ダイアグラムが編集可能な状態に戻ります。
• 権限を確認する： ダイアグラムリソースの編集権限があることを確認します。
• 読み取り専用リンクを使用しているか確認する： 読み取り専用リンクからダイアグラムにアクセスした場合は、編集できません。

自動レイアウトの結果がよくない

自動レイアウト機能でノードが期待どおりに配置されない場合：

• ダイアグラムの構造を確認する： 自動レイアウトは、ツリー構造や階層構造で最も効果を発揮します。交差する接続が多い複雑なグラフでは、手動のレイアウトが必要になる場合があります。
• ノードをグループ化する： よりよい結果を得るには、自動レイアウトを適用する前に、関連するノードをグループ化します。
• 手動で調整する： 自動レイアウトを出発点として使用し、その後ノードの位置を手動で調整して見やすくします。

読み込みとインポート

ファイルシステムからダイアグラムを読み込めない

保存されたダイアグラムを読み込めない場合：

• 権限を確認する： リソースに対して、少なくとも読み取り権限があることを確認します。

JSON からのダイアグラムのインポートに失敗する

JSON ダイアグラムのインポートに失敗する場合：

• 形式が有効であることを確認する： JSON は正しい Solution Designer 形式である必要があります。JSON が Solution Designer からエクスポートされたものであることを確認してください。

追加のサポートを受ける

問題が解消しない場合：

1. ブラウザーコンソールを確認する： ブラウザーの開発者コンソール（F12 (Windows)、Option + Cmd + i (macOS)）を開き、エラーメッセージを確認します。Foundry 管理者に問題を報告する際は、これらのエラーを含めてください。
2. ダイアグラムをバックアップとしてエクスポートする： データの消失を防ぐため、ダイアグラムを JSON としてエクスポートします。
3. サポートに問い合わせる： 次の情報を添えて、Foundry 管理者または Palantir サポートにお問い合わせください。
   • 問題の説明。
   • 問題を再現する手順。
   • ブラウザーコンソールに表示されたエラーメッセージ。
   • 使用しているブラウザーとそのバージョン。
   • 該当する場合は、ダイアグラムの JSON のコピー（機密データが含まれていないことを確認してください）。