Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
vector_stores
/
{vector_store_id}
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.vector_stores.update(vector_store_id="vs_abc123", name="Updated Product Documentation", expires_after={
        "anchor": "last_active_at",
        "days": 60,
    })

    # Handle response
    print(res)
{
  "id": "vs_abc123",
  "object": "vector_store",
  "created_at": 1704067200,
  "name": "Updated Product Documentation",
  "usage_bytes": 1024000,
  "embedding_model": "auto",
  "embedding_dimensions": 1536,
  "file_counts": {
    "in_progress": 0,
    "completed": 5,
    "failed": 0,
    "cancelled": 0,
    "total": 5
  },
  "status": "completed",
  "last_active_at": 1704153600,
  "last_used_at": 1704153600,
  "metadata": {
    "department": "engineering"
  },
  "description": "Vector store for product manuals and docs",
  "expires_at": null,
  "expires_after": {
    "anchor": "last_active_at",
    "days": 60
  }
}

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Parámetros de ruta

vector_store_id
string
requerido

La identificación del almacén de vectores a modificar.

Cuerpo

application/json

Cuerpo de la solicitud para modificar un almacén de vectores.

name
string | null

El nombre de la tienda de vectores.

expires_after
object

La política de expiración para un almacén de vectores.

metadata
object

Conjunto de 16 pares clave-valor que se pueden adjuntar a un objeto. Las claves son cadenas con una longitud máxima de 64 caracteres. Los valores son cadenas con una longitud máxima de 512 caracteres.

Respuesta

200 - application/json

Está bien

Una tienda de vectores es una colección de archivos procesados que pueden ser utilizados por la herramienta de búsqueda de archivos.

id
string
requerido

El identificador, que se puede referenciar en los puntos finales de la API.

object
any
requerido

El tipo de objeto, que siempre es 'vector_store'.

created_at
integer
requerido

El sello de tiempo Unix (en segundos) de cuándo se creó el almacén de vectores.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
name
string | null
requerido

El nombre de la tienda de vectores.

usage_bytes
integer
requerido

El número total de bytes utilizados por los archivos en el almacén vectorial.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
embedding_model
string | null
requerido

El modelo de incrustación utilizado para este almacén de vectores. Resuelto en el momento de la creación a partir del modelo solicitado o automático. Nulo para almacenes de vectores heredados.

embedding_dimensions
integer | null
requerido

El número de dimensiones para los vectores de embedding en este almacén de vectores. Nulo para almacenes de vectores heredados.

Rango requerido: 0 < x <= 9007199254740991
file_counts
object
requerido

Contadores de estado de procesamiento de archivos.

status
enum<string>
requerido

El estado de la tienda de vectores. 'expirado' significa que la tienda ha expirado, 'en_progreso' significa que los archivos aún se están procesando, 'completado' indica que la tienda de vectores está lista para su uso.

Opciones disponibles:
expired,
in_progress,
completed
last_active_at
integer | null
requerido

La marca de tiempo de Unix (en segundos) de cuando la tienda de vectores estuvo activa por última vez.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
metadata
object
requerido

Conjunto de 16 pares clave-valor que se pueden adjuntar a un objeto. Las claves son cadenas con una longitud máxima de 64 caracteres. Los valores son cadenas con una longitud máxima de 512 caracteres, booleanos o números.

last_used_at
integer | null
requerido

La marca de tiempo de Unix (en segundos) para cuando se utilizó por última vez el almacén de vectores.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
expires_after
object

La política de expiración para un almacén de vectores.

expires_at
integer | null

El timestamp de Unix (en segundos) para cuando se expirará el almacén de vectores.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
description
string | null

Una descripción para la tienda de vectores. Se puede usar para describir el propósito de la tienda de vectores.