Vol. 01 · Agent Systems
LLM Pipeline Patterns
A comprehensive catalog of steps and tricks for building production systems based on language models. Each pattern is atomically parsed.
Input Processing
01inputQuery Paraphrase / Rewrite
Before sending a request to LLM or a search engine, reformulate it in a different way. This compensates for inaccurate user formulations and aligns the semantics to the index vector space.
text→ user: "why does my back hurt"
→ LLM rewrite: “causes of low back pain, risk factors”
→ search by reformulated query
→ results are combined with the original contextApplicable
- RAG system
- knowledge base search
- chatbots
02inputChunking Strategy
Breaking a long document into chunks for indexing or transferring into context. Strategies: fixed-size, recursive semantic, sentence-based, paragraph-based, sliding window with overlap.
textoverlap = 20% // do not lose context at the junction of chunks
chunk size = 512 tokens // accuracy/recall trade-off
metadata = {source, page, section} // for filteringApplicable
- RAG
- document QA
- summarization of long texts
03inputContext Stuffing / Window Packing
Maximum filling of the context window with relevant information from different sources: retrieved chunks + metadata + examples + history. The goal is to convey everything the model needs in one call.
text[system_persona] [task_description]
[retrieved_chunks × N]
[few_shot_examples × K]
[conversation_history]
[user_query]Applicable
- minimizing the number of API calls
- cost reduction
04retrievalHyDE — Hypothetical Document Embedding
Instead of searching by raw query, ask LLM to generate a hypothetical answer, and then search by its embedding. This works because the answer embedding is semantically closer to the actual documents than the question embedding.
textquery: "how does the transformer work?"
↓ LLM(query) → hypothetical answer ~200 words
↓ embed(hypothetical_answer)
↓vector_search(embedding)
↓ real relevant documentsApplicable
- technical search
- when the request is too short
Prompt Engineering
05promptChain-of-Thought (CoT)
Explicitly instructing the model to “think out loud” before answering. The model generates intermediate steps of reasoning, which reduces errors on complex tasks - especially mathematics, logic, and multi-step inferences.
sqlPrompt: "Think step by step before answering"
→ the model reveals reasoning in its response
→ the final answer follows from the steps derived
Options:
zero-shot CoT: add "Let's think step by step"
few-shot CoT: show examples with reasoning
invisible CoT: ... tags (hidden)Applicable
- mathematics
- diagnostics
- planning
- debugging
06promptFew-shot / Dynamic Few-shot
Passing input→output examples directly to the prompt. Dynamic version - examples are selected from the repository through semantic search, relevant to the current request. This is in-context learning without fine-tuning.
textquery → embed(query)
→ knn_search(examples_store, k=3)
→ selected examples in prompt
→ LLM(system + examples + query)Applicable
- structured output
- classification
- template generation
07promptMeta-Prompting / Prompt Generation
LLM generates or optimizes a prompt for another LLM call. It is used in automatic optimization of prompts (APE, DSPy-style), where the model itself offers improvements for the task.
texttask + examples of failures
→ Meta-LLM: "write the best prompt for X"
→ generated prompt
→ Worker-LLM(generated_prompt)
→ evaluation → iterationApplicable
- auto-optimization
- DSPy
- prompt versioning
08promptPersona / Role Injection
Assign a role to system prompt to control style, tone, level of expertise, and output format. Activates the desired distribution of tokens in the model’s weights - it “switches the register”.
textSystem: "You are a senior data engineer with 10 years of experience
in industrial analytics. Answer technically
no water, use specific numbers."
→ the model activates technical vocabulary and styleApplicable
- tone control
- domain expertise
- products with UX
09promptReAct Pattern
Interleaved reasoning + action. The model alternates between "Thought: [reasoning]" and "Action: [calling a tool]" and "Observation: [result]". This allows the agent to adapt to the results of the tools on the fly.
textThought: you need to check the current exchange rate
Action: search("USD RUB exchange rate today")
Observation: 1 USD = 91.3 RUB (03/09/2025)
Thought: now I can calculate the amount
Action: calc(1500 * 91.3)
Observation: 136950
Answer: 1500 USD = 136,950 RUBApplicable
- agents with tools
- search + calculations
Fan-out / Fan-in / Ensemble
10parallelismFan-out - parallel independent calls
One incoming request launches N parallel LLM calls with different prompts, configurations, or subtasks. All calls are independent - there are no dependencies between them. The main goal is either to cover different aspects of the problem, or to collect a variety of answers for subsequent selection of the best one.
text ┌─── LLM(prompt_A) ──→ result_A
query ──→ router ──┼─── LLM(prompt_B) ──→ result_B
└─── LLM(prompt_C) ──→ result_C
↓↓↓ fan-in ↓↓↓
aggregator(A, B, C) → final_outputWhen to use
- generation of options
- covering different points of view
- parallel analysis of several documents
- A/B testing of prompts at runtime
11aggregationFan-in - aggregation of results
Assembling the results from N parallel calls into one final response. Strategies: concatenation, map-reduce summarization, voting, LLM synthesis.
sqlconcat: just concatenate
vote: by majority vote
reduce: LLM(summarize([A,B,C]))
score+pick: select the best by metric
merge: LLM(merge([A,B,C]))Applicable
- ensemble of responses
- summary reports
12rankingRerank - reranking candidates
Two-stage search/generation: in the first stage, many candidates are quickly received (recall); in the second, an expensive model re-evaluates and rearranges them in descending order of relevance (precision). Key insight: fast retriever (BM25, vector search) can find, but ranks poorly. A slow reranker (cross-encoder, LLM) can accurately compare query-document pairs because it sees both at once - this is a fundamentally different type of attention.
textWhy is reranker more accurate than vector search?
bi-encoder: embed(query) embed(doc) ← independent, fast, ~100ms
cross-encoder: LLM([query; doc]) → score ← together, slowly, accurately
Pipeline:
query → fast_retriever (top-100 docs)
→ reranker (top-5 out of 100)
→ LLM (generation according to top-5)Applicable
- RAG with high precision requirements
- search engines
- choosing the best of N LLM options
- recommendations
13ensembleSelf-consistency / Majority Voting
Run the same prompt N times with temperature > 0, get different reasoning paths, take the answer by majority vote. Statistically more reliable than a single greedy call.
pythonruns = [LLM(q, temp=0.7) for _ in range(5)]
answers = [extract_answer(r) for r in runs]
final = Counter(answers).most_common(1)[0]Applicable
- math/logic problems
- classification
14parallelismMap-Reduce Summarization
For a document longer than the context window: split into chunks, summarize each in parallel (map), then combine the summaries into the final one (reduce). Can be done recursively.
pythondoc → [chunk1, chunk2, ..., chunkN]
map: [summarize(c) for c in chunks] // in parallel
reduce: summarize(join(summaries)) // finalApplicable
- long documents
- books
- call transcripts
15routingPrompt-level MoE - specialized agents
Router determines the type of request and routes it to a specialized prompt/agent. Each “expert” is an LLM with a narrow system imperative. This is a prompt-level analogue of an architectural MoE.
textquery → Router-LLM: {type: "code"|"math"|"write"}
↓
"code" → Code-Expert (system: senior engineer)
"math" → Math-Expert (system: mathematician + CoT)
"write" → Write-Expert (system: copywriter)Applicable
- multi-domain products
- reduction of errors by specialization
Chaining & Control Flow
16chainSequential Chain
The output of one LLM call becomes the input of the next. Each step transforms the data: extract → analyze → generate → format. Allows you to break a complex task into manageable subtasks.
textraw_text
→ [Step 1] extract_facts(text) → facts_json
→ [Step 2] analyze_sentiment(facts) → sentiment
→ [Step 3] generate_report(facts, sentiment)Applicable
- document processing
- content pipelines
17control flowConditional Routing / Branching
LLM or deterministic code decides on the next step. If condition A is branch 1, if B is branch 2. Allows you to build non-linear pipelines with if-else logic.
textquery → classifier → {intent}
intent == "complaint" → escalation_flow
intent == "question" → faq_flow
intent == "purchase" → sales_flowApplicable
- chatbots
- ticket systems
- workflow automation
18decompositionPlan-and-Execute
Split into two independent LLM calls: Planner creates a list of steps, Executor executes each step in turn. Planner sees the entire task strategically, Executor is focused on one step - this reduces errors.
pythonPlanner(task) → ["step1", "step2", "step3"]
↓
for step in plan:
result = Executor(step, context=prev_results)
context.append(result)Applicable
- complex agency tasks
- research
- code generation
19decompositionLeast-to-Most Prompting
LLM first breaks down a problem into subtasks from simple to complex. Then solves them sequentially, using simple answers to solve complex ones. An analogue of dynamic programming for LLM.
textQ: "How many minutes are in 3.5 days?"
→ Sub-Q1: “How many hours are there in a day?” → 24
→ Sub-Q2: “How many minutes are there in an hour?” → 60
→ Sub-Q3: “How many minutes are there in 3.5 * 24h?” → 5040Applicable
- mathematics
- multi-stage calculations
20iterationIterative Refinement / Self-Edit Loop
The model generates a draft, criticizes it, improves it - and so on for N iterations. This simulates the editing process. Stopping based on quality condition or number of iterations.
pythondraft = LLM(task)
for i in range(max_iter):
critique = LLM(f"Find the flaws: {draft}")
if "no comments" in critique: break
draft = LLM(f"Improve taking into account: {critique}\n{draft}")
return draftApplicable
- copywriting
- code
- reports
- email drafts
Validation, Retry & Quality Control
21validationSchema Validation + Structured Output
Force JSON/structured output via Pydantic, Instructor, function calling or JSON mode. Scheme error → immediate retry with a description of the error in the prompt.
pythonclass Output(BaseModel):
sentiment: Literal["pos","neg","neu"]
score: float = Field(ge=0, le=1)
result = instructor.chat(model, Output, prompt)
// if parsing error occurs - auto-retry with tracebackApplicable
- any downstream code
- Integration API
- databases
22evaluationLLM-as-Judge
Separate LLM call to evaluate the quality of the main output. Judge receives the original question + answer and gives a score based on the criteria. Works as an automated reviewer.
textSystem: "You are a strict evaluator of the quality of answers"
User: f"""
Question: {question}
Answer: {answer}
Rate: accuracy (0-5), recall (0-5),
hallucinations (yes/no)
Reply JSON.
"""Applicable
- CI/CD for prompts
- online quality control
- RLHF-like feedback
23retryRetry with Error Feedback
If there is an error, do not just repeat the call, but pass on to the next attempt a description of what went wrong. LLM sees his mistake and takes it into account. Exponential backoff for rate limits.
pythonfor attempt in range(max_retries):
result = LLM(prompt + error_context)
ok, error = validate(result)
if ok: return result
error_context += f"\n{attempt} failed: {error}"
sleep(2 ** attempt) // exponential backoff
raise MaxRetriesErrorApplicable
- production reliability
- code generation
- parsing
24validationGrounding / Hallucination Detection
Checking that every factual statement in the answer is supported by sources. Either through the NLI model (entailment), or through a separate LLM call, or through a citation search.
pythonclaims = extract_claims(llm_answer)
for claim in claims:
score = nli_model(premise=source_docs,
hypothesis=claim)
// entail / neutral / contradict
if score == "contradict": flag(claim)Applicable
- medicine
- jurisprudence
- finance
- RAG QA
25resilienceFallback Chain - model degradation
If the main model fails, automatic transition to the backup model occurs. Hierarchy: first the expensive model, in case of timeout/error - cheaper, then deterministic fallback.
texttry: return cloud_opus(prompt)
except:
try: return gpt4o(prompt)
except:
try: return cloud_haiku(prompt)
except: return "The service is temporarily unavailable"Applicable
- production SLA
- multi-vendor strategy
26safetyGuardrails - input/output filters
Security layer before and after the LLM call. Input guardrails: toxicity, PII detection, jailbreak detection. Output guardrails: checking for admissibility, filtering personal data, subject restrictions.
textuser_input
→ [input_guard] → moderation, PII-masking
→ LLM(safe_input)
→ [output_guard] → toxic filter, PII-unmask
→ userApplicable
- B2C products
- GDPR compliance
- corporate chatbots
Retrieval Patterns
27retrievalHybrid Search (BM25 + Vector)
A combination of keyword search (BM25/TF-IDF) and semantic (vector) search. BM25 is precise for exact terms and abbreviations, vector for meaning. RRF (Reciprocal Rank Fusion) combines ranks.
texscore(doc) = Σ 1 / (k + rank_i(doc))
// k=60 — smoothing constant
// summarized across all search engines
bm25_results + vector_results → RRF → unified_top_kApplicable
- enterprise search
- technical documentation
28retrievalMulti-Query Retrieval
LLM generates N rephrases of the original query, each searched in the index, the results deduplicated and merged. Covers different semantic aspects of one question.
pythonquery → LLM → [q1, q2, q3, q4] // N options
[search(q) for q in queries] // in parallel
→ deduplicate → top-k → LLMApplicable
- Low recall RAG
- multidimensional issues
29retrievalIterative / Adaptive Retrieval
After the initial response, the model determines what knowledge is missing, formulates a follow-up query and performs an additional search. The cycle continues until the context is complete. This is a RAG with an internal feedback loop.
pythoncontext = []
while not sufficient(context):
gaps = LLM(f"What is missing for the answer? {context}")
new_docs = search(gaps)
context.extend(new_docs)
return LLM(query, context)Applicable
- deep research
- analytical reports
30retrievalParent Document Retrieval
Index small chunks for precise search, but pass their parent (large) chunks into the context. Search accuracy + context completeness. Different granularities for different tasks.
textIndex: small_chunks (128 tokens) → embeddings
Storage: parent_chunks (512 tokens)
query → search(small_chunks) → top-k small
→ fetch parent(small_chunk) → into LLM contextApplicable
- legal documents
- technical manuals
Memory & State
31memorySummarization Memory
When the dialogue history exceeds the context window, compress old messages into a compact summary, leaving new ones complete. Rolling summary is updated with each new message.
pythonif len(history) > threshold:
old = history[:-10]
summary = LLM(f"Summary: {old}")
history = [summary_msg(summary)] + history[-10:]Applicable
- long dialogues
- assistants
32memoryEntity Memory
Extracting and accumulating information about entities (people, companies, products) from the dialogue into a separate store. The next time an entity is mentioned, its profile is pulled into the context.
textentity_store = {}
msg → LLM extract → {Ivan: “CTO”, “loves Python”}
entity_store["Ivan"].update(...)
// with a new message:
context += entity_store.get(detected_entities)Applicable
- CRM bots
- personalization
- sales assistants
33memoryEpisodic Memory (Vector Store)
Past interactions are saved as embeddings. With a new request, search for semantically similar episodes from the past and add them to the context. Long-term memory without storing a full log.
textafter each dialogue:
store(embed(summary), metadata)
on a new request:
memories = search(embed(query), top_k=3)
context = format_memories(memories) + queryApplicable
- personal assistants
- Mem0
- MemGPT
34memoryScratchpad / Working Memory
Allocation of a special zone in the prompt for intermediate calculations, notes and agent state. The model writes to the scratchpad during reasoning and reads from it - this is external “working memory”.
text[SCRATCHPAD]
Facts: X=42, Y=18
Previous step: found document #3
Current goal: check date
[/SCRATCHPAD]
[TASK] next step...Applicable
- agent systems
- multi-step reasoning
Agentic Patterns
35agenticTool Use / Function Calling
LLM decides when and which tool to call, generates call parameters, receives the result and continues reasoning. Tools: search, calculator, database, API, browser, interpreter code.
textLLM → tool_call: {name: "search", args: {q: "..."}}
System → tool_result: "..."
LLM → tool_call: {name: "calculator", args: {...}}
System → tool_result: 42
LLM → final_answer: "Answer: 42"Applicable
- automation
- data analysis
- code execution
36agenticReflection - agent self-criticism
After performing an action, the agent reflects: what happened, what went wrong, what needs to be corrected. This is a supervised self-improvement within one inference loop without updating the weights.
textaction = Agent.act(state)
result = env.step(action)
reflection = Agent.reflect(action, result)
// "I used the wrong tool because..."
next_action = Agent.act(state, reflection)Applicable
- coding agents
- Reflexion (paper)
- debugging
37agenticMulti-Agent Orchestration
Several LLM agents with different roles interact through a common message bus or hierarchically. Orchestrator delegates tasks to specialized subagents and collects the results. Allows you to solve problems that require parallel expertise in different domains.
textOrchestrator
├── delegate("market analysis") ──→ Research Agent → report
├── delegate("financial model") ──→ Finance Agent → spreadsheet
└── delegate("presentation") ──→ Writer Agent → slides
↓ fan-in ↓
Orchestrator(report, spreadsheet, slides) → finalApplicable
- complex business processes
- AutoGen
- CrewAI
- parallel tasks with different expertise
38agenticCritic Agent (Constitutional AI-style)
A dedicated critical agent looks at the output of the main agent and issues specific comments based on the specified criteria (checklist). The main agent fixes it. The critic can be stronger than the main one - asymmetry is useful.
textdraft = Worker(task)
critique = Critic(draft, criteria=[
"accuracy of facts", "structure", "style"
])
final = Worker(task, critique=critique)Applicable
- quality of content
- code review
- safety
39reasoningTree of Thoughts (ToT)
CoT extension: instead of one chain, there is a tree of reasoning options. At each step, N continuations are generated, they are evaluated, and beam search selects the best. Expensive, but powerful for complex planning.
pythonthoughts = [initial_thought]
for depth in range(max_depth):
candidates = []
for t in thoughts:
candidates += generate_k_continuations(t, k=3)
thoughts = evaluate_and_prune(candidates, keep=beam_w)Applicable
- game playing
- creative writing
- complex planning
Output Processing
40outputConstrained Decoding / Guided Generation
Forced limitation of token space during generation at the logits level. Outlines/LMQL/Guidance masks invalid tokens at every moment of time - 100% guarantee of valid JSON/regex without retry.
textschema = {"type": "object", "properties": {...}}
// at each generation step:
valid_tokens = grammar.get_valid_next_tokens(current_state)
logits[~valid_tokens] = -inf // masking
next_token = sample(softmax(logits))Applicable
- self-hosted models
- critical structured conclusions
41outputOutput Post-Processing Pipeline
After receiving the LLM output, a chain of deterministic transformations: strip markdown, extract JSON, normalize, deduplicate, sort, format. The less logic you put on LLM, the more predictable the system.
textraw = llm_response
→ strip_think_tags(raw) // remove <think>
→ extract_json(raw) // regex/parser
→ validate_schema(json) // pydantic
→ normalize_values(json) // types, case
→ enrich_from_db(json) // join with dataApplicable
- production pipelines
- downstream integration
42outputStreaming + Incremental Processing
Processing tokens as they are generated - without waiting for a complete response. Allows you to terminate generation early (early stopping), show progress to the user, and process the beginning of the response in parallel.
pythonfor token in llm.stream(prompt):
buffer += token
if detect_complete_sentence(buffer):
yield process_sentence(buffer)
buffer = ""
if should_stop_early(buffer):
llm.cancel()Applicable
- UX
- cost optimization
- real-time apps
Optimization & Cost
43optimizationPrompt Compression (LLMLingua)
Compress long context before sending to expensive model. The small model evaluates the “importance” of each token and removes the unimportant ones. 4-10x compression with minimal quality loss.
textsmall_lm.score_tokens(long_context)
→ perplexity per token
→ drop low-perplexity tokens (predictable/noisy)
→ compressed_context (10-25% of the original)
→ expensive_llm(compressed_context)Applicable
- cost reduction
- long documents → expensive models
44optimizationSemantic Caching
Caching responses not by exact string match, but by semantic proximity of the request. If cosine distance < threshold - return cache. Reduces costs on repeated requests in different formulations.
pythonq_emb = embed(query)
cached = search_cache(q_emb, threshold=0.95)
if cached: return cached.response // hit
response = LLM(query) // miss
cache.store(q_emb, response)
return responseApplicable
- FAQ bots
- high-load products
45optimizationModel Routing — Small/Large
The query complexity classifier directs simple queries to the cheap, fast model, and complex queries to the expensive one. 70-80% of queries in an average product are simple. RouteLLM, LLM Router.
pythoncomplexity = classifier(query) // fast, cheap
if complexity < 0.4:
return haiku(query) // $0.25/M tokens
elif complexity < 0.8:
return sonnet(query) // $3/M tokens
else:
return opus(query) // $15/M tokensApplicable
- cost reduction up to 5x
- latency optimization
46latencySpeculative Execution (Draft Model)
The small draft model generates K tokens quickly, the large model verifies them in one forward pass. Accepted tokens are free, rejected tokens are regenerated. 2-3x speedup with the same accuracy.
textdraft_tokens = small_model.generate(k=5) // fast
accepted = large_model.verify(draft_tokens) // 1 forward
// accept matches, regenerate the first non-matchApplicable
- self-hosted models
- latency-sensitive products
47optimizationPrompt Caching (KV Cache Reuse)
Anthropic and OpenAI support caching of KV cache prefixes. If system prompt + context are the same between requests, they are not recalculated. Up to 90% savings on prefill tokens for long system prompts.
textStructure the prompt: static → up, dynamic → down
[system + docs + examples] ← cached
────────────────────────────
[user query] ← changes every time
→ Anthropic: cache_control: {"type": "ephemeral"}Applicable
- long system prompts
- RAG with fixed context
No dead end
Keep moving through the map.
Continue in sequence, switch to a related guide, or return to the seven-track learning map.