Життєвий цикл кінцевого користувача

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

Привʼязка відображуваної ідентичності

За замовчуванням реєстр End Users у вашій панелі показує непрозорі хеші. Надішліть відображуване імʼя та/або email, щоб реєстр показував людей замість хешів:

curl -X PUT https://api.conare.ai/api/v1/users/u_123 \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ada Lovelace", "email": "ada@example.com" }'

Або через SDK:

await conare.setUserIdentity({
  endUserId: "u_123",
  name: "Ada Lovelace",
  email: "ada@example.com",
});

Семантика:

Лише косметика. endUserId залишається HMAC-хешованим на боці Conare; отримання, ізоляція та білінг досі виконуються за хешем. Ця мітка змінює лише те, що ви бачите в реєстрі.
Часткові оновлення. Надішліть рядок, щоб задати поле, null — щоб очистити його, пропустіть ключ — щоб залишити без змін. Вкажіть принаймні одне з name або email.
Обмеження. name — до 120 символів, email — до 254 символів (перевіряється формат на наявність @; без перевірки доставленості — гігієна адрес ваших користувачів на вас).
Не тарифікується. Виклик безкоштовний і не рахується як активність кінцевого користувача, тому маркування неактивного користувача не подовжить його вікно утримання.

Коли використовувати: викликайте це щоразу, коли ви вже знаєте відображувану ідентичність користувача — наприклад, одразу після його реєстрації або коли ви вперше запускаєте інтеграцію і хочете заповнити мітки для наявних користувачів. Це необовʼязково; якщо пропустити, реєстр просто продовжить показувати хеші. DELETE /api/v1/users/{endUserId} — це повне, незворотне знищення. Впроваджуйте його у ваш потік видалення облікового запису.

curl -X DELETE https://api.conare.ai/api/v1/users/u_123 \
  -H "Authorization: Bearer $CONARE_KEY"

await conare.deleteUser("u_123");

Одним викликом Conare:

Спочатку відкликає ресурси конекторного плейну — усі утримання OAuth та ресурси конекторів на користувача знищуються до стирання памʼяті. Якщо конекторний плейн недоступний, виклик повертає 503, щоб ви могли повторити спробу; стирання, яке залишило б живий OAuth-токен, було б хибним успіхом.
Стирає плейн памʼяті — кожну памʼять, кожен вектор, кожен контейнер цього користувача.
Скидає стан конекторів — стан конекторів на користувача, який використовується для відновлення інкрементальних синхронізацій.
Видаляє рядок з реєстру — користувач зникає з вашої панелі End Users.

Фонові синхронізації, що виконуються, не можуть воскресити видаленого користувача. Якщо під час видалення виконується синхронізація конектора, вона перериває свій запуск, а не записує у стертий тенант.

DELETE завжди виконується миттєво і завжди на всього користувача, незалежно від вашої політики утримання. Мʼякого видалення чи пільгового періоду немає.

Автоматичне утримання

У розділі Platform → Retention можна задати максимальне вікно неактивності. Щойно вікно налаштовано, Conare автоматично видаляє будь-якого кінцевого користувача, що простоював довше — таке видалення виконує те саме повне знищення, що й явний DELETE /api/v1/users/{endUserId} (плейн памʼяті, стан конекторів, рядок реєстру, відкликання OAuth). Що вважається активністю:

Будь-який виклик партнерського API, що містить користувача — включно з читанням (search, recall, suggestions) і записом (memories, containers).
Синхронізації конекторів вважаються активністю. Користувач з активним конектором утримується, доки ви його не відʼєднаєте. Якщо ви хочете, щоб автоматичне утримання застосовувалося до підʼєднаних користувачів, спершу відʼєднайте конектор (або видаліть користувача явно).

Що не вважається активністю:

PUT /api/v1/users/{endUserId} (задання відображуваної ідентичності) — маркування неактивного користувача не подовжує утримання.
Перегляди реєстру в панелі.

Залиште поле порожнім, щоб зберігати користувачів назавжди. Явні запити DELETE завжди виконуються негайно, незалежно від налаштувань утримання.

Початок роботи

Основи

Життєвий цикл кінцевого користувача

Привʼязка відображуваної ідентичності

Автоматичне утримання

​Привʼязка відображуваної ідентичності

​Видалення кінцевого користувача (GDPR-стирання)

​Автоматичне утримання

Привʼязка відображуваної ідентичності

Видалення кінцевого користувача (GDPR-стирання)

Автоматичне утримання