Contextual Enrichment

In modern Retrieval-Augmented Generation (RAG) systems, like R2R, documents are systematically broken down into smaller, manageable pieces called chunks. While chunking is essential for efficient vector search operations, these individual chunks sometimes lack the broader context needed for comprehensive question answering or analysis tasks.

The Challenge of Context Loss

Let’s examine a real-world example using Lyft’s 2021 annual report (Form 10-K) from their public filing.

During ingestion, this 200+ page document is broken into 1,223 distinct chunks. Consider this isolated chunk:

storing unrented and returned vehicles. These impacts to the demand for and operations of the different rental programs have and may continue to adversely affect our business, financial condition and results of operation.

Reading this chunk in isolation raises several questions:

• What specific impacts are being discussed?
• Which rental programs are affected?
• What’s the broader context of these business challenges?

This is where contextual enrichment becomes invaluable.

Introducing Contextual Enrichment

Contextual enrichment an ingestiont echnique that enhances chunks with relevant information from surrounding or semantically related content. Think of it as giving each chunk its own “memory” of related information.

Enabling Enrichment

To activate this feature, configure your r2r.toml file with the following settings:

1
[ingestion.chunk_enrichment_settings]
2
    enable_chunk_enrichment = true # disabled by default
3
    strategies = ["semantic", "neighborhood"]
4
    forward_chunks = 3            # Look ahead 3 chunks
5
    backward_chunks = 3           # Look behind 3 chunks
6
    semantic_neighbors = 10       # Find 10 semantically similar chunks
7
    semantic_similarity_threshold = 0.7  # Minimum similarity score
8
    generation_config = { model = "openai/gpt-4o-mini" }

Enrichment Strategies Explained

R2R implements two sophisticated strategies for chunk enrichment:

1. Neighborhood Strategy

This approach looks at the document’s natural flow by examining chunks that come before and after the target chunk:

• Forward Looking: Captures upcoming context (configurable, default: 3 chunks)
• Backward Looking: Incorporates previous context (configurable, default: 3 chunks)
• Use Case: Particularly effective for narrative documents where context flows linearly

2. Semantic Strategy

This method uses advanced embedding similarity to find related content throughout the document:

• Vector Similarity: Identifies chunks with similar meaning regardless of location
• Configurable Neighbors: Customizable number of similar chunks to consider
• Similarity Threshold: Set minimum similarity scores to ensure relevance
• Use Case: Excellent for documents with themes repeated across different sections

The Enrichment Process

When enriching chunks, R2R uses a carefully crafted prompt to guide the LLM:

## Task:
Enrich and refine the given chunk of text using information from the provided context chunks. The goal is to make the chunk more precise and self-contained.
## Context Chunks:
{context_chunks}
## Chunk to Enrich:
{chunk}
## Instructions:
1. Rewrite the chunk in third person.
2. Replace all common nouns with appropriate proper nouns.
3. Use information from the context chunks to enhance clarity.
4. Ensure the enriched chunk remains independent and self-contained.
5. Maintain original scope without bleeding information.
6. Focus on precision and informativeness.
7. Preserve original meaning while improving clarity.
8. Output only the enriched chunk.
## Enriched Chunk:

Implementation and Results

To process your documents with enrichment:

$
r2r documents create --file_path path/to/lyft_2021.pdf

Viewing Enriched Results

Access your enriched chunks through the API:

curl -X GET http://localhost:7272/v3/document/{document_id}/chunks

Let’s compare the before and after of our example chunk:

Before Enrichment:

storing unrented and returned vehicles. These impacts to the demand for and operations of the different rental programs have and may continue to adversely affect our business, financial condition and results of operation.

After Enrichment:

The impacts of the COVID-19 pandemic on the demand for and operations of the various vehicle rental programs, including Lyft Rentals and the Express Drive program, have resulted in challenges regarding the storage of unrented and returned vehicles. These adverse conditions are anticipated to continue affecting Lyft's overall business performance, financial condition, and operational results.

Notice how the enriched version:

• Specifies the cause (COVID-19 pandemic)
• Names specific programs (Lyft Rentals, Express Drive)
• Provides clearer context about the business impact
• Maintains professional, third-person tone

Metadata and Storage

The system maintains both enriched and original versions:

1
{
2
    "results": [
3
        {
4
            "text": "enriched_version",
5
            "metadata": {
6
                "original_text": "original_version",
7
                "chunk_enrichment_status": "success",
8
                // ... additional metadata ...
9
            }
10
        }
11
    ]
12
}

This dual storage ensures transparency and allows for version comparison when needed.

Best Practices

1. Tune Your Parameters: Adjust forward_chunks, backward_chunks, and semantic_neighbors based on your document structure
2. Monitor Enrichment Quality: Regularly review enriched chunks to ensure they maintain accuracy
3. Consider Document Type: Different documents may benefit from different enrichment strategies
4. Balance Context Size: More context isn’t always better - find the sweet spot for your use case