Add knowledge graph manipulation endpoints #2183
Conversation
Added three new REST API endpoints for direct knowledge graph manipulation: - POST /graph/entity/create: Create new entities in the knowledge graph - POST /graph/relation/create: Create relationships between entities - POST /graph/entities/merge: Merge duplicate/misspelled entities while preserving relationships The merge endpoint is particularly useful for consolidating entities discovered after document processing, fixing spelling errors, and cleaning up the knowledge graph. All relationships from source entities are transferred to the target entity, with intelligent handling of duplicate relationships. Updated API documentation in lightrag/api/README.md with usage examples for all three endpoints.
|
@codex review |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting
- Changed create_entity to use rag.acreate_entity() instead of direct graph manipulation - Changed create_relation to use rag.acreate_relation() instead of direct graph manipulation - This ensures vector embeddings are created and entities/relations are searchable - Adds proper concurrency locks and metadata population
|
@codex review again |
|
Codex Review: Didn't find any major issues. Keep it up! ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting |
|
If all good, please merge. |
|
Thanks for sharing. |
|
Thanks for the review and merge. I look forward to continue contributing. |
3 participants
Added three new REST API endpoints for direct knowledge graph manipulation:
The merge endpoint is particularly useful for consolidating entities discovered after document processing, fixing spelling errors, and cleaning up the knowledge graph. All relationships from source entities are transferred to the target entity, with intelligent handling of duplicate relationships.
Updated API documentation in lightrag/api/README.md with usage examples for all three endpoints.
Added three new REST API endpoints for direct knowledge graph manipulation, enabling users to create entities, create relationships, and merge duplicate
or misspelled entities while preserving their relationships.
Related Issues
Addresses the need for manual knowledge graph cleanup and entity consolidation after document processing, particularly for fixing misspelled entity
names and merging duplicate entities.
Changes Made
Checklist
Additional Notes
The merge endpoint leverages the existing amerge_entities functionality in the LightRAG core library, which intelligently handles relationship transfer,
duplicate relationship merging, and vector embedding updates. This feature is particularly valuable for post-processing knowledge graphs where entity
name variations or spelling errors create fragmented graph structures.