graphiti/core/prompts/dedupe_edges.py

import json
from typing import Protocol, TypedDict

from .models import Message, PromptFunction, PromptVersion


class Prompt(Protocol):
    v1: PromptVersion
    edge_list: PromptVersion


class Versions(TypedDict):
    v1: PromptFunction
    edge_list: PromptFunction


def v1(context: dict[str, any]) -> list[Message]:
    return [
        Message(
            role="system",
            content="You are a helpful assistant that de-duplicates relationship from edge lists.",
        ),
        Message(
            role="user",
            content=f"""
        Given the following context, deduplicate edges from a list of new edges given a list of existing edges:

        Existing Edges:
        {json.dumps(context['existing_edges'], indent=2)}

        New Edges:
        {json.dumps(context['extracted_edges'], indent=2)}

        Task:
        1. start with the list of edges from New Edges
        2. If any edge in New Edges is a duplicate of an edge in Existing Edges, replace the new edge with the existing
            edge in the list
        3. Respond with the resulting list of edges

        Guidelines:
        1. Use both the name and fact of edges to determine if they are duplicates, 
            duplicate edges may have different names

        Respond with a JSON object in the following format:
        {{
            "new_edges": [
                {{
                    "fact": "one sentence description of the fact"
                }}
            ]
        }}
        """,
        ),
    ]


def edge_list(context: dict[str, any]) -> list[Message]:
    return [
        Message(
            role="system",
            content="You are a helpful assistant that de-duplicates edges from edge lists.",
        ),
        Message(
            role="user",
            content=f"""
        Given the following context, find all of the duplicates in a list of edges:

        Edges:
        {json.dumps(context['edges'], indent=2)}

        Task:
        If any edge in Edges is a duplicate of another edge, return the fact of only one of the duplicate edges

        Guidelines:
        1. Use both the name and fact of edges to determine if they are duplicates, 
            edges with the same name may not be duplicates
        2. The final list should have only unique facts. If 3 edges are all duplicates of each other, only one of their
            facts should be in the response

        Respond with a JSON object in the following format:
        {{
            "unique_edges": [
                {{
                    "fact": "fact of a unique edge",
                }}
            ]
        }}
        """,
        ),
    ]


versions: Versions = {"v1": v1, "edge_list": edge_list}