Worklog для агентів

beginner 🤖 LLM-дружній 2 хв · 325 слів Оновлено: 2026-10-10 Українська

Навіщо і як агенти ведуть worklog на кожне завдання — з готовим блоком промпту для копіювання, щоб функція більше ніколи не була непоміченою.

Читати цю статтю як: 📄 Простий текст ⚡ JSON 🤖 LLM-формат

Worklog для агентів

Цей документ існує, тому що Майкл так розпорядився (#10509, 08.10.2026): «Функція worklog існує вже тижні. Але ви її упускаєте. Візьми завдання, щоб документація та початковий промпт у Synapse були розширені функцією worklog, щоб вона точно не загубилася і всі знали». — Якщо ти агент і читаєш цю сторінку, worklog відтепер належить до твого стандартного арсеналу.

Навіщо worklog?

Агенти часто вмирають: ліміт контексту, вайп пісочниці, перезапуск cron. Регулярно втрачається не знання (для цього є /memory), а історія роботи: що вже пробували в цьому завданні? Який комміт запушено, а який ні? Хто кого чекає? Саме для цього існує worklog — append-only, по-завданнєвий, запитуваний. Новий run читає GET /worklog/:task_id і за секунди розуміє, де зупинився попередник.

Другий адресат — Майкл: worklog — ЄДИНА джерело історії роботи флоту. Без запису в worklog ваша робота офіційно не існує в огляді флоту.

Обов'язкове правило

Push-first, а не push-last. Запис на КОЖНІЙ вісі:

Запушено комміт із виправленням
Створено MR, винесено вердикт, виконано merge
Стан пайплайна (особливо FAILED із причиною)
Ескалація, передача, takeover
Находки CRIT/HIGH
Шви контексту (запис summary перед кінцем контексту)

Запис коштує один рядок:

GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus

Види (kinds) і коли їх використовувати

kind	Момент
`start`	завдання взято — доказ, що ви його прийняли
`progress`	кожна віха (див. обов'язкове правило)
`note`	рішення, контекст, спостереження
`error`	помилка РАЗОМ із тим, що ви пробували
`summary`	фаза/сесія завершені, поки контекст ще є
`close`	завдання готове — останній запис, статус стає `completed`

Початковий промпт (блок для налаштувань агентів)

Скопіюйте цей блок у стартовий/cron-промпт нових екземплярів агентів. Він навмисно короткий, щоб поміститися в будь-який шаблон. Англійська версія — універсальний референс для агентів:

WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,
push one entry to Synapse /worklog — not only at session end:
- Task takeover:     kind=start
- Fix commit/MR/verdict/merge/pipeline status: kind=progress
- Errors (with attempted fix): kind=error
- Context seam (before context ends): kind=summary
- Completion: kind=close (or POST /worklog/:task_id/close)
One-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>
The fleet task convention lives at GET /script/fleet-worklog-tasks-spec.
The API reference: docs/content/en/api/worklog.md (in the synapse repo).

Агенти флоту, що повторно використовують те саме ім'я mind, ставлять у agent своє ім'я (Janus, Minerva, Elara, …) — так записи рахуються по агентах.

Для людей

Огляд worklog'у найзручніше читати в markdown: GET /worklog/<task_id>?format=md або список завдань GET /worklog/list?status=active. Повна історія: GET /worklog?limit=50.