add troubleshooting and fix configuration with gpt

Author: Fabio9705

docs/getting-started/configuration.md

@@ -235,6 +235,8 @@ The external Semantic Table Interpretation service must expose APIs as indicated
 
 ### Mantistablex
 
+The following keys are used by the MantistableX plugin, which relies on the GPT API for text generation, specifically for the lexicalization of an annotated table, i.e. transforming structured annotations into natural language descriptions. The table input and its annotations are sent to GPT, which generates a natural language lexicalization of the input.
+
 - **`GPT_KEY`**
 
   ```plaintext

docs/troubleshooting.md

@@ -0,0 +1,67 @@
+# Troubleshooting
+
+This section lists common issues that may occur when using **MantistableX** and provides possible solutions.
+
+---
+
+## 1. GPT API does not respond
+
+**Problem:** The system does not return any lexicalization or text generation from GPT.
+
+**Solution:**
+
+- Check that your GPT API key is correctly set in the environment variables (`OPENAI_API_KEY`).
+- Ensure that your internet connection is stable.
+- Verify that the API endpoint is reachable and not blocked by a firewall or proxy.
+
+---
+
+## 2. Plugin is not activated
+
+**Problem:** MantistableX plugins are not working or not available in the interface.
+
+**Solution:**
+
+- Open the configuration file and check that the desired plugin is enabled.
+- Restart the application after modifying the configuration.
+- Verify that all required dependencies are installed.
+
+---
+
+## 3. Table import fails
+
+**Problem:** The system cannot import a table.
+
+**Solution:**
+
+- Ensure that the file format is supported (e.g., CSV, JSON).
+- Check that the file is not corrupted or empty.
+- Confirm that the file path is correct and accessible.
+
+---
+
+## 4. Annotation not displayed
+
+**Problem:** Annotations do not appear after processing a table.
+
+**Solution:**
+
+- Refresh the interface.
+- Verify that the annotation step was successfully completed in the logs.
+- Check that the output directory is correctly configured.
+
+---
+
+## 5. Unexpected error during annotation
+
+**Problem:** An error message appears while generating or editing annotations.
+
+**Solution:**
+
+- Check the logs for more detailed error messages.
+- Verify that the annotation format is correct.
+- If using GPT-based annotation, ensure that the API rate limit has not been exceeded.
+
+---
+
+If issues persist, please open a ticket in the issue tracker with detailed logs and steps to reproduce the error.