Справочник API
БД векторов
Обновление или добавление векторов (векторных эмбеддингов)
HTTP
POST
/vector/upsert/{id}
Выполняет upsert (вставку/обновление) векторных эмбеддингов документов в рамках указанного агента.Авторизация
string required
bearerAuth
JWT-токенТело запроса (application/json):
stopNodeId(string) — если используется несколько узлов БД вектора, укажите ID узла, в который сохранять векторы Пример:"node_1"overrideConfig(object, optional) — конфигурация для переопределения настроек upsert по умолчанию
Коды ответов:
- 200 — векторные эмбеддинги успешно вставлены/обновлены (application/json)
- 400 — некорректные входные данные
- 404 — агент не найден
- 422 — ошибка валидации
- 500 — внутренняя ошибка сервера
POST /vector/upsert/{id} HTTP/1.1
Host: your-api-host
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Пример HTTP-запроса
{
"stopNodeId": "node_1",
"overrideConfig": {}
}
Пример успешного ответа (200)
{
"numAdded": 1,
"numDeleted": 1,
"numUpdated": 1,
"numSkipped": 1,
"addedDocs": [
{
"pageContent": "This is the content of the page.",
"metadata": {
"author": "John Doe",
"date": "2024-08-24"
}
}
]
}