Adding Fact Triplets

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}")

1
from zep_cloud.client import Zep
2
import time
3
4
client = Zep(api_key=API_KEY)
5
6
# Add a fact triple
7
result = client.graph.add_fact_triple(
8
    user_id=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
task_id = result.task_id
16
17
# Poll until the task completes
18
while True:
19
    task = client.task.get(task_id=task_id)
20
21
    if task.status == "succeeded":
22
        break
23
    elif task.status == "failed":
24
        raise Exception(f"Task failed: {task.error}")
25
26
    time.sleep(1)
27
28
# Retrieve the created UUIDs from task.params
29
edge_uuid = task.params.get("edge_uuid")
30
source_node_uuid = task.params.get("source_node_uuid")
31
target_node_uuid = task.params.get("target_node_uuid")
32
33
print(f"Edge UUID: {edge_uuid}")
34
print(f"Source Node UUID: {source_node_uuid}")
35
print(f"Target Node UUID: {target_node_uuid}")

1
from zep_cloud.client import Zep
2
3
client = Zep(api_key=API_KEY)
4
5
# Assumes your ontology defines:
6
# - Entity type "Person" with properties: { "age": int, "role": text }
7
# - Edge type "WORKS_AT" with properties: { "start_year": int, "department": text }
8
9
result = client.graph.add_fact_triple(
10
    user_id=user_id,
11
    fact="Alice works at Acme Corp",
12
    fact_name="WORKS_AT",                     # matches edge type in ontology
13
    source_node_name="Alice",
14
    source_node_labels=["Person"],            # matches entity type "Person" in ontology
15
    source_node_attributes={
16
        "age": 30,                            # validated: must be int
17
        "role": "Engineer",                   # validated: must be text
18
    },
19
    target_node_name="Acme Corp",
20
    target_node_labels=["Organization"],      # not in ontology — passes through freely
21
    edge_attributes={
22
        "start_year": 2021,                   # validated against WORKS_AT schema
23
        "department": "Engineering",
24
    },
25
)