Troubleshooting

This page provides solutions to common issues you may encounter when using Solution Designer.

Auto-save issues

Auto-save repeatedly fails

If auto-save repeatedly fails or shows an error state:

• Check permissions: Verify that you have edit permissions on the diagram resource. Select the resource name in the header to view permissions.
• Manually save: Try manually saving the diagram by choosing Save in the header. If manual save also fails, note the error message and contact your Foundry administrator.
• Check connection: Ensure you have a stable network connection, as auto-save requires connectivity to the Foundry backend.
• Reload the diagram: Close and reopen the diagram. Auto-save may recover after a reload.
• Export as backup: If you cannot save, export the diagram as a JSON file to prevent data loss, then contact your Foundry administrator.

Conflict on save

If you see a conflict resolution dialog when saving a diagram:

• Check for multiple editors: Another user may be editing the diagram simultaneously. To avoid conflicts, coordinate with team members before editing shared diagrams.
• Review your changes: Compare your changes with the version on the server.
• Choose an option:
  • Keep your changes: Overwrite the server version with your changes.
  • Keep server changes: Discard your changes and load the server version.
  • Cancel: Exit the save operation and manually merge changes.

AIP features

AIP Architect or AIP Critic is not available

If AIP features do not appear in Solution Designer:

• Check AIP status: AIP features must be enabled for your enrollment. Contact your Foundry administrator to request access.
• Verify model availability: At least one supported LLM must be configured by your Foundry administrator from Model Catalog.
• Validate browser compatibility: Ensure you are using a supported browser. Currently, Chrome, Edge, Firefox, and Safari are supported.

Model selection shows no available models

If the AI Model selection dropdown is empty:

• LLM service may be unavailable: The language model service may not be configured or may be temporarily unavailable. Contact your Foundry administrator to validate that at least one supported LLM is configured and available.
• Check permissions: You may not have permissions to access language models. Contact your Foundry administrator.

Image-to-diagram conversion is disabled

If you cannot upload images to convert to diagrams:

• Ensure you can access a vision-capable model: Image conversion requires a vision-capable model (such as GPT-4o). Check the Model dropdown menu in the Upload an Image modal to verify that a vision-capable model is available and selected.

AIP Architect suggestions seem inaccurate

If AIP Architect suggestions do not match your requirements:

• Refine your workflow summary: Edit your workflow summary to provide more specific details about your requirements, constraints, or desired approach.
• Try different implementations: Preview multiple suggested implementation patterns before selecting one.
• Choose a different model: Some models may produce better results for specific types of workflows.
• Make manual adjustments: AIP Architect provides a starting point; you should always review and refine generated suggestions based on your specific needs.

Export issues

Cannot export diagram

If export options are disabled:

• Ensure your diagram is saved: You must save the diagram before exporting. Select Save first.
• Check your edit permissions: Export functionality requires edit permissions on the diagram resource. Read-only viewers cannot export a diagram.
• Refresh to resolve browser issues: Try refreshing the page or using a different browser.

Exported image quality is poor

If your exported PNG file's quality is poor:

• Change the resolution: Images are automatically exported at 2x zoom for improved clarity. If you need higher resolution, try zooming in on specific parts of the diagram and using the Export selected nodes feature.
• Chunk complex diagrams into sections: Very large diagrams may exceed browser rendering limits. Consider breaking the diagram into smaller sections.

PDF export from AIP Critic fails

If AIP Critic PDF export fails:

• Check your conversation length: Very long conversation histories may be too large to export. Try starting a new review conversation for additional topics.
• Reduce strain on your browser's memory: Solution Designer generates PDFs in your browser. Close other tabs and try again if your browser runs out of memory.

Canvas and diagram issues

Nodes or edges disappear

If nodes or edges are not visible:

• Adjust your canvas position: Use the Fit all nodes into view button in the canvas toolbar to recenter the view.
• Change your zoom level: You may be zoomed too far in or out. Adjust zoom or use Fit all nodes into view.
• Locate nodes on the mini-map: Use the mini-map (if enabled in Graph Settings) to locate your nodes and navigate to them.
• Undo an accidental node deletion: If you accidentally delete a node, use Cmd/Ctrl + Z to undo the action.

Cannot edit a diagram

If you cannot edit nodes or create connections:

• Check if the diagram is locked: Check if the diagram lock is enabled in the canvas toolbar. Select the lock icon to unlock the diagram, which disables pan mode and returns the diagram to an editable state.
• Verify your permissions: Verify you have edit permissions on the diagram resource.
• Check if you have a read-only link: If you accessed the diagram via a read-only link, then you will not be able to edit.

Auto-layout produces poor results

If the auto-layout feature does not arrange nodes as expected:

• Review your diagram's structure: Auto-layout works best with tree-like or layered structures. Complex graphs with many cross-connections may require manual layout.
• Group nodes: Group related nodes before applying auto-layout for better results.
• Make manual adjustments: Use auto-layout as a starting point, then manually adjust node positions to improve clarity.

Loading and importing

Cannot load diagram from filesystem

If you cannot load a saved diagram:

• Check your permissions: Verify you have at least read permissions on the resource.

Import diagram from JSON fails

If importing a JSON diagram fails:

• Ensure your format is valid: The JSON must be in the correct Solution Designer format. Ensure the JSON was exported from Solution Designer.

Get additional help

If you continue to experience issues:

1. Check your browser console: Open your browser's developer console (F12 (Windows), Option + Cmd + i (macOS)) and check for error messages. Include these errors when reporting issues to your Foundry administrator.
2. Export diagram as backup: Export your diagram as JSON to prevent data loss.
3. Contact support: Reach out to your Foundry administrator or Palantir Support with:
   • A description of the issue.
   • Steps to reproduce the problem.
   • Any error messages from the browser console.
   • The browser and version you are using.
   • A copy of the diagram JSON if relevant (ensure it contains no sensitive data).