# Troubleshooting

> For the complete documentation index, see [llms.txt](https://developers.thoughtspot.com/docs/llms.txt)

Source: https://developers.thoughtspot.com/docs/tutorials/spottercode-embed/troubleshooting

# Troubleshooting

These scenarios come up on almost every real project.

## Scenario: outdated SDK version

Your project was scaffolded months ago and still points to an older version of the Visual Embed SDK. You ask for a feature that exists only in a newer release, and the generated code does not run.

**Fix:** Name the version explicitly and ask what changed.

```text
"Update my Liveboard embed code to the latest Visual Embed SDK version and list any
breaking changes from my current version in the documentation."
```

## Scenario: vague follow-up gets a vague answer

`"Make the Liveboard better"` will not produce useful code. Keep prompts scoped to one outcome.

 
| Approach | Prompt |
| --- | --- |
| 
**Avoid**

 | 

`"Can you customize the embed?"`

 |
| 

**Use instead**

 | 

`"Fetch the documentation for LiveboardEmbed and summarize the available customization options."`  
Then pick one option and ask for it by name.

 |

## General troubleshooting checklist

 
| Symptom | Action |
| --- | --- |
| 
No response or page not loading

 | 

Confirm SpotterCode is enabled for this project and the MCP server is reachable.

 |
| 

Slow responses

 | 

Break the request into smaller, sequential prompts instead of one large request.

 |
| 

The response looks wrong

 | 

Check which tool the agent called. Refine the prompt for specificity before assuming the tool is broken.

 |
| 

The agent infers SpotStay business logic incorrectly

 | 

You must specify anything that is not in the documentation or the SDK. Do not ask SpotterCode to infer SpotStay-specific business logic.

 |

[← Previous]({{navprefix}}/tutorials/spottercode-embed/embed-spotter) [Next →]({{navprefix}}/tutorials/spottercode-embed/summary)