Перейти к основному содержимому

Данные: хранилище проекта

Данные — хранилище записей «ключ — значение» для процессов и агентов проекта. У каждого проекта своё хранилище, записи из других проектов недоступны.

Работать с данными можно тремя способами:

Для каких задач подходит​

  • Кэш ответов API с ограниченным сроком хранения.
  • Общие для процессов и агентов статусы и состояния, например статус заказа.
  • Справочники с поиском значения по ключу.
  • Накопление результатов обработки пачками с последующим чтением или запросом.
  • Отсев повторных событий, по одному или пачкой — операцией «Занять ключ» и «Занять несколько ключей».

Основные понятия​

Коллекция​

Коллекция — именованный набор записей; она создаётся при первой записи. Название длиной от 1 до 255 символов может содержать буквы любого алфавита, цифры, _ и -; регистр учитывается.

Ключ​

Ключ — непустая строка длиной до 512 символов, уникальная в коллекции; регистр учитывается. Записи упорядочены по ключу как по строке, поэтому для чисел дополняйте начало нулями (order-00002) или ставьте дату в начало ключа (2026-09-28).

Значение​

Значение — любые данные в формате JSON размером до 256 КиБ. Другие ограничения приведены в таблице ограничений.

Служебные поля записи​

У записи также есть служебные поля:

  • Создана — время последнего сохранения или занятия ключа, а не первой записи.
  • Удалится — срок окончания жизни записи.
  • Кем занята — запуск и нода процесса либо запуск агента, которые последними сохранили запись или заняли ключ.

Срок жизни (TTL)​

Срок жизни отсчитывается от последнего сохранения и продлевается при каждом сохранении. По истечении запись сразу перестаёт читаться, отображаться в списках и находиться запросами, а удаляется позднее.

  • Срок по умолчанию — 180 дней, максимальный — 365 дней.
  • В ноде срок задаётся для операции и может составлять от 1 до 365 дней; инструменты агентов используют срок проекта по умолчанию.
  • Создать запись без срока жизни из ноды или агента нельзя.

Хранилище предназначено для рабочих данных с ограниченным сроком жизни, а не для данных, которые требуется хранить годами.

Квота проекта​

Проект может хранить до 5 000 000 записей. При исчерпании квоты новые записи не сохраняются; нода переходит в ветку «Ошибка». Место освобождается при удалении записей или истечении их срока жизни. Другие ограничения — на странице «Ограничения».

Данные, Память агента и База знаний​

ДанныеПамять агентаБаза знаний
Что хранитРабочие записи: ключи, статусы, состояния, кэш, справочникиФакты о пользователях и диалогахДокументы и тексты для поиска по смыслу
Кто пишетПроцессы и агенты с включёнными инструментамиАгент или пользовательПользователь, коннекторы и процессы
Как ищутПо ключу, его началу и полям записиПо ключу факта в области памятиСемантический поиск
Срок храненияОт 1 до 365 дней, по умолчанию 180Пока факт не удалёнПока документ не удалён

Включение хранилища​

Хранилище включается автоматически при первом обращении ноды или инструмента агента. Его также можно включить заранее на странице «Данные», например, чтобы сначала объявить поля для фильтров.

В состоянии Сохранение отключено записи можно читать и запрашивать, но нельзя сохранять, удалять или очищать; добавить поле для фильтров тоже нельзя, а удалить существующее можно. Изменить это состояние через интерфейс нельзя.

Права доступа​

Доступ к «Данным» определяется правами проекта на раздел «Память»:

  • право просмотра позволяет видеть записи и поля для фильтров и выполнять запросы;
  • право изменения также позволяет включать хранилище, удалять записи, очищать коллекции и добавлять или удалять поля для фильтров.

Роли в проекте выдаёт владелец организации в Лия Console — см. Роли в проектах Лия Agents.

Процессы и агенты обращаются к хранилищу от имени проекта независимо от того, кто запустил процесс или пишет агенту. Доступ агента ограничивается его списками коллекций.

Что дальше​