This guide covers the most common connection issues in IdeaBoxAI and how to resolve them. If a problem persists after following these steps, contact the platform team.Documentation Index
Fetch the complete documentation index at: https://docs.ideaboxai.com/llms.txt
Use this file to discover all available pages before exploring further.
Structured knowledge base issues
The following table covers issues related to database connections in structured data knowledge bases.| Problem | Resolution |
|---|---|
| Connection refused | Check that the host and port are correct and reachable. Verify firewall rules allow inbound connections from the IdeaBoxAI platform. |
| Authentication failed | Confirm the username and password are correct. Use a read-only service account. For SSL issues, confirm whether the database requires SSL and toggle the SSL Mode setting accordingly. |
| Schema import hangs | The database may have too many tables. Filter to relevant schemas before connecting if possible. Contact the platform team if the issue persists. |
| Cube query returns no data | Check that the selected measures and dimensions are valid for the cube. Inspect the Generated SQL tab for errors and ensure the underlying tables are not empty. |
Unstructured knowledge base issues
The following table covers issues related to document uploads and external source imports.| Problem | Resolution |
|---|---|
| File stuck in Processing | Remove the file and re-upload. Ensure the PDF is machine-readable (not a scanned image). For large files, split into smaller batches. |
| Confluence import fails | Regenerate the Atlassian API token. Confirm the user has read access to the selected spaces. Try importing a smaller space first. |
| Google Drive import fails | Re-authenticate with Google (OAuth token may have expired). Check that the user has access to the selected folders. |
Next steps
Knowledge base connections
Review setup steps for database and document connections.
Connector directory
Browse all available connectors by category.