RetrievalAgent
@nuclia/core • Docs
@nuclia/core / RetrievalAgent
Class: RetrievalAgent
Provides access to all the Retrieval Agent contents and services.
Extends
Implements
Constructors
new RetrievalAgent()
new RetrievalAgent(
nuclia
,account
,data
):RetrievalAgent
Parameters
• nuclia: INuclia
• account: string
• data: IKnowledgeBoxBase
| IKnowledgeBoxStandalone
Returns
Inherited from
WritableKnowledgeBox
.constructor
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:144
Properties
accountId
accountId:
string
Inherited from
WritableKnowledgeBox
.accountId
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:94
admin?
optional
admin:boolean
True if the current user is an administrator of the Knowledge Box.
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:913
allowed_origins?
optional
allowed_origins:null
|string
[]
Implementation of
IRetrievalAgent
.allowed_origins
Inherited from
WritableKnowledgeBox
.allowed_origins
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:27
contrib?
optional
contrib:boolean
True if the current user is a contributor of the Knowledge Box.
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:915
description?
optional
description:string
Implementation of
Inherited from
WritableKnowledgeBox
.description
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:25
external_index_provider?
optional
external_index_provider:"pinecone"
Implementation of
IRetrievalAgent
.external_index_provider
Inherited from
WritableKnowledgeBox
.external_index_provider
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:84
hidden_resources_enabled?
optional
hidden_resources_enabled:boolean
Implementation of
IRetrievalAgent
.hidden_resources_enabled
Inherited from
WritableKnowledgeBox
.hidden_resources_enabled
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:29
hidden_resources_hide_on_creation?
optional
hidden_resources_hide_on_creation:boolean
Implementation of
IRetrievalAgent
.hidden_resources_hide_on_creation
Inherited from
WritableKnowledgeBox
.hidden_resources_hide_on_creation
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:30
id
id:
string
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:21
nuclia
protected
nuclia:INuclia
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:95
search_configs?
optional
search_configs:object
Index Signature
[key
: string
]: any
Implementation of
IRetrievalAgent
.search_configs
Inherited from
WritableKnowledgeBox
.search_configs
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:28
slug
slug:
string
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:22
state?
optional
state:KBStates
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:24
title
title:
string
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:23
wsOpeningCount
wsOpeningCount:
number
=0
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:112
zone
zone:
string
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.models.ts:26
Accessors
activityMonitor
get
activityMonitor():ActivityMonitor
Returns
Implementation of
IRetrievalAgent
.activityMonitor
Inherited from
WritableKnowledgeBox
.activityMonitor
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:939
fullpath
get
fullpath():string
The Knowledge Box fullpath on the regional API.
Example: https://europe-1.nuclia.cloud/api/v1/kb/3cce4a71-9cb9-4fda-beee-8a1512616bf0
Returns
string
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:140
path
get
path():string
The Retrieval Agent path on the regional API.
Returns
string
Implementation of
Overrides
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:41
taskManager
get
taskManager():TaskManager
Entry point to task manager
Returns
Implementation of
Inherited from
WritableKnowledgeBox
.taskManager
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:923
training
get
training():Training
Deprecated
Returns
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:933
Methods
addContext()
addContext(
agent
):Observable
<object
>
Add a context agent to the Retrieval Agent.
Parameters
• agent: ContextAgentCreation
data representing the context agent to add
Returns
Observable
<object
>
An observable providing the created agent id.
id
id:
string
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:365
addDriver()
addDriver(
driver
):Observable
<void
>
Add driver to the Retrieval Agent
Parameters
• driver: DriverCreation
BraveDriver | CypherDriver | NucliaDBDriver | PerplexityDriver | TavilyDriver | SqlDriver | McpDriver
Returns
Observable
<void
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:282
addGeneration()
addGeneration(
agent
):Observable
<object
>
Add a generation agent to the Retrieval Agent.
Parameters
• agent: GenerationAgentCreation
data representing the generation agent to add.
Returns
Observable
<object
>
An observable providing the created agent id.
id
id:
string
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:398
addPostprocess()
addPostprocess(
agent
):Observable
<object
>
Add a postprocess agent to the Retrieval Agent.
Parameters
• agent: PostprocessAgentCreation
data representing the postprocess agent to add
Returns
Observable
<object
>
An observable providing the created agent id.
id
id:
string
Implementation of
IRetrievalAgent
.addPostprocess
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:431
addPreprocess()
addPreprocess(
agent
):Observable
<object
>
Add a preprocess agent to the Retrieval Agent.
Parameters
• agent: PreprocessAgentCreation
data representing the preprocess agent to add
Returns
Observable
<object
>
An observable providing the created agent id.
id
id:
string
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:332
addVectorset()
addVectorset(
model
):Observable
<void
>
Add an embedding model to the Knowledge box
Parameters
• model: string
Returns
Observable
<void
>
Implementation of
Inherited from
WritableKnowledgeBox
.addVectorset
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1219
ask()
ask(query, context, features, options)
ask(
query
,context
?,features
?,options
?):Observable
<Answer
|IErrorResponse
>
Retrieves a generative answer for the given query.
The generative answer is a text that is generated chunk by chunk by the language model.
It is retrieved through a readable HTTP stream, so the chat()
method returns an Observable
emitting a value each time a new chunk is available.
The incomplete
attribute of the emitted value indicates if the asnwer is complete or not.
Example:
nuclia.knowledgeBox
.ask('where does the Little Prince live')
.pipe(filter((answer) => !answer.incomplete))
.subscribe((answer) => {
console.log(answer.text);
});
Parameters
• query: string
• context?: ContextEntry
[]
• features?: Features
[]
• options?: ChatOptions
Returns
Observable
<Answer
| IErrorResponse
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:354
ask(query, context, features, options, callback)
ask(
query
,context
?,features
?,options
?,callback
?):Observable
<null
>
Parameters
• query: string
• context?: ContextEntry
[]
• features?: Features
[]
• options?: ChatOptions
• callback?
Returns
Observable
<null
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:360
batchUpload()
batchUpload(
files
):Observable
<UploadStatus
>
Uploads a list of files to the Knowledge Box. It automatically creates a new resource for each file and uses the TUS protocol to upload the files.
Parameters
• files: FileList
| File
[] | FileWithMetadata
[]
Returns
Observable
<UploadStatus
>
Implementation of
Inherited from
WritableKnowledgeBox
.batchUpload
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1134
catalog()
catalog(
query
,options
?):Observable
<Results
|IErrorResponse
>
Parameters
• query: string
• options?: CatalogOptions
Returns
Observable
<Results
| IErrorResponse
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:632
counters()
counters():
Observable
<Counters
>
Returns totals for each kind of contents stored in the Knowledge Box (resources, fields, paragraphs, vectors)
Returns
Observable
<Counters
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:656
createAgenticRAGPipeline()
createAgenticRAGPipeline(
steps
):Pipeline
Parameters
• steps: Steps
Returns
Inherited from
WritableKnowledgeBox
.createAgenticRAGPipeline
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:332
createExtractStrategy()
createExtractStrategy(
config
):Observable
<void
>
Parameters
• config: ExtractConfig
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.createExtractStrategy
Inherited from
WritableKnowledgeBox
.createExtractStrategy
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1231
createKey()
createKey(
saId
,expires
):Observable
<object
>
Parameters
• saId: string
• expires: string
Returns
Observable
<object
>
token
token:
string
Implementation of
Inherited from
WritableKnowledgeBox
.createKey
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1153
createKeyForService()
createKeyForService(
data
,expires
):Observable
<object
>
Parameters
• data: ServiceAccountCreation
• expires: string
Returns
Observable
<object
>
token
token:
string
Implementation of
IRetrievalAgent
.createKeyForService
Inherited from
WritableKnowledgeBox
.createKeyForService
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1165
createLinkResource()
createLinkResource(
link
,metadata
?,synchronous
?,origin
?,slug
?):Observable
<object
>
Creates a new link resource in the Knowledge Box more easily than using createResource
.
Example:
nuclia.db
.getKnowledgeBox('my-account', 'my-kb')
.pipe(
switchMap((knowledgeBox) =>
knowledgeBox.createLinkResource(
{
uri: 'https://en.wikipedia.org/wiki/Hedy_Lamarr',
},
{ classifications: [{ labelset: 'Genius', label: 'Inventor' }] },
),
),
)
.subscribe(() => {
console.log('resource created');
});
Parameters
• link: LinkField
• metadata?: UserMetadata
• synchronous?: boolean
= true
• origin?: Origin
• slug?: string
Returns
Observable
<object
>
uuid
uuid:
string
Implementation of
IRetrievalAgent
.createLinkResource
Inherited from
WritableKnowledgeBox
.createLinkResource
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1062
createOrUpdateResource()
createOrUpdateResource(
data
,synchronous
):Observable
<void
|object
>
Creates a resource or updates it if it already exists
Parameters
• data: ICreateResource
• synchronous: boolean
= true
Returns
Observable
<void
| object
>
Inherited from
WritableKnowledgeBox
.createOrUpdateResource
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1094
createResource()
createResource(
resource
,synchronous
):Observable
<object
>
Creates and indexes a new resource in the Knowledge Box.
Parameters
• resource: ICreateResource
• synchronous: boolean
= true
Returns
Observable
<object
>
uuid
uuid:
string
Implementation of
IRetrievalAgent
.createResource
Inherited from
WritableKnowledgeBox
.createResource
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1034
createSearchConfig()
createSearchConfig(
id
,config
):Observable
<void
>
Parameters
• id: string
• config: SearchConfig
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.createSearchConfig
Inherited from
WritableKnowledgeBox
.createSearchConfig
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1247
createServiceAccount()
createServiceAccount(
data
):Observable
<void
>
Parameters
• data: ServiceAccountCreation
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.createServiceAccount
Inherited from
WritableKnowledgeBox
.createServiceAccount
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1143
createSession()
createSession(
session
):Observable
<SessionCreationResponse
>
Create sessions on the retrieval agent
Parameters
• session: SessionCreation
Returns
Observable
<SessionCreationResponse
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:87
createSplitStrategy()
createSplitStrategy(
strategy
):Observable
<void
>
Parameters
• strategy: SplitStrategy
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.createSplitStrategy
Inherited from
WritableKnowledgeBox
.createSplitStrategy
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1239
delete()
delete():
Observable
<void
>
Deletes the Knowledge Box.
Returns
Observable
<void
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:964
deleteAllSynonyms()
deleteAllSynonyms():
Observable
<void
>
Returns
Observable
<void
>
Deprecated
Inherited from
WritableKnowledgeBox
.deleteAllSynonyms
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1029
deleteContext()
deleteContext(
agentId
):Observable
<void
>
Delete a context agent from the Retrieval Agent.
Parameters
• agentId: string
Identifier of the agent to delete.
Returns
Observable
<void
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:381
deleteDriver()
deleteDriver(
driverId
):Observable
<void
>
Delete driver
Parameters
• driverId: string
Identifier of the driver to delete
Returns
Observable
<void
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:298
deleteExtractStrategy()
deleteExtractStrategy(
id
):Observable
<void
>
Parameters
• id: string
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.deleteExtractStrategy
Inherited from
WritableKnowledgeBox
.deleteExtractStrategy
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1235
deleteGeneration()
deleteGeneration(
agentId
):Observable
<void
>
Delete a generation agent from the Retrieval Agent.
Parameters
• agentId: string
Identifier off the agent to delete
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.deleteGeneration
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:414
deleteInvite()
deleteInvite(
Observable
<void
>
Parameters
• email: string
Returns
Observable
<void
>
Inherited from
WritableKnowledgeBox
.deleteInvite
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1209
deleteKey()
deleteKey(
saId
,saKeyId
):Observable
<void
>
Parameters
• saId: string
• saKeyId: string
Returns
Observable
<void
>
Implementation of
Inherited from
WritableKnowledgeBox
.deleteKey
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1182
deleteLabelSet()
deleteLabelSet(
setId
):Observable
<void
>
Deletes a label set.
Parameters
• setId: string
Returns
Observable
<void
>
Inherited from
WritableKnowledgeBox
.deleteLabelSet
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1014
deletePostprocess()
deletePostprocess(
agentId
):Observable
<void
>
Delete a postprocess agent from the Retrieval Agent.
Parameters
• agentId: string
Identifier of the agent to delete
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.deletePostprocess
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:447
deletePreprocess()
deletePreprocess(
agentId
):Observable
<void
>
Delete a preprocess agent from the Retrieval Agent.
Parameters
• agentId: string
Identifier of the preprocess agent to delete
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.deletePreprocess
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:348
deleteSearchConfig()
deleteSearchConfig(
id
):Observable
<void
>
Parameters
• id: string
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.deleteSearchConfig
Inherited from
WritableKnowledgeBox
.deleteSearchConfig
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1255
deleteServiceAccount()
deleteServiceAccount(
saId
):Observable
<void
>
Parameters
• saId: string
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.deleteServiceAccount
Inherited from
WritableKnowledgeBox
.deleteServiceAccount
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1148
deleteSplitStrategy()
deleteSplitStrategy(
id
):Observable
<void
>
Parameters
• id: string
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.deleteSplitStrategy
Inherited from
WritableKnowledgeBox
.deleteSplitStrategy
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1243
feedback()
feedback(
answerId
,good
,feedback
,text_block_id
?):Observable
<void
>
Parameters
• answerId: string
• good: boolean
• feedback: string
= ''
• text_block_id?: string
Returns
Observable
<void
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:645
find()
find(
query
,features
,options
?):Observable
<FindResults
|IErrorResponse
>
Performs a find operation in the Knowledge Box, which is the recommended way to search for results.
Example:
nuclia.knowledgeBox
.find('where does the Little Prince live')
.subscribe((searchResult) => {
console.log('search result', searchResult);
});
Parameters
• query: string
• features: Features
[] = []
• options?: SearchOptions
Returns
Observable
<FindResults
| IErrorResponse
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:394
generate()
generate(
question
,context
):Observable
<object
>
Performs a question answering operation based on a given context.
Example:
nuclia.knowledgeBox
.generate('Who is Eric from Toronto?', [
'Eric is a taxi driver',
'Eric was born in France',
'Eric lives in Toronto',
]))
.subscribe(({ answer }) => {
console.log('answer', answer);
});
Parameters
• question: string
• context: string
[] = []
Returns
Observable
<object
>
answer
answer:
string
cannotAnswer
cannotAnswer:
boolean
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:516
generateJSON()
generateJSON(
question
,json_schema
,context
):Observable
<object
>
Performs a question answering operation using a JSON schema.
Example:
nuclia.knowledgeBox
.generateJSON(
'Who is Eric from Toronto?',
{
name: 'info',
parameters: {
properties: {
location: {
title: 'Location',
description: 'The location of the person',
type: 'string',
},
name: {
title: 'Name',
description: 'The name of the person',
type: 'string',
},
},
required: ['name', 'location'],
},
},
[
'Eric is a taxi driver',
'Eric was born in France',
'Eric lives in Toronto',
],
)).subscribe((answer) => {
console.log('location', answer.answer.location);
});
Parameters
• question: string
• json_schema: object
• context: string
[] = []
Returns
Observable
<object
>
answer
answer:
object
success
success:
boolean
Implementation of
Inherited from
WritableKnowledgeBox
.generateJSON
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:560
generateRandomQuestionAboutResource()
generateRandomQuestionAboutResource(
resource
):Observable
<string
>
Generates a random question about the given resource. It picks an entities relation from the extracted metadata and generates a question about it. It returns an empty string if no question can be generated. Example:
nuclia.knowledgeBox
.getResource('09a94719a6444c5a9689394f6ed9baf6', [ResourceProperties.EXTRACTED], [ExtractedDataTypes.METADATA])
.pipe(
switchMap((resource) => knowledgeBox.generateRandomQuestionAboutResource(resource)),
)
.subscribe((question) => {
console.log('question', question);
});
Parameters
• resource: Resource
Returns
Observable
<string
>
Inherited from
WritableKnowledgeBox
.generateRandomQuestionAboutResource
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:606
getConfiguration()
getConfiguration():
Observable
<object
>
Returns
Observable
<object
>
Implementation of
IRetrievalAgent
.getConfiguration
Inherited from
WritableKnowledgeBox
.getConfiguration
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:723
getContext()
getContext():
Observable
<ContextAgent
[]>
Get the list of context agents from the Retrieval Agent.
Returns
Observable
<ContextAgent
[]>
The list of context agents
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:356
getDrivers()
getDrivers(
provider
?):Observable
<Driver
[]>
Get the list of drivers of the Retrieval Agent
Parameters
• provider?: ProviderType
Optional parameter allowing to filter the drivers to get only the ones corresponding to the given provider type
Returns
Observable
<Driver
[]>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:269
getEntities()
getEntities():
Observable
<Entities
>
Returns all the NER families defined in the Knowledge Box.
Returns
Observable
<Entities
>
Inherited from
WritableKnowledgeBox
.getEntities
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:163
getEntitiesGroup()
getEntitiesGroup(
groupId
):Observable
<EntitiesGroup
>
Returns the NER family with the given id.
Parameters
• groupId: string
Returns
Observable
<EntitiesGroup
>
Inherited from
WritableKnowledgeBox
.getEntitiesGroup
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:168
getExtractStrategies()
getExtractStrategies():
Observable
<ExtractStrategies
>
Returns
Observable
<ExtractStrategies
>
Implementation of
IRetrievalAgent
.getExtractStrategies
Inherited from
WritableKnowledgeBox
.getExtractStrategies
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:893
getFacets()
getFacets(
facets
):Observable
<FacetsResult
>
Get the total amount of matches in the Knowledge Box for specific criteria (facets) passed in argument
Parameters
• facets: string
[]
List of facets to request
Returns
Observable
<FacetsResult
>
An observable containing an object where each key is a string and maps to an object containing values and their corresponding counts.
Implementation of
Inherited from
WritableKnowledgeBox
.getFacets
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:189
getFullResource()
getFullResource(
uuid
):Observable
<Resource
>
Retrieves a resource from the Knowledge Box with all its attached metadata and content.
Parameters
• uuid: string
Returns
Observable
<Resource
>
Implementation of
IRetrievalAgent
.getFullResource
Inherited from
WritableKnowledgeBox
.getFullResource
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:244
getFullResourceBySlug()
getFullResourceBySlug(
slug
):Observable
<Resource
>
Parameters
• slug: string
Returns
Observable
<Resource
>
Implementation of
IRetrievalAgent
.getFullResourceBySlug
Inherited from
WritableKnowledgeBox
.getFullResourceBySlug
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:276
getGeneration()
getGeneration():
Observable
<GenerationAgent
[]>
Get the list of generation agents from the Retrieval Agent.
Returns
Observable
<GenerationAgent
[]>
The list of generation agents
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:389
getInvites()
getInvites():
Observable
<KbInvite
[]>
Returns
Observable
<KbInvite
[]>
Inherited from
WritableKnowledgeBox
.getInvites
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:742
getKbEndpointAndZone()
protected
getKbEndpointAndZone():object
Returns
object
endpoint
endpoint:
string
zone
zone:
undefined
|string
Inherited from
WritableKnowledgeBox
.getKbEndpointAndZone
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:969
getLabels()
getLabels():
Observable
<LabelSets
>
Returns all the labels defined in the Knowledge Box.
Returns
Observable
<LabelSets
>
Inherited from
WritableKnowledgeBox
.getLabels
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:177
getLearningSchema()
getLearningSchema():
Observable
<LearningConfigurations
>
Returns
Observable
<LearningConfigurations
>
Implementation of
IRetrievalAgent
.getLearningSchema
Inherited from
WritableKnowledgeBox
.getLearningSchema
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:727
getPostprocess()
getPostprocess():
Observable
<PostprocessAgent
[]>
Get the list of postprocess agents from the Retrieval Agent.
Returns
Observable
<PostprocessAgent
[]>
The list of postprocess agents
Implementation of
IRetrievalAgent
.getPostprocess
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:422
getPreprocess()
getPreprocess():
Observable
<PreprocessAgent
[]>
Get the list of preprocess agents from the Retrieval Agent.
Returns
Observable
<PreprocessAgent
[]>
the list of preprocess agents
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:323
getResource()
getResource(
uuid
,show
,extracted
):Observable
<Resource
>
Retrieves a resource from the Knowledge Box.
show
defines which properties are returned. Default retrieves only the basic metadata.extracted
defines which extracted data are returned. It is ignored ifResourceProperties.EXTRACTED
is not in the returned properties. Default is an empty array.
Example:
nuclia.db
.getKnowledgeBox()
.pipe(switchMap((knowledgeBox) => knowledgeBox.getResource('09a94719a6444c5a9689394f6ed9baf6')))
.subscribe((resource) => {
console.log('resource', resource);
});
Parameters
• uuid: string
• show: ResourceProperties
[] = ...
• extracted: ExtractedDataTypes
[] = []
Returns
Observable
<Resource
>
Implementation of
Inherited from
WritableKnowledgeBox
.getResource
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:233
getResourceBySlug()
getResourceBySlug(
slug
,show
,extracted
):Observable
<Resource
>
Parameters
• slug: string
• show: ResourceProperties
[] = ...
• extracted: ExtractedDataTypes
[] = []
Returns
Observable
<Resource
>
Implementation of
IRetrievalAgent
.getResourceBySlug
Inherited from
WritableKnowledgeBox
.getResourceBySlug
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:268
getResourceFromData()
getResourceFromData(
data
):Resource
Parameters
• data: IResource
Returns
Inherited from
WritableKnowledgeBox
.getResourceFromData
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:328
getRules()
getRules():
Observable
<(string
|Rule
)[]>
Get the list of rules of the Retrieval Agent
Returns
Observable
<(string
| Rule
)[]>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:305
getSearchConfig()
getSearchConfig(
id
):Observable
<SearchConfig
>
Parameters
• id: string
Returns
Observable
<SearchConfig
>
Implementation of
IRetrievalAgent
.getSearchConfig
Inherited from
WritableKnowledgeBox
.getSearchConfig
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:901
getSearchConfigs()
getSearchConfigs():
Observable
<SearchConfigs
>
Returns
Observable
<SearchConfigs
>
Implementation of
IRetrievalAgent
.getSearchConfigs
Inherited from
WritableKnowledgeBox
.getSearchConfigs
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:905
getServiceAccounts()
getServiceAccounts():
Observable
<ServiceAccount
[]>
Returns
Observable
<ServiceAccount
[]>
Implementation of
IRetrievalAgent
.getServiceAccounts
Inherited from
WritableKnowledgeBox
.getServiceAccounts
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1138
getSession()
getSession(
sessionId
):Observable
<IResource
>
Retrieves a session from the Retrieval Agent.
Example:
nuclia.db
.getRetrievalAgent()
.pipe(switchMap((agent) => agent.getSession('09a94719a6444c5a9689394f6ed9baf6')))
.subscribe((session) => {
console.log('session', session);
});
Parameters
• sessionId: string
Returns
Observable
<IResource
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:58
getSplitStrategies()
getSplitStrategies():
Observable
<SplitStrategies
>
Returns
Observable
<SplitStrategies
>
Implementation of
IRetrievalAgent
.getSplitStrategies
Inherited from
WritableKnowledgeBox
.getSplitStrategies
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:897
getSynonyms()
getSynonyms():
Observable
<Synonyms
>
Returns
Observable
<Synonyms
>
Inherited from
WritableKnowledgeBox
.getSynonyms
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:172
getTempToken()
getTempToken(
payload
?,ignoreExpiration
?):Observable
<string
>
Returns an ephemeral token. Requires account id and zone to be set in the Nuclia options (except when working with a local NucliaDB instance).
This is useful when displaying a clickable link to a file in a private Knowledge Box (the token will authorize the request even though there are no authentication headers).
Example:
const downloadLink = `${nuclia.rest.getFullpath(filePath)}?eph-token=${nuclia.knowledgeBox.getTempToken()}`;
Parameters
• payload?: any
Optional payload to provide extra data for the token generation
• ignoreExpiration?: boolean
= false
Optional By default, a temp token is valid for 5min and the same token returned if this method is called several times during this time. Passing ignoreExpiration flag to true will ignore this expiration delay and will always return a new token.
Returns
Observable
<string
>
Implementation of
Inherited from
WritableKnowledgeBox
.getTempToken
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:692
getUsers()
getUsers():
Observable
<FullKbUser
[]>
Returns
Observable
<FullKbUser
[]>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:733
hasResource()
hasResource(
slug
):Observable
<boolean
>
Checks if a resource exists for the given slug.
Parameters
• slug: string
Returns
Observable
<boolean
>
Inherited from
WritableKnowledgeBox
.hasResource
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1083
interact()
interact(
sessionId
,question
,method
):Observable
<IErrorResponse
|AragResponse
>
Parameters
• sessionId: string
• question: string
• method: "POST"
| "WS"
= 'WS'
Returns
Observable
<IErrorResponse
| AragResponse
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:91
inviteToAgent()
inviteToAgent(
data
):Observable
<void
>
Invite a user to the Retrieval Agent.
Parameters
• data: InviteKbData
Returns
Observable
<void
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:261
inviteToKb()
inviteToKb(
data
):Observable
<void
>
Invite a user to the Knowledge Box
Parameters
• data: InviteKbData
Returns
Observable
<void
>
Implementation of
Inherited from
WritableKnowledgeBox
.inviteToKb
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1204
listenToAllNotifications()
listenToAllNotifications():
Observable
<NotificationMessage
[]>
Start listening to all the notifications sent by the Knowledge Box.
Returns
Observable
<NotificationMessage
[]>
Implementation of
IRetrievalAgent
.listenToAllNotifications
Inherited from
WritableKnowledgeBox
.listenToAllNotifications
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:754
listenToProcessingNotifications()
listenToProcessingNotifications():
Observable
<ResourceBaseNotification
[]>
Start listening to the Knowledge Box notifications, and returns the list of notifications for resources which have processing completed (either successfully or not). Notifications are sent anytime processing is completed, and processing is done anytime the resource is created or modified (like when a summary is added to the resource for example).
Returns
Observable
<ResourceBaseNotification
[]>
Implementation of
IRetrievalAgent
.listenToProcessingNotifications
Inherited from
WritableKnowledgeBox
.listenToProcessingNotifications
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:833
listenToResourceOperationNotifications()
listenToResourceOperationNotifications():
Observable
<ResourceOperationNotification
[]>
Start listening to the Knowledge Box notifications, and returns the list of notifications corresponding to the different operations affecting the resources: created, modified, deleted. The notification contains the resource id, title, a timestamp and a flag indicating if the operation was successful or not.
Returns
Observable
<ResourceOperationNotification
[]>
Implementation of
IRetrievalAgent
.listenToResourceOperationNotifications
Inherited from
WritableKnowledgeBox
.listenToResourceOperationNotifications
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:778
listResources()
listResources(
page
?,size
?):Observable
<ResourceList
>
Lists all the resources stored in the Knowledge Box.
Parameters
• page?: number
• size?: number
Returns
Observable
<ResourceList
>
Implementation of
Inherited from
WritableKnowledgeBox
.listResources
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:661
listSessions()
listSessions(
page
?,size
?):Observable
<SessionList
>
List all the sessions stored in the Retrieval Agent.
Parameters
• page?: number
Page index (0 by default)
• size?: number
Page size
Returns
Observable
<SessionList
>
Paginated sessions list
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:67
modify()
modify(
data
):Observable
<void
>
Modifies the Knowledge Box properties.
Example:
nuclia.db.getKnowledgeBox("my-account", "my-kb").pipe(
switchMap((knowledgeBox) => knowledgeBox.modify({title: "My new title"}),
).subscribe(() => {
console.log("knowledge box modified");
});
Parameters
• data: Partial
<IKnowledgeBox
>
Returns
Observable
<void
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:958
patchContext()
patchContext(
agent
):Observable
<void
>
Edit an existing context agent.
Parameters
• agent: ContextAgent
Modified context agent to be saved
Returns
Observable
<void
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:373
patchDriver()
patchDriver(
driver
):Observable
<void
>
Edit driver
Parameters
• driver: Driver
BraveDriver | CypherDriver | NucliaDBDriver | PerplexityDriver | TavilyDriver | SqlDriver | McpDriver
Returns
Observable
<void
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:290
patchGeneration()
patchGeneration(
agent
):Observable
<void
>
Edit an existing generation agent.
Parameters
• agent: GenerationAgent
Modified generation agent to be saved
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.patchGeneration
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:406
patchPostprocess()
patchPostprocess(
agent
):Observable
<void
>
Edit an existing postprocess agent.
Parameters
• agent: PostprocessAgent
Modified postprocess agent to be saved
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.patchPostprocess
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:439
patchPreprocess()
patchPreprocess(
agent
):Observable
<void
>
Edit an existing preprocess agent.
Parameters
• agent: PreprocessAgent
Modified preprocess agent to be saved.
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.patchPreprocess
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:340
predictAnswer()
predictAnswer(
question
,options
?,synchronous
?):Observable
<Answer
|IErrorResponse
>
Performs a question answering operation
Example:
nuclia.knowledgeBox
.predictAnswer('Who is Eric from Toronto?'))
.subscribe((answer) => {
if (answer.type !== 'error') {
console.log('answer', answer.text);
}
});
Parameters
• question: string
• options?: PredictAnswerOptions
• synchronous?: boolean
= true
Returns
Observable
<Answer
| IErrorResponse
>
Implementation of
Inherited from
WritableKnowledgeBox
.predictAnswer
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:492
processingStatus()
processingStatus(
cursor
?,scheduled
?,limit
?):Observable
<object
>
Parameters
• cursor?: string
• scheduled?: boolean
• limit?: number
Returns
Observable
<object
>
cursor
cursor:
string
results
results:
ProcessingStatus
[]
Implementation of
IRetrievalAgent
.processingStatus
Inherited from
WritableKnowledgeBox
.processingStatus
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:875
publish()
publish(
published
):Observable
<void
>
Publishes or unpublishes the Knowledge Box.
Parameters
• published: boolean
Returns
Observable
<void
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:984
removeVectorset()
removeVectorset(
model
):Observable
<void
>
Remove an embedding model from the Knowledge box
Parameters
• model: string
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.removeVectorset
Inherited from
WritableKnowledgeBox
.removeVectorset
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1227
rephrase()
rephrase(
question
,user_context
?,rephrase_prompt
?):Observable
<string
>
Performs a question rephrasing operation.
It returns a rephrased question that can be used as input for the generate()
method.
Example:
nuclia.knowledgeBox
.rephrase('Eric lives Toronto')
.subscribe((rephrased) => {
console.log('rephrased', rephrased); // Where does Eric live?
});
Parameters
• question: string
• user_context?: string
[]
• rephrase_prompt?: string
Returns
Observable
<string
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:584
search()
search(
query
,features
,options
?):Observable
<Results
|IErrorResponse
>
Performs a search operation in the knowledge box.
It is similar to find()
but the results are not nested.
Example:
nuclia.knowledgeBox
.search('where does the Little Prince live', [Search.Features.KEYWORD])
.subscribe((searchResult) => {
console.log('search result', searchResult);
});
Parameters
• query: string
• features: Features
[] = []
• options?: SearchOptions
Returns
Observable
<Results
| IErrorResponse
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:416
setConfiguration()
setConfiguration(
config
):Observable
<void
>
Parameters
• config
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.setConfiguration
Inherited from
WritableKnowledgeBox
.setConfiguration
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1187
setLabelSet()
setLabelSet(
setId
,labelSet
):Observable
<void
>
Creates or updates a label set.
Example:
nuclia.db
.getKnowledgeBox('my-account', 'my-kb')
.pipe(
switchMap((knowledgeBox) =>
knowledgeBox.setLabelSet('status', {
title: 'Status',
color: '#ff0000',
labels: [{ title: 'Major' }, { title: 'Minor' }, { title: 'Critical' }],
}),
),
)
.subscribe(() => {
console.log('label set set');
});
Parameters
• setId: string
• labelSet: LabelSet
Returns
Observable
<void
>
Inherited from
WritableKnowledgeBox
.setLabelSet
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1009
setRules()
setRules(
rules
):Observable
<void
>
Set the list of rules of the Retrieval Agent
Parameters
• rules: string
[]
List of rules to set
Returns
Observable
<void
>
Implementation of
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:315
setSynonyms()
setSynonyms(
synonyms
):Observable
<void
>
Parameters
• synonyms: Synonyms
Returns
Observable
<void
>
Deprecated
Inherited from
WritableKnowledgeBox
.setSynonyms
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1022
stopInteraction()
stopInteraction(
sessionId
):void
Parameters
• sessionId: string
Returns
void
Implementation of
IRetrievalAgent
.stopInteraction
Defined in
libs/sdk-core/src/lib/db/retrieval-agent/retrieval-agent.ts:104
stopListeningToNotifications()
stopListeningToNotifications():
void
Stop listening the notifications sent by the Knowledge Box.
Returns
void
Implementation of
IRetrievalAgent
.stopListeningToNotifications
Inherited from
WritableKnowledgeBox
.stopListeningToNotifications
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:765
suggest()
suggest(
query
,inTitleOnly
,features
):Observable
<Suggestions
|IErrorResponse
>
Suggests paragraphs based on the given query.
Parameters
• query: string
• inTitleOnly: boolean
= false
• features: SuggestionFeatures
[] = []
Returns
Observable
<Suggestions
| IErrorResponse
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:637
summarize()
summarize(
ressourceIds
,user_prompt
?,generative_model
?):Observable
<string
>
Summarize resources.
It reads the resources text content and return a global summary about them and one summery per resource.
The optional user_prompt
parameter allows you to specify a text that will be used to generate the summary,
and must use the {text}
placeholder to indicate where the resource text should be inserted
(example: 'Make a one-line summary of the following text: {text}').
Example:
nuclia.knowledgeBox
.summarize(['09a94719a6444c5a9689394f6ed9baf6'])
.subscribe((summary) => {
console.log('Summary', summary);
});
Parameters
• ressourceIds: string
[]
• user_prompt?: string
• generative_model?: string
Returns
Observable
<string
>
Implementation of
Inherited from
WritableKnowledgeBox
.summarize
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:442
tokens()
tokens(
text
):Observable
<SentenceToken
[]>
Performs a tokenization of the given text.
Example:
nuclia.knowledgeBox
.tokens('Does James Joyce live in Dublin?')
.subscribe((tokens) => {
console.log('tokens', tokens);
});
Parameters
• text: string
Returns
Observable
<SentenceToken
[]>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:472
updateSearchConfig()
updateSearchConfig(
id
,config
):Observable
<void
>
Parameters
• id: string
• config: SearchConfig
Returns
Observable
<void
>
Implementation of
IRetrievalAgent
.updateSearchConfig
Inherited from
WritableKnowledgeBox
.updateSearchConfig
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1251
updateUsers()
updateUsers(
data
):Observable
<void
>
Update the list of users of the Knowledge Box, providing the list of users (id and role) to add and/or update, and the list of user ids to delete.
Parameters
• data: KbUserPayload
Returns
Observable
<void
>
Implementation of
Inherited from
WritableKnowledgeBox
.updateUsers
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1195
upload()
upload(file, TUS, metadata)
upload(
file
,TUS
?,metadata
?):Observable
<UploadResponse
>
Uploads a file to the Knowledge Box and automatically creates a new resource to store the file.
The resource path is returned in the resource
property of the UploadResult
(and field
provides the path to the FileField
).
Example:
nuclia.db
.getKnowledgeBox('my-account', 'my-kb')
.pipe(switchMap((knowledgeBox) => knowledgeBox.upload(fileInputElement.files[0])))
.subscribe(() => {
console.log('file uploaded');
});
Parameters
• file: File
| FileWithMetadata
• TUS?: boolean
• metadata?: FileMetadata
Returns
Observable
<UploadResponse
>
Implementation of
Inherited from
Defined in
libs/sdk-core/src/lib/db/kb/kb.ts:1120
upload(buffer, TUS, metadata)
upload(
buffer
,TUS
?,metadata
?):Observable
<UploadResponse
>
Parameters
• buffer: ArrayBuffer
• TUS?: boolean
• metadata?: FileMetadata
Returns
Observable
<UploadResponse
>