トラブルシューティング

このページでは、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 モデル選択ドロップダウンが空の場合：

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

画像から図への変換が無効になっている

図に変換する画像をアップロードできない場合：

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

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