Workers
~3 min read
Concept & How It Works
- Key points are in the visual diagram above.
Why Does It Exist?
Separating API from compute lets you scale each independently, retry failed agent runs without the user waiting, and run resource-heavy tasks (browser automation, large PDF parsing) on machines tuned for that workload.
Real-World Analogy
Workers are kitchen staff behind the counter — the front desk (API) takes orders fast; the kitchen (workers) does the slow cooking without making customers stand at the register.
Visual Workflows
What is Workers?
Example
Scenario
Three Celery workers consume from `agent.tasks` queue. Each runs a LangGraph agent for document summarization. On failure, Celery retries 3× with exponential backoff, then moves to DLQ for manual review.
Solution
In Agent Runtime & Production, apply Workers to this scenario: Three Celery workers consume from `agent. Identify the inputs, run the technique, validate the output, and note one thing you would monitor in production.
Practice Task
Do this before moving to the next module — reading alone is not enough.
Open the Code Walkthrough below and run it locally. Change one parameter related to Workers (e.g. model, temperature, top_k, or tool name), observe the difference in output, and write 2–3 sentences explaining what changed.
Code Walkthrough
Highlighted lines show where Workers happens in the code.
1from celery import Celery # import dependencies2
3app = Celery("agent", broker="redis://localhost:6379/0")4
5@app.task(bind=True, max_retries=3, default_retry_delay=60)6def summarize_document(self, doc_id: str) -> dict: # define a reusable function7 try:8 text = fetch_document(doc_id)9 summary = run_summarization_agent(text)10 save_summary(doc_id, summary)11 return {"doc_id": doc_id, "status": "done"} # return the result12 except TransientError as exc:13 raise self.retry(exc=exc)Commands to Remember
Commands to Remember
pip install fastapi uvicorn # serve agent APIsdocker build -t agent-api . # containerize for productionkubectl apply -f deployment.yaml # deploy to Kubernetes
Common Mistakes
- Treating Workers as a black box without evaluation
- Ignoring cost and latency in production
- Skipping error handling for workers
Cheat Sheet
Quick recap — the most important points from this module.
Cheat Sheet
quick ref- •Workers
- •Celery
- •Graceful Shutdown
- •Stateless Worker
