graphiti/core/edges.py
Pavlo Paliychuk ad552b527e
Cleanup maintenance utilities + add podcast runner (#5)
* chore: Fix minor issues with episodic edge building + cleanup

* feat: Port podcast runner

* feat: Port podcast runner
2024-08-16 09:29:57 -04:00

114 lines
3.6 KiB
Python

from abc import ABC, abstractmethod
from pydantic import BaseModel, Field
from datetime import datetime
from neo4j import AsyncDriver
from uuid import uuid4
import logging
from core.nodes import Node
logger = logging.getLogger(__name__)
class Edge(BaseModel, ABC):
uuid: str = Field(default_factory=lambda: str(uuid4()))
source_node: Node
target_node: Node
created_at: datetime
@abstractmethod
async def save(self, driver: AsyncDriver): ...
def __hash__(self):
return hash(self.uuid)
def __eq__(self, other):
if isinstance(other, Node):
return self.uuid == other.uuid
return False
class EpisodicEdge(Edge):
async def save(self, driver: AsyncDriver):
if self.uuid is None:
uuid = uuid4()
logger.info(f"Created uuid: {uuid} for episodic edge")
self.uuid = str(uuid)
result = await driver.execute_query(
"""
MATCH (episode:Episodic {uuid: $episode_uuid})
MATCH (node:Entity {uuid: $entity_uuid})
MERGE (episode)-[r:MENTIONS {uuid: $uuid}]->(node)
SET r = {uuid: $uuid, created_at: $created_at}
RETURN r.uuid AS uuid""",
episode_uuid=self.source_node.uuid,
entity_uuid=self.target_node.uuid,
uuid=self.uuid,
created_at=self.created_at,
)
logger.info(f"Saved edge to neo4j: {self.uuid}")
return result
# TODO: Neo4j doesn't support variables for edge types and labels.
# Right now we have all edge nodes as type RELATES_TO
class EntityEdge(Edge):
name: str = Field(description="name of the edge, relation name")
fact: str = Field(
description="fact representing the edge and nodes that it connects"
)
fact_embedding: list[float] | None = Field(
default=None, description="embedding of the fact"
)
episodes: list[str] | None = Field(
default=None,
description="list of episode ids that reference these entity edges",
)
expired_at: datetime | None = Field(
default=None, description="datetime of when the node was invalidated"
)
valid_at: datetime | None = Field(
default=None, description="datetime of when the fact became true"
)
invalid_at: datetime | None = Field(
default=None, description="datetime of when the fact stopped being true"
)
def generate_embedding(self, embedder, model="text-embedding-3-large"):
text = self.fact.replace("\n", " ")
embedding = embedder.create(input=[text], model=model).data[0].embedding
self.fact_embedding = embedding
return embedding
async def save(self, driver: AsyncDriver):
result = await driver.execute_query(
"""
MATCH (source:Entity {uuid: $source_uuid})
MATCH (target:Entity {uuid: $target_uuid})
MERGE (source)-[r:RELATES_TO {uuid: $uuid}]->(target)
SET r = {uuid: $uuid, name: $name, fact: $fact, fact_embedding: $fact_embedding,
episodes: $episodes, created_at: $created_at, expired_at: $expired_at,
valid_at: $valid_at, invalid_at: $invalid_at}
RETURN r.uuid AS uuid""",
source_uuid=self.source_node.uuid,
target_uuid=self.target_node.uuid,
uuid=self.uuid,
name=self.name,
fact=self.fact,
fact_embedding=self.fact_embedding,
episodes=self.episodes,
created_at=self.created_at,
expired_at=self.expired_at,
valid_at=self.valid_at,
invalid_at=self.invalid_at,
)
logger.info(f"Saved Node to neo4j: {self.uuid}")
return result