Skip to main content

13. Troubleshooting

You seeCause and fix
config/agents is invalid: … at bootA definition is wrong. The message names the file, workflow or node. Run task config_validate while editing.
…: unknown field \x``A key that does not exist; check the spelling against §5 or the JSON Schemas.
unknown kind \rules.validat` (known: […])`A misspelt kind; the message lists the valid ones.
model \x`: license `y` is not in allowed_licenses`Add the license to allowed_licenses only after review, or pick another model.
… requires approval, but a path from \parse` reaches it without a `human.approval` node`Route the edge through an approval node.
environment variable(s) not set and no default: XSet X, or give the tag a default.
invalid type: null, expected a stringAn unquoted get_env tag with an empty default; quote it.
InvalidSecret(InvalidByte(…)) when issuing tokensJWT_SECRET is not base64.
a webhook needs options.url and credentials.hmac_secretSet both, or use accounting_stub.
HTTP 401 from /agui/…No token, an expired one, or a token for a user not in users.
Not accepted: resolving approvals needs …The user lacks approvals.resolve; sign in as an approver.
Not accepted: four-eyes: …The approver started the run; another person must decide.
RUN_ERROR conflict: the thread has an open interruptA message was sent to a run that is waiting; decide the approval instead.
RUN_ERROR conflict: thread … already has a runThread ids are one run each; the web app starts a new thread when the page reloads.
RUN_ERROR internal: model output does not match the schemaThe model returned fields the schema forbids; check the prompt, schema and model. The run is failed.
Run status needs_reconciliationSee §9.3.
PoolTimedOutPostgreSQL is not reachable at DATABASE_URL.