The main class that extends the 'VectorStore' class. It provides methods for interacting with Upstash index, such as adding documents, deleting documents, performing similarity search and more.

Hierarchy

  • VectorStore
    • UpstashVectorStore

Constructors

Properties

FilterType: string
caller: AsyncCaller
embeddings: EmbeddingsInterface
filter?: string
index: Index<Dict>
namespace?: string
useUpstashEmbeddings?: boolean

Methods

  • This method adds documents to Upstash database. Documents are first converted to vectors using the provided embeddings instance, and then upserted to the database.

    Parameters

    • documents: DocumentInterface<Record<string, any>>[]

      Array of Document objects to be added to the database.

    • Optionaloptions: {
          ids?: string[];
          useUpstashEmbeddings?: boolean;
      }

      Optional object containing array of ids for the documents.

      • Optionalids?: string[]
      • OptionaluseUpstashEmbeddings?: boolean

    Returns Promise<string[]>

    Promise that resolves with the ids of the provided documents when the upsert operation is done.

  • This method adds the provided vectors to Upstash database.

    Parameters

    • vectors: number[][]

      Array of vectors to be added to the Upstash database.

    • documents: DocumentInterface<Record<string, any>>[]

      Array of Document objects, each associated with a vector.

    • Optionaloptions: {
          ids?: string[];
      }

      Optional object containing the array of ids foor the vectors.

      • Optionalids?: string[]

    Returns Promise<string[]>

    Promise that resolves with the ids of the provided documents when the upsert operation is done.

  • Parameters

    • OptionalkOrFields: number | Partial<VectorStoreRetrieverInput<UpstashVectorStore>>
    • Optionalfilter: string
    • Optionalcallbacks: Callbacks
    • Optionaltags: string[]
    • Optionalmetadata: Record<string, unknown>
    • Optionalverbose: boolean

    Returns VectorStoreRetriever<UpstashVectorStore>

  • This method deletes documents from the Upstash database. You can either provide the target ids, or delete all vectors in the database.

    Parameters

    • params: UpstashDeleteParams

      Object containing either array of ids of the documents or boolean deleteAll.

    Returns Promise<void>

    Promise that resolves when the specified documents have been deleted from the database.

  • Return documents selected using the maximal marginal relevance. Maximal marginal relevance optimizes for similarity to the query AND diversity among selected documents.

    Parameters

    • query: string

      Text to look up documents similar to.

    • options: MaxMarginalRelevanceSearchOptions<string>
    • _callbacks: undefined | Callbacks

    Returns Promise<DocumentInterface<Record<string, any>>[]>

    • List of documents selected by maximal marginal relevance.
  • Parameters

    • query: string
    • Optionalk: number
    • Optionalfilter: string
    • Optional_callbacks: Callbacks

    Returns Promise<DocumentInterface<Record<string, any>>[]>

  • This method performs a similarity search in the Upstash database over the existing vectors.

    Parameters

    • query: string | number[]

      Query vector for the similarity search.

    • k: number

      The number of similar vectors to return as result.

    • Optionalfilter: string

    Returns Promise<[DocumentInterface<Record<string, any>>, number][]>

    Promise that resolves with an array of tuples, each containing Document object and similarity score. The length of the result will be maximum of 'k' and vectors in the index.

  • Parameters

    • query: string
    • Optionalk: number
    • Optionalfilter: string
    • Optional_callbacks: Callbacks

    Returns Promise<[DocumentInterface<Record<string, any>>, number][]>

  • Returns Serialized

  • This method creates a new UpstashVector instance from an array of Document instances.

    Parameters

    • docs: DocumentInterface<Record<string, any>>[]

      The docs to be added to Upstash database.

    • embeddings: EmbeddingsInterface

      Embedding interface of choice, to create the embeddings.

    • dbConfig: UpstashVectorLibArgs

      Object containing the Upstash database configs.

    Returns Promise<UpstashVectorStore>

    Promise that resolves with a new UpstashVector instance

  • This method creates a new UpstashVector instance from an array of texts. The texts are initially converted to Document instances and added to Upstash database.

    Parameters

    • texts: string[]

      The texts to create the documents from.

    • metadatas: UpstashMetadata | UpstashMetadata[]

      The metadata values associated with the texts.

    • embeddings: EmbeddingsInterface

      Embedding interface of choice, to create the text embeddings.

    • dbConfig: UpstashVectorLibArgs

      Object containing the Upstash database configs.

    Returns Promise<UpstashVectorStore>

    Promise that resolves with a new UpstashVector instance.