Modificar um repositório de vetores
Atualiza o nome, a descrição, a política de expiração ou os metadados de um vector store existente. O modelo de embedding, as dimensões de embedding, o modo de recuperação, o modelo de extração e o número máximo de saltos são fixados quando um store é criado, e o chunking é definido por arquivo anexado: enviar qualquer um deles retorna 400 com uma mensagem indicando o que fazer em vez disso (um novo store a partir dos mesmos IDs de arquivo; reanexar o arquivo). Campos desconhecidos são rejeitados da mesma forma. Retorna 410 quando o vector store tiver expirado.
Autorizações
Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.
Cabeçalhos
Optional external end-user identifier forwarded by the API gateway.
Parâmetros de caminho
O ID do armazenamento de vetores a ser modificado.
Corpo
Corpo da solicitação para modificar um repositório vetorial. Apenas name, description, expires_after e metadata podem ser alterados; embedding_model, embedding_dimensions, retrieval_mode, extraction_model e max_hops são definidos na criação, chunking_strategy é definido por arquivo anexado, e qualquer um desses campos (ou um desconhecido) é rejeitado com 400.
O nome do armazenamento de vetores.
255Uma descrição para o repositório vetorial. Defina como nulo (ou vazio) para limpá-lo.
A política de expiração para um armazenamento de vetores.
Conjunto de 16 pares chave-valor que podem ser anexados a um objeto. As chaves são strings com um comprimento máximo de 64 caracteres. Os valores são strings com um comprimento máximo de 512 caracteres.
Resposta
OK
Um repositório de vetores é uma coleção de arquivos processados que podem ser usados pela ferramenta de busca de arquivos.
O identificador, que pode ser referenciado em endpoints de API.
O tipo de objeto, que é sempre 'vector_store'.
O timestamp Unix (em segundos) de quando o armazenamento de vetores foi criado.
-9007199254740991 <= x <= 9007199254740991O nome do armazenamento de vetores.
O número total de bytes usados pelos arquivos no armazenamento de vetores.
-9007199254740991 <= x <= 9007199254740991O modelo de incorporação utilizado para este armazenamento de vetores. Resolvido no momento da criação a partir do modelo solicitado ou automático. Nulo para armazéns de vetores legados.
O número de dimensões para os vetores de incorporação neste armazenamento vetorial. Nulo para armazenamentos vetoriais legados. Se as dimensões declaradas do modelo de incorporação deixarem de incluir esse tamanho, ou se o modelo retornar incorporações de outra largura, a busca falha com 412 e novos arquivos falham ao serem ingeridos.
0 < x <= 9007199254740991Modo de recuperação, fixado na criação. 'hybrid' (o padrão para novos armazenamentos): similaridade vetorial e busca por palavras-chave em texto completo sobre o texto do chunk, combinadas por fusão de classificação recíproca. 'vector': apenas busca por similaridade vetorial. 'graph': GraphRAG — entidades e relações são extraídas na ingestão e as consultas percorrem o grafo de conhecimento.
vector, hybrid, graph Contagens de status de processamento de arquivos.
O status do armazenamento de vetores. 'expirado' significa que o armazenamento expirou, 'em_andamento' significa que os arquivos ainda estão sendo processados, 'concluído' indica que o armazenamento de vetores está pronto para uso.
expired, in_progress, completed O timestamp Unix (em segundos) de quando o armazenamento vetorial esteve ativo pela última vez: pesquisado (diretamente ou via file_search), modificado, ou quando arquivos foram ingeridos, reagendados ou removidos. As buscas o atualizam no máximo uma vez por minuto; a própria limpeza do serviço, como remover um arquivo expirado, não conta.
-9007199254740991 <= x <= 9007199254740991Conjunto de 16 pares chave-valor que podem ser anexados a um objeto. As chaves são strings com um comprimento máximo de 64 caracteres. Os valores são strings com um comprimento máximo de 512 caracteres, booleanos ou números.
O timestamp Unix (em segundos) para quando o armazenamento de vetores foi utilizado pela última vez.
-9007199254740991 <= x <= 9007199254740991O modelo usado para extração de entidades/relações em armazenamentos de grafo. Nulo para armazenamentos que não são de grafo.
Profundidade de expansão do grafo para consultas em modo grafo. Nulo para armazenamentos não orientados a grafos.
1 <= x <= 4A política de expiração para um armazenamento de vetores.
O timestamp Unix (em segundos) de quando o armazenamento vetorial expirará: last_active_at mais expires_after.days.
-9007199254740991 <= x <= 9007199254740991Uma descrição para a loja de vetores. Pode ser usada para descrever o propósito da loja de vetores.