Criar um armazenamento de vetores
Cria um novo repositório de vetores para armazenar e pesquisar através de embeddings de documentos.
Autorizações
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>.
Cabeçalhos
Optional external end-user identifier forwarded by the API gateway.
Corpo
Corpo da solicitação para criar um armazenamento de vetores.
O nome do armazenamento de vetores.
Uma descrição para a loja de vetores. Pode ser usada para descrever o propósito da loja de vetores.
Uma lista de IDs de arquivos que a store vetorial deve usar. Útil para ferramentas como file_search que podem acessar arquivos. No máximo 500 por solicitação.
500A política de expiração para um armazenamento de vetores.
A estratégia de divisão usada para dividir o(s) arquivo(s). Se não definida, usará a estratégia automática. Aplicável apenas se file_ids não estiver vazio.
- Option 1
- Option 2
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.
O modelo de incorporação a ser usado. Padrão para o modelo configurado automaticamente se não especificado.
O número de dimensões para os vetores de embedding. Suportado apenas para modelos com dimensões flexíveis. Se não especificado, utiliza as dimensões padrão do modelo.
-9007199254740991 < x <= 9007199254740991Modo de recuperação, congelado na criação (não pode ser alterado depois). 'vector' (padrão): busca padrão por similaridade vetorial. 'graph': GraphRAG — entidades e relações são extraídas de cada fragmento na ingestão (cobradas com base no seu uso) e a busca percorre o grafo de conhecimento.
vector, graph Modelo usado para extração de entidade/relação em armazenamentos de grafo (extração de triplas no momento da ingestão e extração de entidades na consulta). Por padrão, usa o modelo configurado automaticamente, resolvido no momento da criação — mesmo contrato que embedding_model. Só é válido quando retrieval_mode é 'graph'.
Profundidade de expansão do grafo para consultas em modo grafo (1-4, padrão do mecanismo 2). Válido apenas para armazenamentos de grafo.
1 <= x <= 4Resposta
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 de vetores. Nulo para armazenamento de vetores legados.
0 < x <= 9007199254740991Modo de recuperação, congelado na criação. 'vector': busca padrão por similaridade vetorial. 'graph': GraphRAG — entidades e relações são extraídas na ingestão e as consultas percorrem o grafo de conhecimento. 'hybrid' é reservado.
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 de vetores foi ativado pela última vez.
-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) para quando o armazenamento de vetores expirará.
-9007199254740991 <= x <= 9007199254740991Uma descrição para a loja de vetores. Pode ser usada para descrever o propósito da loja de vetores.