Векторные хранилища (Vector Stores) — методы API

Создание хранилища

Создаёт новое векторное хранилище с заданным именем и описанием.

POST /v2/vector_stores

Запрос

POST {{API_HOST}}/v2/vector_stores

Тело запроса

{
  "name": "knowledge-base",
  "description": "Хранилище для базы знаний"
}

name

string

Да

Название хранилища

description

string

Нет

Описание хранилища

Получить список хранилищ

Возвращает список всех векторных хранилищ пользователя.

GET /v2/vector_stores

Запрос

GET {{API_HOST}}/v2/vector_stores?limit=20&order=desc&after=...&before=...

Параметры запроса

limit

int

Кол-во возвращаемых объектов (1–100, по умолчанию 20)

order

string

asc или desc — порядок сортировки по дате создания

after

string

Курсор для пагинации (ID объекта, после которого продолжить выборку)

before

string

Курсор для пагинации (ID объекта, до которого выполнять выборку)

Получить одно хранилище

Получает информацию об одном конкретном векторном хранилище по его идентификатору.

GET /v2/vector_stores/{vector_store_id}

Запрос

GET {{API_HOST}}/v2/vector_stores/{vector_store_id}

Тело запроса

{
  "name": "knowledge-base",
  "description": "Хранилище для базы знаний"
}

vector_store_id

string

Уникальный идентификатор

Обновить хранилище

Позволяет изменить название и описание существующего хранилища.

POST /v2/vector_stores/{vector_store_id}

Запрос

POST {{API_HOST}}/v2/vector_stores/{vector_store_id}

Тело запроса

{
  "name": "updated-name",
  "description": "Обновлённое описание"
}

name

string

Нет

Новое имя

description

string

Нет

Новое описание

Удалить хранилище

Удаляет выбранное хранилище вместе с содержимым (если есть).

DELETE /v2/vector_stores/{vector_store_id}

Запрос

DELETE {{API_HOST}}/v2/vector_stores/{vector_store_id}

vector_store_id

string

Уникальный идентификатор

Применение

Интеграция с инструментами file_search у ассистентов

Хранение и поиск по корпоративной базе знаний

Работа с векторными индексами для question answering и retrieval-augmented generation (RAG)