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
index: Index<Record<string, unknown>>
filter?: string

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.

    • Optional options: {
          ids?: string[];
      }

      Optional object containing array of ids for the documents.

      • Optional ids?: string[]

    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.

    • Optional options: {
          ids?: string[];
      }

      Optional object containing the array of ids foor the vectors.

      • Optional ids?: string[]

    Returns Promise<string[]>

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

  • 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.

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

    Parameters

    • query: number[]

      Query vector for the similarity search.

    • k: number

      The number of similar vectors to return as result.

    • Optional filter: 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.

  • 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.

Generated using TypeDoc