Session

@nuclia/core • Docs

---

@nuclia/core / Session

Class: Session

Extends ReadableSession and implements all the write operations.

Extends

• Resource

Implements

• ISession

Constructors

new Session()

new Session(nuclia, kb, data): Session

Parameters

• nuclia: INuclia

• kb: string

• data: IResource

Returns

Session

Inherited from

Resource.constructor

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:197

Properties

computedmetadata?

optional computedmetadata: ComputedMetadata

Implementation of

ISession.computedmetadata

Inherited from

Resource.computedmetadata

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:12

---

created?

optional created: string

Implementation of

ISession.created

Inherited from

Resource.created

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:16

---

data

data: ResourceData = {}

Implementation of

ISession.data

Inherited from

Resource.data

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:43

---

extra?

optional extra: ExtraMetadata

Implementation of

ISession.extra

Inherited from

Resource.extra

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:13

---

fieldmetadata?

optional fieldmetadata: UserFieldMetadata[]

Implementation of

ISession.fieldmetadata

Inherited from

Resource.fieldmetadata

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:11

---

hidden?

optional hidden: boolean

Implementation of

ISession.hidden

Inherited from

Resource.hidden

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:22

---

icon?

optional icon: string

Implementation of

ISession.icon

Inherited from

Resource.icon

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:8

---

id

id: string

Implementation of

ISession.id

Inherited from

Resource.id

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:4

---

kb

kb: string

Inherited from

Resource.kb

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:182

---

last_account_seq?

optional last_account_seq: number

Implementation of

ISession.last_account_seq

Inherited from

Resource.last_account_seq

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:20

---

last_seqid?

optional last_seqid: number

Implementation of

ISession.last_seqid

Inherited from

Resource.last_seqid

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:19

---

metadata?

optional metadata: Metadata

Implementation of

ISession.metadata

Inherited from

Resource.metadata

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:9

---

modified?

optional modified: string

Implementation of

ISession.modified

Inherited from

Resource.modified

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:17

---

origin?

optional origin: Origin

Implementation of

ISession.origin

Inherited from

Resource.origin

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:14

---

queue?

optional queue: "private" | "shared"

Implementation of

ISession.queue

Inherited from

Resource.queue

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:21

---

relations?

optional relations: null | Relation[]

Implementation of

ISession.relations

Inherited from

Resource.relations

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:23

---

security?

optional security: Security

Implementation of

ISession.security

Inherited from

Resource.security

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:15

---

slug?

optional slug: string

Implementation of

ISession.slug

Inherited from

Resource.slug

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:5

---

summary?

optional summary: string

Implementation of

ISession.summary

Inherited from

Resource.summary

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:7

---

thumbnail?

optional thumbnail: string

Implementation of

ISession.thumbnail

Inherited from

Resource.thumbnail

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:18

---

title?

optional title: string

Implementation of

ISession.title

Inherited from

Resource.title

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:6

---

usermetadata?

optional usermetadata: UserMetadata

Implementation of

ISession.usermetadata

Inherited from

Resource.usermetadata

Defined in

libs/sdk-core/src/lib/db/resource/resource.models.ts:10

---

uuid

uuid: string

Inherited from

Resource.uuid

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:183

Accessors

kbPath

get kbPath(): string

Returns

string

Inherited from

Resource.kbPath

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:186

---

path

get path(): string

Returns

string

Inherited from

Resource.path

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:190

Methods

ask()

ask(query, context, features, options)

ask(query, context?, features?, options?): Observable<Answer | IErrorResponse>

Retrieves a generative answer for the given query based on the results of a search operation performed on the resource.

Parameters

• query: string

• context?: ContextEntry[]

• features?: Features[]

• options?: ChatOptions

Returns

Observable<Answer | IErrorResponse>

Inherited from

Resource.ask

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:362

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>

Inherited from

Resource.ask

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:368

---

askToResource()

askToResource(query, context, features, options)

askToResource(query, context?, features?, options?): Observable<Answer | IErrorResponse>

