Troubleshooting
Knowledge parsing and retrieval issues
Diagnose the symptom
| Symptom | Checks |
|---|---|
| Uploaded file has no knowledge | Inspect parsing configuration, associated workflow, and execution access |
| Automatic parsing stops | Check creator identity, permissions, and effective configuration |
| Import partially succeeds | Inspect written items before retrying failed items |
| Retrieval is empty | Remove filters; inspect indexes, query, model, and access |
| Knowledge test and workflow differ | Compare knowledge base, parameters, query, filters, and caller |
| Answer lacks source support | Inspect retrieved context passed to the model and prompt constraints |
| Wrong schema | Create a correct target and plan migration |
Verify after diagnosis
Retest with the same query, filters and account, then check the returned content and sources.
Continue with the related procedure.
Workflow execution issues
Start with the first failed node in this call. Confirm the version and inputs before investigating downstream dependencies.
Trigger and API call issues
Verify authentication, condition matching, workflow start, and business completion separately. A successful response establishes only the relevant stage.