Adding Fact Triplets

Overview

You can add manually specified fact/node triplets to the graph. You need only specify the fact, the target node name, and the source node name. Zep will then create a new corresponding edge and nodes, or use an existing edge/nodes if they exist and seem to represent the same nodes or edge you send as input. And if this new fact invalidates an existing fact, it will mark the existing fact as invalid and add the new fact triplet.

The add_fact_triple method returns a task_id that can be used to track the processing status of the operation. See the Check Data Ingestion Status recipe for how to poll task status.

Adding a Fact Triplet

1
from zep_cloud.client import Zep
2
3
client = Zep(
4
    api_key=API_KEY,
5
)
6
7
result = client.graph.add_fact_triple(
8
    user_id=user_id,  # Optional: You can use graph_id instead of user_id
9
    fact="Paul met Eric",
10
    fact_name="MET",
11
    target_node_name="Eric Clapton",
12
    source_node_name="Paul",
13
)
14
15
# The result includes a task_id for tracking processing status
16
task_id = result.task_id
17
print(f"Fact triple task ID: {task_id}")

Advanced Options

You can also specify the node summaries, edge temporal data, and UUIDs. See the associated SDK reference for complete details on all available parameters.