RAG Wrapper Patterns
Patterns for augmenting any agent with Qdrant context retrieval.
Quick Start
To wrap an agent with RAG:
Use rag-proxy agent: Target: {agent-to-wrap} Task: {the task}
Manual Wrapping Pattern
If you need custom control, follow this pattern:
Step 1: Query Relevant Context
Tool: qdrant-find Query: {key terms from task}
Step 2: Format Context Block
Retrieved Context
Source: {metadata.source}
Harvested: {metadata.harvested_at} Type: {metadata.type}
{document content}
Step 3: Prepend to Task
{context blocks}
Task
{original task}
Note: Above context is from stored knowledge. Verify if needed.
Step 4: Delegate
Tool: Task Agent: {target-agent} Prompt: {enriched prompt}
Enriched Prompt Template
Context from Stored Knowledge
The following relevant information was retrieved from project memory:
{{#each contexts}}
From Qdrant
Source: {{metadata.source}} Harvested: {{metadata.harvested_at}}
{{content}}
{{/each}}
Your Task
{{original_task}}
Note: The context above comes from previously harvested research.
Use it if relevant, but verify currency for time-sensitive information.
The harvested_at dates indicate when the content was stored.
Selective Wrapping
Not all tasks need RAG. Skip for:
Task Type Wrap? Reason
Fresh research No Need current, not cached data
Simple edits No Context not needed
RAG-aware agents No Already query Qdrant
Implementation Yes Benefit from patterns, decisions
Debugging Yes Previous solutions may help
Architecture Yes Decisions and constraints matter
Agent-Collection Affinity
Map agent types to useful query topics:
Agent Type Query Topics
frontend-developer react, design system, components
backend-architect api, architecture, decisions
security-auditor security, authentication, vulnerabilities
devops infrastructure, terraform, deployment
tester testing, coverage, quality
Storing Results
After the target agent completes:
Tool: qdrant-store Information: "<valuable findings>" Metadata: source: "agent-output" type: "generated" harvested_at: "<ISO date>" tags: "<relevant,keywords>"
Error Handling
Scenario Action
Empty query results Proceed without context
Qdrant unavailable Fall back to unwrapped delegation
Target agent fails Report error, don't retry with less context