> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Основні концепції

> Інтеграції, ідентифікатори кінцевих користувачів, контейнери на джерело, непрозора мультитенантність і три режими пошуку: search, deep recall, suggestions.

## Інтеграція

Стабільна межа між вашим продуктом і Conare. Інтеграція належить вашій організації; окремі етапи розгортання (staging, prod) — це окремі інтеграції, розрізнені за slug. Кожна має власний ключ `cint_...` з явними скоупами (`memory:read`, `memory:write`, `memory:delete`).

## Кінцеві користувачі

Кожен виклик до памʼяті містить `endUserId` (1–128 символів, `A-Za-z0-9@._-`) — ваш ідентифікатор вашого користувача. Це **не** простір імен: фізичний тенант — це непрозорий HMAC, похідний від вашої інтеграції та ID кінцевого користувача. Клієнти не можуть обирати простори імен або звертатися до іншого тенанта — за конструкцією.

* Задавайте відображувану ідентичність через `PUT /api/v1/users/{endUserId}` (імʼя/email для перегляду в панелі).
* `DELETE /api/v1/users/{endUserId}` — повне GDPR-стирання цього користувача.

## Контейнери

Контейнери групують памʼять одного користувача за джерелом — наприклад, `profile`, `claude-chats`, `saved` або по одному на кожне підʼєднане джерело даних (тег контейнера = id конектора). Використовуйте `containerTag` під час збереження для впорядкування та `DELETE /api/v1/containers/{containerTag}`, щоб видалити памʼять одного джерела, не торкаючись решти.

## Режими пошуку

| Режим       | Ендпоінт                   | Затримка   | Що ви отримуєте                                                                                    |
| ----------- | -------------------------- | ---------- | -------------------------------------------------------------------------------------------------- |
| Search      | `POST /api/v1/search`      | сабсекунда | Ранжовані сирі збіги (вектор + BM25, злиті RRF, реренкнуті). Без LLM.                              |
| Deep recall | `POST /api/v1/recall`      | \~3–6с     | Синтезована відповідь, підкріплена цитуваннями, як текст для інʼєкції в промпт.                    |
| Suggestions | `POST /api/v1/suggestions` | \~3–6с     | До 5 конкретних наступних дій, кожна підкріплена конкретною памʼяттю. `[]` для нових користувачів. |

## Помилки та спостережуваність

Помилки використовують стабільну обгортку — `{ statusCode, code, message, requestId, details? }` — і ніколи не розкривають внутрішні ID тенантів чи текст бекенду. Кожна відповідь містить `X-Request-Id`; надсилайте свій для наскрізної кореляції. Ліміти швидкості сигналізуються стандартними заголовками та `429`; плани з журналом використання сигналізують вичерпаний ліміт через `402` плюс метадані балансу/скидання.