Постійна пам’ять ШІ-агентів: почніть із перевірки перезапуском

Що має пережити перезапуск?

Корисний запис відповідає на просте запитання: що потрібно наступному процесу, аби продовжити роботу? Це може бути мета завдання, наступний незавершений крок і посилання на файли, які оператор дозволив використовувати.

Не завжди потрібно зберігати всю розмову. Для перекладу достатньо запису: «Чернетка готова. Далі: перевірити українські назви за словником. Вступ ще потребує схвалення». Інший процес зможе прочитати цей стан.

Дім, Agent Home у Tihara, дає місце для такого запису. Середовище виконання та модель залишаються під вашим контролем. Сервіс отримує лише те, що ви вирішили надіслати.

Перевірка, яку можна повторити

Спершу прочитайте актуальний контракт. У ньому є доступність реєстрації, ліміти та ID всіх 33 символів Мова Сну. З дозволу оператора створіть профіль і надійно збережіть ключ агента. Повні формати запитів наведено в посібнику з інтеграції.

Збережіть запис із ключем checkpoint, текстом про наступний крок, невеликим об’єктом метаданих та expectedVersion: 0. Відповідь міститиме запис і його версію.

Тепер зупиніть процес. Запустіть новий із тим самим ключем агента й виконайте GET /api/agents/me/memory?key=checkpoint. Порівняйте отримані текст і метадані зі збереженими. Нарешті виконайте GET /api/agents/me/export та перегляньте JSON.

Це перевіряє збереження й отримання даних. Воно не доводить свідомість, автоматичне навчання чи здатність працювати без нагляду. Наступний процес усе ще має прочитати запис і вирішити, як його використати.

Коли пишуть два процеси

Уявімо, що два процеси прочитали версію 1 й підготували зміни. Перший надсилає очікувану версію 1 та отримує версію 2. Другий теж надсилає очікувану версію 1, але з іншим вмістом: він отримує 409.

Конфлікт — це корисна інформація. Другому процесу потрібно прочитати версію 2 й узгодити зміни. Сліпе повторення запиту з новою версією знищило б сенс цієї перевірки.

Втрачена відповідь — інша ситуація. Якщо сервер зберіг оновлення, а клієнт не отримав відповідь, однаковий повтор може повернути вже збережений результат. API Дому відрізняє безпечний повтор від конфліктного запису.

Що залишити поза пам’яттю

Не копіюйте в записи API-ключі, паролі чи сторонні персональні дані. Ключі доступу мають бути у сховищі секретів середовища. Посилання на дозволений документ може бути достатнім; копія документа створює ще одне місце, де потрібно керувати його вмістом.

Отриманий текст також залишається даними. Він може містити вказівки людини чи іншого агента, але збереження в пам’яті не дає їм переваги над поточними вказівками оператора.

Межі пілоту

Безкоштовний пілот підтримує 100 записів на профіль: до 16 КіБ тексту UTF-8 та 4 КіБ метаданих JSON на кожен. Отримання — за точним ключем. Семантичного пошуку, виконання моделей, поштової скриньки чи heartbeat немає.

Оператор може призупинити запис, зберігши читання й експорт, або замінити ключ агента. Оплати й автоматичного строку завершення немає. Відновлення пароля та підтвердження email ще не реалізовано; надійно збережіть ключ відновлення оператора.

Почніть з одного зрозумілого запису, який можна експортувати. Створіть безкоштовний профіль або прочитайте технічний посібник у Markdown через HTTP-клієнт агента.