Class: KnowledgeGraph

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:48

In-memory Knowledge Graph implementation

Implements

• IKnowledgeGraph

Constructors

Constructor

new KnowledgeGraph(config?): KnowledgeGraph

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:64

Parameters

config?

KnowledgeGraphConfig = {}

Returns

KnowledgeGraph

Methods

clear()

clear(): Promise<void>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:746

Clear all knowledge

Returns

Promise<void>

Implementation of

IKnowledgeGraph.clear

---

decayMemories()

decayMemories(decayFactor?): Promise<number>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:686

Decay old memories (reduce importance over time)

Parameters

decayFactor?

number

Returns

Promise<number>

Implementation of

IKnowledgeGraph.decayMemories

---

deleteEntity()

deleteEntity(id): Promise<boolean>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:173

Delete an entity and its relations

Parameters

id

string

Returns

Promise<boolean>

Implementation of

IKnowledgeGraph.deleteEntity

---

deleteRelation()

deleteRelation(id): Promise<boolean>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:265

Delete a relation

Parameters

id

string

Returns

Promise<boolean>

Implementation of

IKnowledgeGraph.deleteRelation

---

extractFromText()

extractFromText(text, options?): Promise<{ entities: KnowledgeEntity[]; relations: KnowledgeRelation[]; }>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:598

Extract entities and relations from text

Parameters

text

string

options?

entityTypes?

EntityType[]

extractRelations?

boolean

Returns

Promise<{ entities: KnowledgeEntity[]; relations: KnowledgeRelation[]; }>

Implementation of

IKnowledgeGraph.extractFromText

---

findPath()

findPath(sourceId, targetId, maxDepth?): Promise<object[] | null>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:461

Find shortest path between two entities

Parameters

sourceId

string

targetId

string

maxDepth?

number = 5

Returns

Promise<object[] | null>

Implementation of

IKnowledgeGraph.findPath

---

getEntity()

getEntity(id): Promise<KnowledgeEntity | undefined>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:123

Get entity by ID

Parameters

id

string

Returns

Promise<KnowledgeEntity | undefined>

Implementation of

IKnowledgeGraph.getEntity

---

getMemory()

getMemory(id): Promise<EpisodicMemory | undefined>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:311

Get memory by ID

Parameters

id

string

Returns

Promise<EpisodicMemory | undefined>

Implementation of

IKnowledgeGraph.getMemory

---

getNeighborhood()

getNeighborhood(entityId, depth?): Promise<{ entities: KnowledgeEntity[]; relations: KnowledgeRelation[]; }>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:510

Get neighborhood of an entity

Parameters

entityId

string

depth?

number = 1

Returns

Promise<{ entities: KnowledgeEntity[]; relations: KnowledgeRelation[]; }>

Implementation of

IKnowledgeGraph.getNeighborhood

---

getRelations()

getRelations(entityId, options?): Promise<KnowledgeRelation[]>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:234

Get relations for an entity

Parameters

entityId

string

options?

direction?

"outgoing" | "incoming" | "both"

types?

RelationType[]

Returns

Promise<KnowledgeRelation[]>

Implementation of

IKnowledgeGraph.getRelations

---

getStats()

getStats(): Promise<KnowledgeGraphStats>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:712

Get knowledge graph statistics

Returns

Promise<KnowledgeGraphStats>

Implementation of

IKnowledgeGraph.getStats

---

initialize()

initialize(): Promise<void>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:71

Initialize the knowledge graph

Returns

Promise<void>

Implementation of

IKnowledgeGraph.initialize

---

mergeEntities()

mergeEntities(entityIds, primaryId): Promise<KnowledgeEntity>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:652

Merge duplicate entities

Parameters

entityIds

string[]

primaryId

string

Returns

Promise<KnowledgeEntity>

Implementation of

IKnowledgeGraph.mergeEntities

---

queryEntities()

queryEntities(options?): Promise<KnowledgeEntity[]>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:127

Query entities

Parameters

options?

KnowledgeQueryOptions

Returns

Promise<KnowledgeEntity[]>

Implementation of

IKnowledgeGraph.queryEntities

---

queryMemories()

queryMemories(options?): Promise<EpisodicMemory[]>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:321

Query episodic memories

Parameters

options?

limit?

number

minImportance?

number

participants?

string[]

timeRange?

{ from?: string; to?: string; }

timeRange.from?

string

timeRange.to?

string

types?

("success" | "error" | "conversation" | "task" | "discovery" | "interaction")[]

Returns

Promise<EpisodicMemory[]>

Implementation of

IKnowledgeGraph.queryMemories

---

recallMemories()

recallMemories(query, topK?): Promise<EpisodicMemory[]>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:363

Recall relevant memories (updates access count)

Parameters

query

string

topK?

number = 5

Returns

Promise<EpisodicMemory[]>

Implementation of

IKnowledgeGraph.recallMemories

---

recordMemory()

recordMemory(memoryInput): Promise<EpisodicMemory>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:281

Record an episodic memory

Parameters

memoryInput

Omit<EpisodicMemory, "id" | "createdAt" | "accessCount" | "lastAccessedAt">

Returns

Promise<EpisodicMemory>

Implementation of

IKnowledgeGraph.recordMemory

---

semanticSearch()

semanticSearch(options): Promise<SemanticSearchResult[]>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:526

Semantic search across entities and memories

Parameters

options

SemanticSearchOptions

Returns

Promise<SemanticSearchResult[]>

Implementation of

IKnowledgeGraph.semanticSearch

---

traverse()

traverse(startEntityId, options?): Promise<TraversalResult>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:398

Traverse the graph from a starting entity

Parameters

startEntityId

string

options?

TraversalOptions

Returns

Promise<TraversalResult>

Implementation of

IKnowledgeGraph.traverse

---

upsertEntity()

upsertEntity(entityInput): Promise<KnowledgeEntity>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:79

Add or update an entity

Parameters

entityInput

Omit<KnowledgeEntity, "id" | "updatedAt" | "createdAt"> & object

Returns

Promise<KnowledgeEntity>

Implementation of

IKnowledgeGraph.upsertEntity

---

upsertRelation()

upsertRelation(relationInput): Promise<KnowledgeRelation>

Defined in: packages/agentos/src/core/knowledge/KnowledgeGraph.ts:201

Add or update a relation

Parameters

relationInput

Omit<KnowledgeRelation, "id" | "createdAt"> & object

Returns

Promise<KnowledgeRelation>

Implementation of

IKnowledgeGraph.upsertRelation