Troubleshooting

Even with the power of AI, building software can sometimes be challenging. This guide helps you navigate common issues and provides strategies for getting back on track. Problem-solving is part of the building process, even with agentic coding.

​

Quick Reference

​

Common Challenges at a Glance

​

Workshop Misunderstands Your Requirements

• Be more specific — provide concrete examples and analogies
• Break down complex requests into smaller pieces
• Use the correction pattern: acknowledge what works, identify what needs to change, explain the desired outcome

​

Technical Errors in Generated Code

• Share the exact error message with Workshop
• Ask for both an explanation and a fix
• Use version control to revert if changes make things worse
• Test small pieces in isolation

​

Performance Issues

• Ask Workshop to identify the bottleneck
• Request specific optimizations for your use case
• Be open to architecture changes if needed

​

Integration Difficulties

• Verify API keys and permissions
• Examine request/response data to find formatting issues
• Create a minimal test case before implementing full functionality

​

Workshop Seems Stuck

• Reset the approach: “Let’s step back. What’s the simplest way to approach this?”
• Provide examples of what you are trying to achieve
• Start a fresh conversation with key context

​

Connectivity Issues

• Consult the Network and Connectivity guide
• Ensure required domains are accessible on your network
• Upgrade to the latest version of Workshop

​

Getting Help

If these guides do not resolve your issue:

• Discord: Join our community for help from the team and other builders
• Email: Reach out to help@workshop.ai for direct support
• Documentation: Browse the full docs at docs.workshop.ai

Troubleshooting is a natural part of the development process. By approaching problems methodically, communicating clearly with Workshop, and learning from each challenge, you will become more effective at resolving issues when they arise.