Struct Triplet 

pub struct Triplet {
    pub id: Uuid,
    pub source_entity_id: Uuid,
    pub target_entity_id: Uuid,
    pub relationship_name: String,
    pub text: String,
    pub source_name: Option<String>,
    pub target_name: Option<String>,
}

A triplet representing a semantic relationship between two entities.

Triplets are embedded as text in the format: “source_text-›relationship_text-›target_text”

Example: “Steve Jobs: Co-founder of Apple-›founded-›Apple Inc.: Technology company”

Python reference: cognee/modules/engine/models/Triplet.py

Fields

id: Uuid

Unique identifier for this triplet. Generated as uuid5 from edge key (deterministic).

source_entity_id: Uuid

Source entity ID.

target_entity_id: Uuid

Target entity ID.

relationship_name: String

Relationship name (edge type).

text: String

Embeddable text representation. Format: “{source_text}-›{relationship_text}-›{target_text}” This is the text that gets embedded for semantic search.

source_name: Option<String>

Optional: Source entity name for display/debugging.

target_name: Option<String>

Optional: Target entity name for display/debugging.

Implementations

impl Triplet

pub fn new( source_entity_id: Uuid, target_entity_id: Uuid, relationship_name: String, text: String, ) -> Triplet

Create a new triplet with deterministic ID.

The ID is generated using UUID v5 from the edge key, matching Python’s behavior.

Arguments

• source_entity_id - Source entity UUID
• target_entity_id - Target entity UUID
• relationship_name - Relationship/edge type name
• text - Formatted text for embedding

Example

use cognee_models::Triplet;
use uuid::Uuid;

let source_id = Uuid::new_v4();
let target_id = Uuid::new_v4();
let triplet = Triplet::new(
    source_id,
    target_id,
    "founded".to_string(),
    "Steve Jobs-›founded-›Apple Inc.".to_string(),
);

pub fn with_names(self, source_name: String, target_name: String) -> Triplet

Set source and target names for display purposes.

Arguments

• source_name - Source entity name
• target_name - Target entity name

pub fn get_text(&self) -> &str

Get embeddable text (for consistency with other models).

Trait Implementations

impl Clone for Triplet

fn clone(&self) -> Triplet

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Triplet

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Triplet

fn deserialize<__D>( __deserializer: __D, ) -> Result<Triplet, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Triplet

fn eq(&self, other: &Triplet) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Triplet

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Triplet