Interface: IKnowledgeGraph

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:296

Interface for the Knowledge Graph system

Methods

clear()

clear(): Promise<void>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:425

Clear all knowledge

Returns

Promise<void>

---

decayMemories()

decayMemories(decayFactor?): Promise<number>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:415

Decay old memories (reduce importance over time)

Parameters

decayFactor?

number

Returns

Promise<number>

---

deleteEntity()

deleteEntity(id): Promise<boolean>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:324

Delete an entity and its relations

Parameters

id

string

Returns

Promise<boolean>

---

deleteRelation()

deleteRelation(id): Promise<boolean>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:341

Delete a relation

Parameters

id

string

Returns

Promise<boolean>

---

extractFromText()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:400

Extract entities and relations from text

Parameters

text

string

options?

entityTypes?

EntityType[]

extractRelations?

boolean

Returns

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

---

findPath()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:381

Find shortest path between two entities

Parameters

sourceId

string

targetId

string

maxDepth?

number

Returns

Promise<object[] | null>

---

getEntity()

getEntity(id): Promise<KnowledgeEntity | undefined>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:314

Get entity by ID

Parameters

id

string

Returns

Promise<KnowledgeEntity | undefined>

---

getMemory()

getMemory(id): Promise<EpisodicMemory | undefined>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:353

Get memory by ID

Parameters

id

string

Returns

Promise<EpisodicMemory | undefined>

---

getNeighborhood()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:386

Get neighborhood of an entity

Parameters

entityId

string

depth?

number

Returns

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

---

getRelations()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:336

Get relations for an entity

Parameters

entityId

string

options?

direction?

"outgoing" | "incoming" | "both"

types?

RelationType[]

Returns

Promise<KnowledgeRelation[]>

---

getStats()

getStats(): Promise<KnowledgeGraphStats>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:420

Get knowledge graph statistics

Returns

Promise<KnowledgeGraphStats>

---

initialize()

initialize(): Promise<void>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:302

Initialize the knowledge graph

Returns

Promise<void>

---

mergeEntities()

mergeEntities(entityIds, primaryId): Promise<KnowledgeEntity>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:410

Merge duplicate entities

Parameters

entityIds

string[]

primaryId

string

Returns

Promise<KnowledgeEntity>

---

queryEntities()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:319

Query entities

Parameters

options?

KnowledgeQueryOptions

Returns

Promise<KnowledgeEntity[]>

---

queryMemories()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:358

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[]>

---

recallMemories()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:369

Recall relevant memories (updates access count)

Parameters

query

string

topK?

number

Returns

Promise<EpisodicMemory[]>

---

recordMemory()

recordMemory(memory): Promise<EpisodicMemory>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:348

Record an episodic memory

Parameters

memory

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

Returns

Promise<EpisodicMemory>

---

semanticSearch()

semanticSearch(options): Promise<SemanticSearchResult[]>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:393

Semantic search across entities and memories

Parameters

options

SemanticSearchOptions

Returns

Promise<SemanticSearchResult[]>

---

traverse()

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

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:376

Traverse the graph from a starting entity

Parameters

startEntityId

string

options?

TraversalOptions

Returns

Promise<TraversalResult>

---

upsertEntity()

upsertEntity(entity): Promise<KnowledgeEntity>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:309

Add or update an entity

Parameters

entity

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

Returns

Promise<KnowledgeEntity>

---

upsertRelation()

upsertRelation(relation): Promise<KnowledgeRelation>

Defined in: packages/agentos/src/core/knowledge/IKnowledgeGraph.ts:331

Add or update a relation

Parameters

relation

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

Returns

Promise<KnowledgeRelation>