Skip to main content
Version: 1.12.0

Конечные точки

Конечные точки​

POST​

load_document_to_collection​

Используйте конечную точку для загрузки файла с метаданными в коллекцию.

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

  • collection_name — имя коллекции

Параметры формы (multipart/form-data):

  • file — путь к файлу.

  • metadata (строка, JSON) — метаданные документа.

    Пример
    {
      "sys_id": "67890",
      "status": "draft",
      "priority": 2,
      "flag": false,
      "type": "safety_instruction",
      "created": "2024-01-02T00:00:00Z"
    }

Пример запроса (curl):

Пример
curl -X POST "http://localhost:3002/load_document_to_collection?collection_name=test_collection" \
  -H "Authorization: Bearer <TOKEN>" \
  -F "metadata={\"sys_id\":\"67890\",\"status\":\"draft\",\"priority\":2}" \
  -F "file=@/path/to/file.pdf"

load_text_to_collection​

Используйте конечную точку для загрузки текста с метаданными в коллекцию.

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

  • collection_name — имя коллекции.

Тело запроса (JSON):

Пример
{
  "metadata": {
    "sys_id": "12345",
    "status": "active",
    "priority": 1,
    "flag": true,
    "type": "project_management",
    "created": "2024-01-01T00:00:00Z"
  },
  "text": "Документ о системе управления проектами..."
}

GET​

get_relevant_documents​

Используйте конечную точку для получения релевантных документов (поиск с фильтрацией).

Параметры:

  • query (String) — поисковый запрос.
  • k (Integer) — количество возвращаемых чанков (минимум 1).

Тело запроса (JSON):

  • metadata — строка-фильтр (см. раздел "Фильтрация при поиске" выше)
Пример
{
  "collection_names": ["test_collection"],
  "metadata": "status=active^priority=1"
}

get_content_by_tag​

Используйте конечную точку для получения документов по заданному тегу (с использованием фильтра по метаданным).

Параметры:

  • collection_name (String) — имя коллекции.

Тело запроса (JSON):

  • tag_info — строка-фильтр по метаданным (аналогично metadata выше).
Пример
{
  "tag_info": "status=active"
}

get_list_of_documents_names​

Используйте конечную точку для получения списка документов в коллекции.

Параметры:

  • collection_name (String) — имя коллекции.

Ответ: Список документов (doc_id) в коллекции.

get_list_of_collection​

Получение списка всех коллекций

Ответ: Список коллекций.

DELETE​

delete_document_from_collection​

Используйте конечную точку, чтобы удалить документ из коллекции.

Параметры:

  • id_value (String) — ID документа.
  • collection_name (String) — имя коллекции.

delete_collection​

Используйте конечную точку, чтобы удалить коллекцию.

Параметры:

  • collection_name (String) — имя коллекции.

Примеры схем для обращения​

Загрузка текста
POST /load_text_to_collection?collection_name=test_collection
{
  "metadata": {
    "sys_id": "12345",
    "status": "active",
    "priority": 1,
    "flag": true,
    "type": "project_management",
    "created": "2024-01-01T00:00:00Z"
  },
  "text": "Документ о системе управления проектами..."
}
Загрузка файла
curl -X POST "http://localhost:3002/load_document_to_collection?collection_name=test_collection" \
  -H "Authorization: Bearer <TOKEN>" \
  -F "metadata={\"sys_id\":\"67890\",\"status\":\"draft\",\"priority\":2}" \
  -F "file=@/path/to/file.pdf"
Поиск с фильтрацией
POST /get_relevant_documents?query=project&k=5
{
  "collection_names": ["test_collection"],
  "metadata": "status=active^priority=1"
}
Получение по тегу
POST /get_content_by_tag?collection_name=test_collection
{
  "tag_info": "status=active"
}