Upstash Vector Store

UpstashVectorクラスは、Upstash Vector を使用したベクトル検索を提供します。Upstash Vectorは、メタデータフィルタリング機能を備えたベクトル類似性検索を提供するサーバーレスベクトルデータベースサービスです。

コンストラクタオプション

メソッド

createIndex()

注意：Upstashではインデックスは自動的に作成されるため、このメソッドは何も実行しません。

upsert()

query()

listIndexes()

インデックス名（名前空間）の文字列配列を返します。

describeIndex()

戻り値：

interface IndexStats {
  dimension: number;
  count: number;
  metric: "cosine" | "euclidean" | "dotproduct";
}

deleteIndex()

updateVector()

updateオブジェクトは以下のプロパティを持つことができます：

• vector（オプション）：新しいベクトルを表す数値の配列。
• metadata（オプション）：メタデータのキーと値のペアのレコード。

vectorもmetadataも提供されない場合、またはmetadataのみが提供される場合はエラーがスローされます。

deleteVector()

指定されたインデックスからIDによってアイテムを削除しようとします。削除に失敗した場合はエラーメッセージをログに記録します。

レスポンスタイプ

クエリ結果は以下の形式で返されます：

interface QueryResult {
  id: string;
  score: number;
  metadata: Record<string, any>;
  vector?: number[]; // Only included if includeVector is true
}

エラー処理

ストアは捕捉可能な型付きエラーをスローします：

try {
  await store.query({
    indexName: "index_name",
    queryVector: queryVector,
  });
} catch (error) {
  if (error instanceof VectorStoreError) {
    console.log(error.code); // 'connection_failed' | 'invalid_dimension' | etc
    console.log(error.details); // Additional error context
  }
}

環境変数

必要な環境変数：

• UPSTASH_VECTOR_URL: あなたのUpstash VectorデータベースのURL
• UPSTASH_VECTOR_TOKEN: あなたのUpstash Vector APIトークン

関連

• メタデータフィルター