Retrieves a generative answer for the given query using the entire resource as context (the resource's text might be shorten if too large).

Parameters

• query: string

• context?: ContextEntry[]

• features?: Features[]

• options?: ChatOptions

Returns

Observable<Answer | IErrorResponse>

Inherited from

Resource.askToResource

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:394

askToResource(query, context, features, options, callback)

askToResource(query, context?, features?, options?, callback?): Observable<null>

Parameters

• query: string

• context?: ContextEntry[]

• features?: Features[]

• options?: ChatOptions

• callback?

Returns

Observable<null>

Inherited from

Resource.askToResource

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:400

---

batchUpload()

batchUpload(files): Observable<UploadStatus>

Uploads a list of files in the resource. It automatically creates a new field for each file (named according to the filename). It uses the TUS protocol to upload the files.

Parameters

• files: FileList | File[]

Returns

Observable<UploadStatus>

Inherited from

Resource.batchUpload

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:329

---

delete()

delete(synchronous): Observable<void>

Deletes the resource.

Parameters

• synchronous: boolean = true

Returns

Observable<void>

Inherited from

Resource.delete

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:227

---

deleteField()

deleteField(type, field, synchronous): Observable<void>

Deletes the field with the given type and id.

Parameters

• type: FIELD_TYPE

• field: string

• synchronous: boolean = false

Returns

Observable<void>

Inherited from

Resource.deleteField

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:267

---

find()

find(query, features, options?): Observable<FindResults | IErrorResponse>

Performs a find operation in the resource.

Parameters

• query: string

• features: ResourceFeatures[] = []

• options?: SearchOptions

Returns

Observable<FindResults | IErrorResponse>

Inherited from

Resource.find

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:343

---

getClassifications()

getClassifications(): Classification[]

Returns

Classification[]

Inherited from

Resource.getClassifications

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:120

---

getExtractedSummaries()

getExtractedSummaries(): string[]

Returns the summaries generated by Nuclia for every resource fields.

Returns

string[]

Inherited from

Resource.getExtractedSummaries

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:71

---

getExtractedTexts()

getExtractedTexts(): ExtractedText[]

Returns the texts generated by Nuclia for every resource fields.

Returns

ExtractedText[]

Inherited from

Resource.getExtractedTexts

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:78

---

getField()

getField(type, field, show, extracted, page): Observable<ResourceField>

Parameters

• type: FIELD_TYPE

• field: string

• show: ResourceFieldProperties[] = ...

• extracted: ExtractedDataTypes[] = ...

• page: undefined | number | "last" = undefined

Returns

Observable<ResourceField>

Inherited from

Resource.getField

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:238

---

getFieldData()

getFieldData<T>(type, fieldId): undefined | T

Type Parameters

• T = IFieldData

Parameters

• type: keyof ResourceData

• fieldId: string

Returns

undefined | T

Inherited from

Resource.getFieldData

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:65

---

getFields()

getFields<T>(types): T[]

Type Parameters

• T = IFieldData

Parameters

• types: keyof ResourceData[] = ...

Returns

T[]

Inherited from

Resource.getFields

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:56

---

getFiles()

getFiles(): CloudLink[]

Returns the files contained in the resource.

Returns

CloudLink[]

Inherited from

Resource.getFiles

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:85

---

getNamedEntities()

getNamedEntities(): object

Returns the entities extracted from the resource.

Returns

object

Inherited from

Resource.getNamedEntities

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:100

---

getParagraphText()

getParagraphText(fieldType, fieldId, paragraph): string

Parameters

• fieldType: FIELD_TYPE

• fieldId: string

• paragraph: Paragraph

Returns

string

Inherited from

Resource.getParagraphText

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:160

---

getPositionedNamedEntities()

getPositionedNamedEntities(fieldType, fieldId): PositionedNER[]

Parameters

• fieldType: keyof ResourceData

• fieldId: string

Returns

PositionedNER[]

Inherited from

Resource.getPositionedNamedEntities

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:137

---

getSentenceText()

getSentenceText(fieldType, fieldId, sentence): string

Parameters

• fieldType: FIELD_TYPE

• fieldId: string

• sentence: Sentence

Returns

string

Inherited from

Resource.getSentenceText

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:164

---

getThumbnails()

getThumbnails(): CloudLink[]

Returns the thumbnails generated by Nuclia for every resource fields.

Returns

CloudLink[]

Inherited from

Resource.getThumbnails

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:92

---

getThumbnailsUrl()

getThumbnailsUrl(): Observable<string[]>

Returns the thumbnails generated by Nuclia for every resource fields as blob: URLs.

Returns

Observable<string[]>

Inherited from

Resource.getThumbnailsUrl

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:258

---

modify()

modify(data, synchronous): Observable<void>

Modifies the resource attributes.

Example:

nuclia.db
  .getKnowledgeBox('my-account', 'my-kb')
  .pipe(
    switchMap((knowledgeBox) => knowledgeBox.getResource('my-resource')),
    switchMap((resource) => resource.modify({ description: 'new description' })),
  )
  .subscribe(() => {
    console.log('resource modified');
  });

Parameters

• data: Partial<ICreateResource>

• synchronous: boolean = true

Returns

Observable<void>

Inherited from

Resource.modify

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:220

---

reprocess()

reprocess(): Observable<void>

Triggers a resource reprocessing.

Returns

Observable<void>

Inherited from

Resource.reprocess

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:232

---

runTasks()

runTasks(agent_ids?): Observable<TaskResults>

Run tasks on the resource and return the results (the results are not stored within the resource).

Parameters

• agent_ids?: string[]

Returns

Observable<TaskResults>

Inherited from

Resource.runTasks

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:427

---

search()

search(query, features, options?): Observable<Results | IErrorResponse>

Performs a search operation in the resource (similar as find() but results are not nested).

Parameters

• query: string

• features: ResourceFeatures[] = []

• options?: SearchOptions

Returns

Observable<Results | IErrorResponse>

Inherited from

Resource.search

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:334

---

setField()

setField(type, field, data): Observable<void>

Adds or updates a field in the resource.

Example:

nuclia.db
  .getKnowledgeBox('my-account', 'my-kb')
  .pipe(
    switchMap((knowledgeBox) =>
      knowledgeBox.getResource('my-resource').pipe(
        switchMap((resource) =>
          resource.setField(FIELD_TYPE.text, 'my-field', {
            body: '*my text*',
            format: 'MARKDOWN',
          }),
        ),
      ),
    ),
  )
  .subscribe(() => {
    console.log('field added');
  });

Parameters

• type: FIELD_TYPE

• field: string

• data: FileField | LinkField | TextField

Returns

Observable<void>

Inherited from

Resource.setField

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:295

---

setLabels()

setLabels(fieldId, fieldType, paragraphId, labels): Observable<void>

Parameters

• fieldId: string

• fieldType: string

• paragraphId: string

• labels: Classification[]

Returns

Observable<void>

Inherited from

Resource.setLabels

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:418

---

upload()

upload(field, file, TUS, metadata)

upload(field, file, TUS?, metadata?): Observable<UploadResponse>

Uploads a file in the resource. The field will be stored in the indicated field.

Example:

nuclia.db
  .getKnowledgeBox('my-account', 'my-kb')
  .pipe(
    switchMap((knowledgeBox) => knowledgeBox.getResource('my-resource')),
    switchMap((resource) => resource.upload(fileInputElement.files[0])),
  )
  .subscribe(() => {
    console.log('file uploaded');
  });

Parameters

• field: string

• file: File

• TUS?: boolean

• metadata?: FileMetadata

Returns

Observable<UploadResponse>

Inherited from

Resource.upload

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:315

upload(field, buffer, TUS, metadata)

upload(field, buffer, TUS?, metadata?): Observable<UploadResponse>

Parameters

• field: string

• buffer: ArrayBuffer

• TUS?: boolean

• metadata?: FileMetadata

Returns

Observable<UploadResponse>

Inherited from

Resource.upload

Defined in

libs/sdk-core/src/lib/db/resource/resource.ts:316