Errors and recovery

Use the stage and exact message to choose a response.

Authentication and authorization

Check key validity, user role, organization context, endpoint permission, and tenant authorization. Do not retry a 401 or 403 without changing credentials or access.

Connection and indexing

Verify network reachability, TLS, credential scope, source availability, file path, and object permissions. Re-test the connection, then rerun indexing.

Planning and validation

Clarify ambiguous terms, identify a source, narrow the question, or correct catalog and semantic metadata. Invalid tenant scope should fail before execution.

Execution

Inspect the compiled operation, timeout, result bound, source error, type conversion, and join assumptions. Retry transient failures with bounded backoff only when safe.

Rendering

If data is correct but a chart or answer block is invalid, preserve the table and provenance while rejecting the unsupported presentation.

Include the timestamp, organization, request ID, source, and exact error when contacting [email protected]. Never include credentials.