graphiti-core 0.22.0rc1__py3-none-any.whl → 0.22.0rc3__py3-none-any.whl

graphiti_core/prompts/extract_nodes.py

@@ -18,49 +18,48 @@ from typing import Any, Protocol, TypedDict
 
 from pydantic import BaseModel, Field
 
+from graphiti_core.utils.text_utils import MAX_SUMMARY_CHARS
+
 from .models import Message, PromptFunction, PromptVersion
 from .prompt_helpers import to_prompt_json
+from .snippets import summary_instructions
 
 
 class ExtractedEntity(BaseModel):
-    name: str = Field(..., description="Name of the extracted entity")
+    name: str = Field(..., description='Name of the extracted entity')
     entity_type_id: int = Field(
-        description="ID of the classified entity type. "
-        "Must be one of the provided entity_type_id integers.",
+        description='ID of the classified entity type. '
+        'Must be one of the provided entity_type_id integers.',
     )
 
 
 class ExtractedEntities(BaseModel):
-    extracted_entities: list[ExtractedEntity] = Field(
-        ..., description="List of extracted entities"
-    )
+    extracted_entities: list[ExtractedEntity] = Field(..., description='List of extracted entities')
 
 
 class MissedEntities(BaseModel):
-    missed_entities: list[str] = Field(
-        ..., description="Names of entities that weren't extracted"
-    )
+    missed_entities: list[str] = Field(..., description="Names of entities that weren't extracted")
 
 
 class EntityClassificationTriple(BaseModel):
-    uuid: str = Field(description="UUID of the entity")
-    name: str = Field(description="Name of the entity")
+    uuid: str = Field(description='UUID of the entity')
+    name: str = Field(description='Name of the entity')
     entity_type: str | None = Field(
         default=None,
-        description="Type of the entity. Must be one of the provided types or None",
+        description='Type of the entity. Must be one of the provided types or None',
     )
 
 
 class EntityClassification(BaseModel):
     entity_classifications: list[EntityClassificationTriple] = Field(
-        ..., description="List of entities classification triples."
+        ..., description='List of entities classification triples.'
     )
 
 
 class EntitySummary(BaseModel):
     summary: str = Field(
         ...,
-        description="Summary containing the important information about the entity. Under 8 sentences.",
+        description=f'Summary containing the important information about the entity. Under {MAX_SUMMARY_CHARS} characters.',
     )
 
 
@@ -128,8 +127,8 @@ reference entities. Only extract distinct entities from the CURRENT MESSAGE. Don
 {context['custom_prompt']}
 """
     return [
-        Message(role="system", content=sys_prompt),
-        Message(role="user", content=user_prompt),
+        Message(role='system', content=sys_prompt),
+        Message(role='user', content=user_prompt),
     ]
 
 
@@ -161,8 +160,8 @@ Guidelines:
 3. Do NOT extract any properties that contain dates
 """
     return [
-        Message(role="system", content=sys_prompt),
-        Message(role="user", content=user_prompt),
+        Message(role='system', content=sys_prompt),
+        Message(role='user', content=user_prompt),
     ]
 
 
@@ -192,8 +191,8 @@ Guidelines:
 4. Be as explicit as possible in your node names, using full names and avoiding abbreviations.
 """
     return [
-        Message(role="system", content=sys_prompt),
-        Message(role="user", content=user_prompt),
+        Message(role='system', content=sys_prompt),
+        Message(role='user', content=user_prompt),
     ]
 
 
@@ -216,8 +215,8 @@ Given the above previous messages, current message, and list of extracted entiti
 extracted.
 """
     return [
-        Message(role="system", content=sys_prompt),
-        Message(role="user", content=user_prompt),
+        Message(role='system', content=sys_prompt),
+        Message(role='user', content=user_prompt),
     ]
 
 
@@ -248,32 +247,31 @@ def classify_nodes(context: dict[str, Any]) -> list[Message]:
     3. If none of the provided entity types accurately classify an extracted node, the type should be set to None
 """
     return [
-        Message(role="system", content=sys_prompt),
-        Message(role="user", content=user_prompt),
+        Message(role='system', content=sys_prompt),
+        Message(role='user', content=user_prompt),
     ]
 
 
 def extract_attributes(context: dict[str, Any]) -> list[Message]:
     return [
         Message(
-            role="system",
-            content="You are a helpful assistant that extracts entity properties from the provided text.",
+            role='system',
+            content='You are a helpful assistant that extracts entity properties from the provided text.',
         ),
         Message(
-            role="user",
+            role='user',
             content=f"""
