Support
Troubleshooting
Fix the most common problems with capturing knowledge, querying engines, and streaming answers.
Find what you're seeing in the first column, then follow the fix.
Capturing
| What you see | Why it happens | What to do |
|---|---|---|
422: container must be one of okf, vector | The container value is misspelled. | Use vector or okf. |
403 with ke_runtime_denied | The key doesn't include the Knowledge Engines runtime. | Turn on Knowledge Engines for the key in API Keys. |
ke_ingestion_failed in errors | The event couldn't be stored, often because the dimension isn't enabled. | Read the message. Use an enabled dimension, or leave it out. See Containers. |
| No API/SDK Feed in Sources | No write has reached the container yet. | Flush or close Dock after capture. |
Querying
| What you see | Why it happens | What to do |
|---|---|---|
engine_id is required for query() | No engine ID was given. | Set DOCKLEE_ENGINE_ID, or pass engine_id (Python) or engineId (TypeScript). |
| The answer ignores content you wrote | The feed or source isn't linked to the engine. | Add it on the engine's Sources tab. |
| "information not available" | Your linked sources don't cover the question, in grounded or retrieval mode. | Link the source that covers it, or use blended if general knowledge is acceptable. |
Confidence is 0 | The answer had no valid citation. | Treat it as no answer. See Citations and confidence. |
409 when linking a source | Its dimension doesn't match the engine's vector sources. | Use a source of the same dimension, or a new engine. See Engines. |
403 | The key can't read this engine. | Use a key with read or both, scoped to the engine. |
429 | You've hit your plan's rate limit. | Retry after the time in Retry-After. The SDK retries for you. |
Streaming
| What you see | Why it happens | What to do |
|---|---|---|
| The SDK stream yields nothing | The answer arrived whole in final, such as a Precision Mode answer. | Call query without stream, or read final over HTTP. |
| A different mode than you passed | Streams use the engine's Answer Mode setting. | Change the setting, or call query without stream. See Answer modes. |
| cURL prints everything at the end | Output is buffered. | Add -N. |
An error event | The answer couldn't be finished. | Read detail, then retry. |
Still stuck
See the FAQs, or contact Docklee support with the engine ID and the time of the request.
Next steps
Back to building. These pages cover the calls you'll use most.