> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/ai-workbench-qore/help/troubleshooting.md).

# Troubleshooting

Fixes for common problems in Qore, by module and by task.

Find the fix for a problem you're seeing. For general questions, see [FAQs](/ai-workbench-qore/help/faqs.md).

## By module

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-user-gear" style="color:$primary;">:user-gear:</i></h3></td><td><h4><strong>Admin</strong></h4></td><td>Sign-in, teams, API keys, and roles.</td><td><a href="/ai-workbench-qore/control-center/admin/admin-faqs-and-troubleshooting.md#troubleshooting">Admin: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-database" style="color:$primary;">:database:</i></h3></td><td><h4><strong>Knowledge</strong></h4></td><td>Failed syncs, rate limits, and stuck files.</td><td><a href="/ai-workbench-qore/console/knowledge/faqs.md#troubleshooting">Knowledge: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-triangle-exclamation" style="color:$primary;">:triangle-exclamation:</i></h3></td><td><h4><strong>Knowledge processing</strong></h4></td><td>When a file fails to process, and retries.</td><td><a href="/ai-workbench-qore/console/knowledge.md#when-processing-fails">Knowledge</a></td></tr><tr><td><h3><i class="fa-diagram-project" style="color:$primary;">:diagram-project:</i></h3></td><td><h4><strong>Flows</strong></h4></td><td>Warnings, paused runs, and unexpected results.</td><td><a href="/ai-workbench-qore/console/flows/flows-faqs-and-troubleshooting.md#troubleshooting">Flows: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-file-export" style="color:$primary;">:file-export:</i></h3></td><td><h4><strong>Export Agent</strong></h4></td><td>Missing emails, expired links, and imports.</td><td><a href="/ai-workbench-qore/console/agent-builder/deploy/export-agent.md#troubleshooting">Export Agent</a></td></tr><tr><td><h3><i class="fa-code" style="color:$primary;">:code:</i></h3></td><td><h4><strong>Integrate Agent</strong></h4></td><td>A widget that doesn't appear, and Unauthorized errors.</td><td><a href="/ai-workbench-qore/console/agent-builder/deploy/agent-integration.md#troubleshooting">Integrate Agent</a></td></tr><tr><td><h3><i class="fa-puzzle-piece" style="color:$primary;">:puzzle-piece:</i></h3></td><td><h4><strong>Adding a skill</strong></h4></td><td>Skills the agent doesn't use, or that fail at runtime.</td><td><a href="/ai-workbench-qore/console/agent-builder/build/adding-a-skill-to-the-agent.md#common-issues-and-troubleshooting">Adding a skill to the agent</a></td></tr><tr><td><h3><i class="fa-book-open" style="color:$primary;">:book-open:</i></h3></td><td><h4><strong>Attaching knowledge</strong></h4></td><td>A Done button that stays disabled, and knowledge the agent doesn't use.</td><td><a href="/ai-workbench-qore/console/agent-builder/build/attaching-knowledge-to-an-agent.md#common-issues-and-troubleshooting">Attaching Knowledge to an Agent</a></td></tr><tr><td><h3><i class="fa-rocket" style="color:$primary;">:rocket:</i></h3></td><td><h4><strong>Publishing an app</strong></h4></td><td>Publishing Failed, Fix with AI, and the deploy log.</td><td><a href="/ai-workbench-qore/console/app-builder/deploy.md#resolve-a-failed-publish">Deploy</a></td></tr><tr><td><h3><i class="fa-flask" style="color:$primary;">:flask:</i></h3></td><td><h4><strong>App tests</strong></h4></td><td>A build that fails its tests.</td><td><a href="/ai-workbench-qore/console/app-builder/testing.md#if-a-build-fails-its-tests">Testing</a></td></tr><tr><td><h3><i class="fa-diagram-nodes" style="color:$primary;">:diagram-nodes:</i></h3></td><td><h4><strong>Governed Graph</strong></h4></td><td>A graph upload that failed.</td><td><a href="/ai-workbench-qore/control-center/govern/governed-graph.md#troubleshooting">Governed Graph</a></td></tr><tr><td><h3><i class="fa-user-gear" style="color:$primary;">:user-gear:</i></h3></td><td><h4><strong>Console Operator</strong></h4></td><td>Agents it won't use, missing connections, and schedules.</td><td><a href="/ai-workbench-qore/console/console-operator/console-operator-faqs-and-troubleshooting.md#troubleshooting">Console Operator: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-robot" style="color:$primary;">:robot:</i></h3></td><td><h4><strong>Agent Builder</strong></h4></td><td>Skills, MCP servers, knowledge, widget, API, and tokens.</td><td><a href="/ai-workbench-qore/console/agent-builder/agent-builder-faqs-and-troubleshooting.md#troubleshooting">Agent Builder: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-window-maximize" style="color:$primary;">:window-maximize:</i></h3></td><td><h4><strong>App Builder</strong></h4></td><td>Stalled builds, preview errors, failed tests, and publishes.</td><td><a href="/ai-workbench-qore/console/app-builder/app-builder-faqs-and-troubleshooting.md#troubleshooting">App Builder: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-plug" style="color:$primary;">:plug:</i></h3></td><td><h4><strong>Integrations Hub</strong></h4></td><td>Disabled Connect buttons, OAuth, and unusable connections.</td><td><a href="/ai-workbench-qore/console/integrations-hub/integrations-hub-faqs-and-troubleshooting.md#troubleshooting">Integrations Hub: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-swatchbook" style="color:$primary;">:swatchbook:</i></h3></td><td><h4><strong>Design Systems</strong></h4></td><td>Apps that don't change, fonts, and restores.</td><td><a href="/ai-workbench-qore/console/design-systems.md#troubleshooting">Design Systems</a></td></tr><tr><td><h3><i class="fa-store" style="color:$primary;">:store:</i></h3></td><td><h4><strong>Store</strong></h4></td><td>Listings you can't find.</td><td><a href="/ai-workbench-qore/console/store/store-faqs-and-troubleshooting.md#troubleshooting">Store: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-user-shield" style="color:$primary;">:user-shield:</i></h3></td><td><h4><strong>Governance Operator</strong></h4></td><td>Changes that don't happen, and schedules.</td><td><a href="/ai-workbench-qore/control-center/governance-operator.md#troubleshooting">Governance Operator</a></td></tr><tr><td><h3><i class="fa-chart-line" style="color:$primary;">:chart-line:</i></h3></td><td><h4><strong>Observe</strong></h4></td><td>Empty traces, waiting runs, and missing exports.</td><td><a href="/ai-workbench-qore/control-center/observe/observe-faqs-and-troubleshooting.md#troubleshooting">Observe: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-wallet" style="color:$primary;">:wallet:</i></h3></td><td><h4><strong>Cost Control</strong></h4></td><td>Blocked requests, missing alerts, and limits that won't save.</td><td><a href="/ai-workbench-qore/control-center/cost-control/cost-control-faqs-and-troubleshooting.md#troubleshooting">Cost Control: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-clipboard-check" style="color:$primary;">:clipboard-check:</i></h3></td><td><h4><strong>Evals</strong></h4></td><td>Missing scores, failed runs, and empty review queues.</td><td><a href="/ai-workbench-qore/control-center/evals/evals-faqs-and-troubleshooting.md#troubleshooting">Evals: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-shield-halved" style="color:$primary;">:shield-halved:</i></h3></td><td><h4><strong>Govern</strong></h4></td><td>Stopping agents, connector access, and graph uploads.</td><td><a href="/ai-workbench-qore/control-center/govern/govern-faqs-and-troubleshooting.md#troubleshooting">Govern: FAQs &amp; Troubleshooting</a></td></tr><tr><td><h3><i class="fa-network-wired" style="color:$primary;">:network-wired:</i></h3></td><td><h4><strong>AI Gateway</strong></h4></td><td>Unsaved changes, unavailable models, and failed calls.</td><td><a href="/ai-workbench-qore/control-center/ai-gateway/ai-gateway-faqs-and-troubleshooting.md#troubleshooting">AI Gateway: FAQs &amp; Troubleshooting</a></td></tr></tbody></table>

## By task

Each task guide ends with its common issues.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-user-gear" style="color:$primary;">:user-gear:</i></h3></td><td><h4><strong>Use the Console Operator</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/use-the-console-operator.md#common-issues">Use the Console Operator</a></td></tr><tr><td><h3><i class="fa-robot" style="color:$primary;">:robot:</i></h3></td><td><h4><strong>Create an agent</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/create-an-agent.md#common-issues">Create an agent</a></td></tr><tr><td><h3><i class="fa-diagram-project" style="color:$primary;">:diagram-project:</i></h3></td><td><h4><strong>Create a flow</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/create-a-flow.md#common-issues">Create a flow</a></td></tr><tr><td><h3><i class="fa-database" style="color:$primary;">:database:</i></h3></td><td><h4><strong>Create a knowledge base</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/create-a-knowledge.md#common-issues">Create a knowledge</a></td></tr><tr><td><h3><i class="fa-layer-group" style="color:$primary;">:layer-group:</i></h3></td><td><h4><strong>Create a design system</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/create-a-design-system.md#common-issues">Create a design system</a></td></tr><tr><td><h3><i class="fa-mobile" style="color:$primary;">:mobile:</i></h3></td><td><h4><strong>Create an app</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/create-an-app.md#common-issues">Create an app</a></td></tr><tr><td><h3><i class="fa-link" style="color:$primary;">:link:</i></h3></td><td><h4><strong>Integrate an agent</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/integrate-an-agent.md#common-issues">Integrate an agent</a></td></tr><tr><td><h3><i class="fa-plug" style="color:$primary;">:plug:</i></h3></td><td><h4><strong>Connect an integration</strong></h4></td><td>Common issues, with fixes.</td><td><a href="/ai-workbench-qore/task-guides/how-to-connect-an-integration.md#common-issues">Connect an integration</a></td></tr></tbody></table>

Still stuck? From an agent or app builder, select **?** › **Need Help? Raise a Request**, or ask the Qore Knowledge Assistant from the [Help Center](/ai-workbench-qore/help.md).

***

{% columns %}
{% column width="83.33333333333334%" %}

<p align="right"><em>Maintained by</em> <mark style="color:green;">Abhishek Paul</mark><br><code>AI-assisted, human-approved</code></p>
{% endcolumn %}

{% column width="16.666666666666664%" %}

<div align="left"><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-d034645b4f8f8ee661985f5306b60ded3289653c%2Fmaintainer-abhishek-paul.png?alt=media" alt="" width="60"></div>
{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.uptiq.ai/ai-workbench-qore/help/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.