Graphs

Configure your R2R graph system.

R2R supports robust knowledge graph functionality to enhance document understanding and retrieval.

By default, R2R creates graphs by first extracting the entities and relationships associated with a given document. Next collections can be formed out of your ingested documents. For each collection, a corresponding graph can be built over the input documents.

You can find out more about this with the knowledge graph cookbook and the GraphRAG cookbook. To configure the knowledge graph settings for your project, edit the database section in your r2r.toml file:

r2r.toml
1[database]
2provider = "postgres"
3batch_size = 256
4
5  [database.graph_creation_settings]
6    entity_types = [] # if empty, all entities are extracted
7    relation_types = [] # if empty, all relations are extracted
8    generation_config = { model = "openai/gpt-4o-mini" }
9    max_knowledge_triples = 100 # max number of triples to extract for each document chunk
10    fragment_merge_count = 4 # number of fragments to merge into a single extraction
11
12  [database.graph_enrichment_settings]
13    max_description_input_length = 65536 # increase if you want more comprehensive descriptions
14    max_summary_input_length = 65536
15    generation_config = { model = "openai/gpt-4o-mini" } # and other generation params below
16    leiden_params = {}
17
18  [database.graph_settings]
19    generation_config = { model = "openai/gpt-4o-mini" }

Let’s break down the knowledge graph configuration options:

  • provider: Specifies the knowledge graph provider. Currently, “postgres” is supported.
  • batch_size: Determines the number of entities or relationships to process in a single batch during import operations.
  • kg_triples_extraction_prompt: Specifies the prompt template to use for extracting knowledge graph information from text.
  • graph_creation_settings: Configuration for the model used in knowledge graph creation.
    • max_knowledge_triples: The maximum number of knowledge triples to extract for each document chunk.
    • fragment_merge_count: The number of fragments to merge into a single extraction.
    • generation_config: Configuration for the model used in knowledge graph creation.
  • graph_enrichment_settings: Similar configuration for the model used in knowledge graph enrichment.
    • generation_config: Configuration for the model used in knowledge graph enrichment.
    • leiden_params: Parameters for the Leiden algorithm.
  • graph_settings: Similar configuration for the model used in knowledge graph search operations.

Setting configuration values in the r2r.toml will override environment variables by default.

Knowledge Graph Operations

  1. Entity Management: Add, update, and retrieve entities in the knowledge graph.
  2. Relationship Management: Create and query relationships between entities.
  3. Batch Import: Efficiently import large amounts of data using batched operations.
  4. Vector Search: Perform similarity searches on entity embeddings.
  5. Community Detection: Identify and manage communities within the graph.

Customization

You can customize the knowledge graph extraction and search processes by modifying the kg_triples_extraction_prompt and adjusting the model configurations in kg_extraction_settings and graph_settings. Moreover, you can customize the LLM models used in various parts of the knowledge graph creation process. All of these options can be selected at runtime, with the only exception being the specified database provider. For more details, refer to the knowledge graph settings in the search API.

By leveraging the knowledge graph capabilities, you can enhance R2R’s understanding of document relationships and improve the quality of search and retrieval operations.

Next Steps

For more detailed information on configuring specific components of the ingestion pipeline, please refer to the following pages: