agrag.ingestion

The ingestion package.

Modules:

• community – Community detection: hierarchical Leiden over the entity graph.
• extract – The Extractor interface: reads one Chunk and produces an ExtractionResult.
• graph – The public Graph API for ingestion.
• merge – Merge mechanics: how a resolved group of mentions and entities combine.
• reports – Reports returned by Graph pipeline operations.
• resolve – Entity resolution public API.
• resolved_embeddings – Embedding writes and sync status for resolved entities.
• resolved_entities – Non-destructive match persistence and resolved-entity computation.
• settings – Configuration for ingestion: the Cutover Job and local extraction.
• stats – Per-stage observability types for the ingestion pipeline.

Classes:

• AddResult – Return type of Graph.add(). One summary per pipeline stage.
• BAMLExtractor – Extract entities and relations with an LLM through a typed BAML function.
• CommunityDetectionReport – Report from Graph.detect_communities().
• ConsolidationReport – Report from Graph.consolidate().
• EscalationReport – How many chunks the LLM extractor read, and how many it left alone.
• ExtractionLLMSettings – Env-backed LLM client configuration for the extraction role.
• ExtractionSettings – Configuration for local entity and relation extraction.
• Extractor – Reads one chunk and returns the entities and relations it contains.
• ExtractorMissingExtraError – An Extractor needs a package extra that is not installed.
• GlinerExtractor – Extracts entities and relations with a local GLiNER2.5 model.
• Graph – A knowledge graph that a caller can open and add content to.
• LLMExtractor – LLM role that may receive entities found by an earlier extractor.
• ReevaluationReport – Report from Graph.reevaluate().
• UnparsableExtractionError – The LLM replied, but the reply holds no JSON answer.
• UpdateResult – Summary of an update or soft deletion.