Skip to content

AWS SQS

Async queues between the API and Lambda workers.

Used for

  • Interview completed/failed — credit settlement after terminal interview states
  • Report generate — trigger LLM report after successful settlement

API publishes; Lambdas consume with partial batch failure reporting and DLQs after retries.

Auth (env vars)

  • INTERVIEW_COMPLETED_QUEUE_URL
  • REPORT_GENERATE_QUEUE_URL
  • AWS_REGION
  • AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY — optional for local publish

Notes

  • If queue URLs are unset, publish logs a warning and no-ops (no async settlement locally).
  • Messages carry requestId as an attribute for log correlation.
  • Invalid message schema is logged and dropped (not retried forever).

Sophia AI Interview Platform — Internal Documentation