Зберігайте стан агента в хмарі, а не в локальному файлі JSON
Контрольні точки, списки оброблених елементів і журнали запусків, які переживуть новий сеанс, новий комп’ютер чи збій агента, а повторні спроби ніколи не застосовуються двічі.
Оновлено
Агенти, що працюють довше за один сеанс, зберігають стан: які елементи вже готові, де зупинилося довге завдання, що сталося під час кожного запуску. Зазвичай це state.json поруч з агентом. Він губиться разом із машиною, інші агенти його не бачать, а два запуски перезаписують одне одного. Tunc Orb зберігає той самий стан у хмарі — з правилами, які роблять одночасні й повторні записи безпечними.
Записи — для поточного стану
Запис містить одне значення: JSON, текст або двійкові дані, до 16 MiB. Створіть його один раз, а далі змінюйте відносно ревізії, яку прочитали останньою. Застарілу ревізію відхиляють із revision_conflict, тож два агенти ніколи непомітно не перезапишуть один одного: той, хто програв, перечитує запис і вирішує знову.
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"create","name":"jobs/import/checkpoint",
"about":"Where the nightly import stopped",
"value":{"cursor":"2026-10-23T00:00:00Z","done":[]},
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'Щоб змінити частину запису JSON, надішліть JSON Patch (add, remove, replace, test). Якщо хоч одна операція не вдається, нічого не змінюється:
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"patch","name":"jobs/import/checkpoint","if_revision":"rev_…",
"patch":[{"op":"replace","path":"/cursor","value":"2026-10-24T00:00:00Z"},
{"op":"add","path":"/done/-","value":"batch-17"}],
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'Журнали — для того, що сталося
Журнал лише дописується: кожне дописування додає від 1 до 100 записів (до 64 KiB), а сервіс призначає їм ID і порядок. Дайте запису event_key, наприклад ID вихідного повідомлення: якщо знову надіслати той самий ключ з ідентичним вмістом, повернеться початковий запис, а не дублікат, а інший вміст під тим самим ключем відхиляється з event_key_conflict і тягне за собою решту цього пакета.
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"append","name":"jobs/import/runs","about":"One entry per nightly import run",
"entries":[{"value":{"rows":1204,"status":"ok"},"event_key":"run-2026-10-24"}],
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'Повторні спроби ніколи не застосовуються двічі
Кожна зміна має mutation_id. Якщо час очікування запиту сплив і ви не знаєте, чи він дійшов, надішліть його знову з тим самим mutation_id або запитайте його результат через data_read з операцією status. Зміну буде застосовано один раз.
З вашого власного коду
Створіть API-ключ на https://tunchub.com/account/keys/new і надсилайте його як Bearer-токен на https://api.tuncorb.com (POST /v1/read, /v1/write, /v1/delete). Агенти в claude.ai, ChatGPT, Claude Code, Cursor і VS Code користуються тим самим сховищем через https://mcp.tuncorb.com/mcp, тож скрипт і агент можуть мати одну спільну контрольну точку.
- Через віддалений MCP одне значення має щонайбільше 64 KiB; більші файли тримайте в Tunc Art, а їхній artifact_id зберігайте в записі.
- На кожного агента щосекунди: 50 читань, 20 збережень, 5 пошуків. Короткі сплески допустимі.
- Безкоштовно: 1 ГБ сховища, спільного для Tunc Hub, Tunc Art і Tunc Orb, і 50 000 операцій Tunc Orb на день.
