Skip to main content

KnowledgeApi

@codebolt/plugin-sdk


Class: KnowledgeApi

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:25

Manages knowledge collections, documents, chunks, and chunking strategies.

The knowledge system provides a RAG (Retrieval-Augmented Generation) pipeline for agents. Collections group related documents, which are automatically split into chunks for efficient retrieval. This API covers the full lifecycle of knowledge management.

Constructors

Constructor

new KnowledgeApi(http: HttpClient): KnowledgeApi;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:26

Parameters

ParameterType
httpHttpClient

Returns

KnowledgeApi

Methods

addDocumentFromUrl()

addDocumentFromUrl(id: string, data: AddKnowledgeDocumentFromUrlRequest): Promise<unknown>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:56

Parameters

ParameterType
idstring
dataAddKnowledgeDocumentFromUrlRequest

Returns

Promise<unknown>


addDocuments()

addDocuments(id: string, data: AddKnowledgeDocumentsRequest): Promise<unknown>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:52

Parameters

ParameterType
idstring
dataAddKnowledgeDocumentsRequest

Returns

Promise<unknown>


createCollection()

createCollection(data: CreateKnowledgeCollectionRequest): Promise<KnowledgeCollection>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:30

Parameters

ParameterType
dataCreateKnowledgeCollectionRequest

Returns

Promise<KnowledgeCollection>


deleteCollection()

deleteCollection(id: string): Promise<unknown>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:46

Parameters

ParameterType
idstring

Returns

Promise<unknown>


deleteDocument()

deleteDocument(documentId: string): Promise<unknown>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:68

Parameters

ParameterType
documentIdstring

Returns

Promise<unknown>


getCollection()

getCollection(id: string): Promise<KnowledgeCollection>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:38

Parameters

ParameterType
idstring

Returns

Promise<KnowledgeCollection>


getDocument()

getDocument(documentId: string): Promise<KnowledgeDocument>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:64

Parameters

ParameterType
documentIdstring

Returns

Promise<KnowledgeDocument>


getSettings()

getSettings(id: string): Promise<KnowledgeCollectionSettings>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:84

Parameters

ParameterType
idstring

Returns

Promise<KnowledgeCollectionSettings>


getStrategies()

getStrategies(): Promise<KnowledgeStrategy[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:94

Returns

Promise<KnowledgeStrategy[]>


getStrategyOptions()

getStrategyOptions(strategy: string): Promise<KnowledgeStrategyOptions>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:98

Parameters

ParameterType
strategystring

Returns

Promise<KnowledgeStrategyOptions>


listCollections()

listCollections(params?: Record<string, unknown>): Promise<KnowledgeCollection[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:34

Parameters

ParameterType
params?Record<string, unknown>

Returns

Promise<KnowledgeCollection[]>


listDocuments()

listDocuments(id: string, params?: Record<string, unknown>): Promise<KnowledgeDocument[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:60

Parameters

ParameterType
idstring
params?Record<string, unknown>

Returns

Promise<KnowledgeDocument[]>


rechunkDocument()

rechunkDocument(documentId: string, data?: RechunkDocumentRequest): Promise<unknown>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:72

Parameters

ParameterType
documentIdstring
data?RechunkDocumentRequest

Returns

Promise<unknown>


updateChunk()

updateChunk(chunkId: string, data: UpdateKnowledgeChunkRequest): Promise<unknown>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:78

Parameters

ParameterType
chunkIdstring
dataUpdateKnowledgeChunkRequest

Returns

Promise<unknown>


updateCollection()

updateCollection(id: string, data: UpdateKnowledgeCollectionRequest): Promise<KnowledgeCollection>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:42

Parameters

ParameterType
idstring
dataUpdateKnowledgeCollectionRequest

Returns

Promise<KnowledgeCollection>


updateSettings()

updateSettings(id: string, data: UpdateKnowledgeSettingsRequest): Promise<KnowledgeCollectionSettings>;

Defined in: CodeBolt/packages/pluginSdk/src/api/knowledge.api.ts:88

Parameters

ParameterType
idstring
dataUpdateKnowledgeSettingsRequest

Returns

Promise<KnowledgeCollectionSettings>