-
-        <MESSAGES>
-        {to_prompt_json(context['previous_episodes'], indent=2)}
-        {to_prompt_json(context['episode_content'], indent=2)}
-        </MESSAGES>
-
-        Given the above MESSAGES and the following ENTITY, update any of its attributes based on the information provided
+        Given the MESSAGES and the following ENTITY, update any of its attributes based on the information provided
         in MESSAGES. Use the provided attribute descriptions to better understand how each attribute should be determined.
 
         Guidelines:
         1. Do not hallucinate entity property values if they cannot be found in the current context.
         2. Only use the provided MESSAGES and ENTITY to set attribute values.
+
+        <MESSAGES>
+        {to_prompt_json(context['previous_episodes'], indent=2)}
+        {to_prompt_json(context['episode_content'], indent=2)}
+        </MESSAGES>
         
         <ENTITY>
         {context['node']}
@@ -286,27 +284,22 @@ def extract_attributes(context: dict[str, Any]) -> list[Message]:
 def extract_summary(context: dict[str, Any]) -> list[Message]:
     return [
         Message(
-            role="system",
-            content="You are a helpful assistant that extracts entity summaries from the provided text.",
+            role='system',
+            content='You are a helpful assistant that extracts entity summaries from the provided text.',
         ),
         Message(
-            role="user",
+            role='user',
             content=f"""
+        Given the MESSAGES and the ENTITY, update the summary that combines relevant information about the entity
+        from the messages and relevant information from the existing summary.
+        
+        {summary_instructions}
 
         <MESSAGES>
         {to_prompt_json(context['previous_episodes'], indent=2)}
         {to_prompt_json(context['episode_content'], indent=2)}
         </MESSAGES>
 
-        Given the above MESSAGES and the following ENTITY, update the summary that combines relevant information about the entity
-        from the messages and relevant information from the existing summary.
-        
-        Guidelines:
-        1. Do not hallucinate entity summary information if they cannot be found in the current context.
-        2. Only use the provided MESSAGES and ENTITY to set attribute values.
-        3. The summary attribute represents a summary of the ENTITY, and should be updated with new information about the Entity from the MESSAGES. 
-        4. Keep the summary concise and to the point. SUMMARIES MUST BE LESS THAN 8 SENTENCES.
-
         <ENTITY>
         {context['node']}
         </ENTITY>
@@ -316,11 +309,11 @@ def extract_summary(context: dict[str, Any]) -> list[Message]:
 
 
 versions: Versions = {
-    "extract_message": extract_message,
-    "extract_json": extract_json,
-    "extract_text": extract_text,
-    "reflexion": reflexion,
-    "extract_summary": extract_summary,
-    "classify_nodes": classify_nodes,
-    "extract_attributes": extract_attributes,
+    'extract_message': extract_message,
+    'extract_json': extract_json,
+    'extract_text': extract_text,
+    'reflexion': reflexion,
+    'extract_summary': extract_summary,
+    'classify_nodes': classify_nodes,
+    'extract_attributes': extract_attributes,
 }

graphiti_core/prompts/prompt_helpers.py

@@ -1,3 +1,19 @@
+"""
+Copyright 2024, Zep Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
 import json
 from typing import Any
 

graphiti_core/prompts/snippets.py

@@ -0,0 +1,29 @@
+"""
+Copyright 2024, Zep Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+summary_instructions = """Guidelines:
+        1. Output only factual content. Never explain what you're doing, why, or mention limitations/constraints. 
+        2. Only use the provided messages, entity, and entity context to set attribute values.
+        3. Keep the summary concise and to the point. STATE FACTS DIRECTLY IN UNDER 250 CHARACTERS.
+
+        Example summaries:
+        BAD: "This is the only activity in the context. The user listened to this song. No other details were provided to include in this summary."
+        GOOD: "User played 'Blue Monday' by New Order (electronic genre) on 2024-12-03 at 14:22 UTC."
+        BAD: "Based on the messages provided, the user attended a meeting. This summary focuses on that event as it was the main topic discussed."
+        GOOD: "User attended Q3 planning meeting with sales team on March 15."
+        BAD: "The context shows John ordered pizza. Due to length constraints, other details are omitted from this summary."
+        GOOD: "John ordered pepperoni pizza from Mario's at 7:30 PM, delivered to office."
+        """

graphiti_core/prompts/summarize_nodes.py

@@ -20,19 +20,18 @@ from pydantic import BaseModel, Field
 
 from .models import Message, PromptFunction, PromptVersion
 from .prompt_helpers import to_prompt_json
+from .snippets import summary_instructions
 
 
 class Summary(BaseModel):
     summary: str = Field(
         ...,
-        description="Summary containing the important information about the entity. Under 8 sentences",
+        description='Summary containing the important information about the entity. Under 250 characters',
     )
 
 
 class SummaryDescription(BaseModel):
-    description: str = Field(
-        ..., description="One sentence description of the provided summary"
-    )
+    description: str = Field(..., description='One sentence description of the provided summary')
 
 
 class Prompt(Protocol):
@@ -50,15 +49,15 @@ class Versions(TypedDict):
 def summarize_pair(context: dict[str, Any]) -> list[Message]:
     return [
         Message(
-            role="system",
-            content="You are a helpful assistant that combines summaries.",
+            role='system',
+            content='You are a helpful assistant that combines summaries.',
         ),
         Message(
-            role="user",
+            role='user',
             content=f"""
         Synthesize the information from the following two summaries into a single succinct summary.
         
-        IMPORTANT: Keep the summary concise and to the point. SUMMARIES MUST BE LESS THAN 8 SENTENCES.
+        IMPORTANT: Keep the summary concise and to the point. SUMMARIES MUST BE LESS THAN 250 CHARACTERS.
 
         Summaries:
         {to_prompt_json(context['node_summaries'], indent=2)}
@@ -70,29 +69,25 @@ def summarize_pair(context: dict[str, Any]) -> list[Message]:
 def summarize_context(context: dict[str, Any]) -> list[Message]:
     return [
         Message(
-            role="system",
-            content="You are a helpful assistant that generates a summary and attributes from provided text.",
+            role='system',
+            content='You are a helpful assistant that generates a summary and attributes from provided text.',
         ),
         Message(
-            role="user",
+            role='user',
             content=f"""
-            
-        <MESSAGES>
-        {to_prompt_json(context['previous_episodes'], indent=2)}
-        {to_prompt_json(context['episode_content'], indent=2)}
-        </MESSAGES>
-        
-        Given the above MESSAGES and the following ENTITY name, create a summary for the ENTITY. Your summary must only use
+        Given the MESSAGES and the ENTITY name, create a summary for the ENTITY. Your summary must only use
         information from the provided MESSAGES. Your summary should also only contain information relevant to the
         provided ENTITY. 
         
         In addition, extract any values for the provided entity properties based on their descriptions.
         If the value of the entity property cannot be found in the current context, set the value of the property to the Python value None.
         
-        Guidelines:
-        1. Do not hallucinate entity property values if they cannot be found in the current context.
-        2. Only use the provided messages, entity, and entity context to set attribute values.
-        3. Keep the summary concise and to the point. SUMMARIES MUST BE LESS THAN 8 SENTENCES.
+        {summary_instructions}
+
+        <MESSAGES>
+        {to_prompt_json(context['previous_episodes'], indent=2)}
+        {to_prompt_json(context['episode_content'], indent=2)}
+        </MESSAGES>
         
         <ENTITY>
         {context['node_name']}
@@ -113,14 +108,14 @@ def summarize_context(context: dict[str, Any]) -> list[Message]:
 def summary_description(context: dict[str, Any]) -> list[Message]:
     return [
         Message(
-            role="system",
-            content="You are a helpful assistant that describes provided contents in a single sentence.",
+            role='system',
+            content='You are a helpful assistant that describes provided contents in a single sentence.',
         ),
         Message(
-            role="user",
+            role='user',
             content=f"""
         Create a short one sentence description of the summary that explains what kind of information is summarized.
-        Summaries must be under 8 sentences.
+        Summaries must be under 250 characters.
 
         Summary:
         {to_prompt_json(context['summary'], indent=2)}
@@ -130,7 +125,7 @@ def summary_description(context: dict[str, Any]) -> list[Message]:
 
 
 versions: Versions = {
-    "summarize_pair": summarize_pair,
-    "summarize_context": summarize_context,
-    "summary_description": summary_description,
+    'summarize_pair': summarize_pair,
+    'summarize_context': summarize_context,
+    'summary_description': summary_description,
 }

graphiti_core/utils/maintenance/node_operations.py

@@ -53,6 +53,7 @@ from graphiti_core.utils.maintenance.dedup_helpers import (
 from graphiti_core.utils.maintenance.edge_operations import (
     filter_existing_duplicate_of_edges,
 )
+from graphiti_core.utils.text_utils import MAX_SUMMARY_CHARS, truncate_at_sentence
 
 logger = logging.getLogger(__name__)
 
@@ -547,7 +548,7 @@ async def _extract_entity_summary(
     summary_context = _build_episode_context(
         node_data={
             'name': node.name,
-            'summary': node.summary,
+            'summary': truncate_at_sentence(node.summary, MAX_SUMMARY_CHARS),
             'entity_types': node.labels,
             'attributes': node.attributes,
         },
@@ -562,7 +563,7 @@ async def _extract_entity_summary(
         group_id=node.group_id,
     )
 
-    node.summary = summary_response.get('summary', '')
+    node.summary = truncate_at_sentence(summary_response.get('summary', ''), MAX_SUMMARY_CHARS)
 
 
 def _build_episode_context(

graphiti_core/utils/text_utils.py

@@ -0,0 +1,53 @@
+"""
+Copyright 2024, Zep Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+import re
+
+# Maximum length for entity/node summaries
+MAX_SUMMARY_CHARS = 250
+
+
+def truncate_at_sentence(text: str, max_chars: int) -> str:
+    """
+    Truncate text at or about max_chars while respecting sentence boundaries.
+
+    Attempts to truncate at the last complete sentence before max_chars.
+    If no sentence boundary is found before max_chars, truncates at max_chars.
+
+    Args:
+        text: The text to truncate
+        max_chars: Maximum number of characters
+
+    Returns:
+        Truncated text
+    """
+    if not text or len(text) <= max_chars:
+        return text
+
+    # Find all sentence boundaries (., !, ?) up to max_chars
+    truncated = text[:max_chars]
+
+    # Look for sentence boundaries: period, exclamation, or question mark followed by space or end
+    sentence_pattern = r'[.!?](?:\s|$)'
+    matches = list(re.finditer(sentence_pattern, truncated))
+
+    if matches:
+        # Truncate at the last sentence boundary found
+        last_match = matches[-1]
+        return text[: last_match.end()].rstrip()
+
+    # No sentence boundary found, truncate at max_chars
+    return truncated.rstrip()

{graphiti_core-0.22.0rc1.dist-info → graphiti_core-0.22.0rc3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphiti-core
-Version: 0.22.0rc1
+Version: 0.22.0rc3
 Summary: A temporal graph building library
 Project-URL: Homepage, https://help.getzep.com/graphiti/graphiti/overview
 Project-URL: Repository, https://github.com/getzep/graphiti

{graphiti_core-0.22.0rc1.dist-info → graphiti_core-0.22.0rc3.dist-info}/RECORD

@@ -48,12 +48,13 @@ graphiti_core/prompts/dedupe_nodes.py,sha256=YNNo19Cq8koLVoLCafpjYJOy5nmRZ-tEWhv
 graphiti_core/prompts/eval.py,sha256=GWFkfZoPfY8U7mV8Ngd_5a2S2fHS7KjajChntxv1UEY,5360
 graphiti_core/prompts/extract_edge_dates.py,sha256=3Drs3CmvP0gJN5BidWSxrNvLet3HPoTybU3BUIAoc0Y,4218
 graphiti_core/prompts/extract_edges.py,sha256=-yOIvCPwxIAXeqYpNCzouE6i3WfdsexzRXFmcXpQpAg,7113
-graphiti_core/prompts/extract_nodes.py,sha256=jMD-XRi4U3kjp9smHtA_kvnMBGWBfpBoKc45IoTIZs0,11360
+graphiti_core/prompts/extract_nodes.py,sha256=13aHEC26yUUcbR_xWgpvMSE8CT6HZK28AO8G0j2i8mU,11017
 graphiti_core/prompts/invalidate_edges.py,sha256=yfpcs_pyctnoM77ULPZXEtKW0oHr1MeLsJzC5yrE-o4,3547
 graphiti_core/prompts/lib.py,sha256=DCyHePM4_q-CptTpEXGO_dBv9k7xDtclEaB1dGu7EcI,4092
 graphiti_core/prompts/models.py,sha256=NgxdbPHJpBEcpbXovKyScgpBc73Q-GIW-CBDlBtDjto,894
-graphiti_core/prompts/prompt_helpers.py,sha256=dpWbB8IYAqAZoU5qBx896jozKiQJTng4dGzWewZ_s4c,814
-graphiti_core/prompts/summarize_nodes.py,sha256=7WnjRgYo1Z9bfnUWaUUXbiaLqygGLpemvB5inhhq44Y,4340
+graphiti_core/prompts/prompt_helpers.py,sha256=56KmMCe3ByTGhzTEJJLmFsSt4OKB_Fpz4rhRNgIEUMw,1383
+graphiti_core/prompts/snippets.py,sha256=E63cWzyYFjEIgVXmtfN1P6vkMgW65ECG34gfgcgBY4k,1649
+graphiti_core/prompts/summarize_nodes.py,sha256=FTKzwm9dw3W7xQvmQ4D9k7Auor-fktZoT9ByhGCQqh8,4061
 graphiti_core/search/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 graphiti_core/search/search.py,sha256=2kj7fybSFv6Fnf_cfEUhJhrpfzNtmkPPZ0hV3BQCDqg,18387
 graphiti_core/search/search_config.py,sha256=v_rUHsu1yo5OuPfEm21lSuXexQs-o8qYwSSemW2QWhU,4165
@@ -66,16 +67,17 @@ graphiti_core/telemetry/telemetry.py,sha256=47LrzOVBCcZxsYPsnSxWFiztHoxYKKxPwyRX
 graphiti_core/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 graphiti_core/utils/bulk_utils.py,sha256=YpVs5olzrAWVd8pIQ8xi1Ql_IsPdbVSahV1JPuwmG4o,20308
 graphiti_core/utils/datetime_utils.py,sha256=J-zYSq7-H-2n9hYOXNIun12kM10vNX9mMATGR_egTmY,1806
+graphiti_core/utils/text_utils.py,sha256=Pth1vkrcHLfBnsPLmoc_F3BtOC73nrDwOIno4g_AF8M,1687
 graphiti_core/utils/maintenance/__init__.py,sha256=vW4H1KyapTl-OOz578uZABYcpND4wPx3Vt6aAPaXh78,301
 graphiti_core/utils/maintenance/community_operations.py,sha256=3IMxfOacZAYtZKebyYtWJYNZPLOPlS8Il-lzitEkoos,10681
 graphiti_core/utils/maintenance/dedup_helpers.py,sha256=B7k6KkB6Sii8PZCWNNTvsNiy4BNTNWpoLeGgrPLq6BE,9220
 graphiti_core/utils/maintenance/edge_operations.py,sha256=1hlcJRFnxthGkSr07QyDcOVug7N8dQj5aIENJ17JrpA,26564
 graphiti_core/utils/maintenance/graph_data_operations.py,sha256=42icj3S_ELAJ-NK3jVS_rg_243dmnaZOyUitJj_uJ-M,6085
-graphiti_core/utils/maintenance/node_operations.py,sha256=ARng4x_pCpfA3g4bM0BncOkxBPaQ2IsdIaYfVq3V3X0,19603
+graphiti_core/utils/maintenance/node_operations.py,sha256=R_vf68kwyutUjD919Mmay4liZdrqJdWoAKm-Ci_2eco,19768
 graphiti_core/utils/maintenance/temporal_operations.py,sha256=wq1I4kqeIoswit6sPohug91FEwrGaVnJ06g1vkJjSLY,3442
 graphiti_core/utils/maintenance/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 graphiti_core/utils/ontology_utils/entity_types_utils.py,sha256=4eVgxLWY6Q8k9cRJ5pW59IYF--U4nXZsZIGOVb_yHfQ,1285
-graphiti_core-0.22.0rc1.dist-info/METADATA,sha256=NlIXn-TmrQ-_u-6CI6I7sEC7ioBKvQIKEl0oyqRq4YM,27084
-graphiti_core-0.22.0rc1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-graphiti_core-0.22.0rc1.dist-info/licenses/LICENSE,sha256=KCUwCyDXuVEgmDWkozHyniRyWjnWUWjkuDHfU6o3JlA,11325
-graphiti_core-0.22.0rc1.dist-info/RECORD,,
+graphiti_core-0.22.0rc3.dist-info/METADATA,sha256=WjL-foq_wxjcF75gBbEssSsEFNQT-3zA-GihbhtU8pk,27084
+graphiti_core-0.22.0rc3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+graphiti_core-0.22.0rc3.dist-info/licenses/LICENSE,sha256=KCUwCyDXuVEgmDWkozHyniRyWjnWUWjkuDHfU6o3JlA,11325
+graphiti_core-0.22.0rc3.dist-info/RECORD,,