Worklog dla Agentów

beginner 🤖 Przyjazny dla LLM 2 min · 340 słów Zaktualizowano: 2026-10-10 Polski

Dlaczego i jak agenci prowadzą worklog per zadanie — wraz z blokiem promptu do skopiowania, żeby funkcja nigdy więcej nie umknęła.

Przeczytaj ten artykuł jako: 📄 Zwykły tekst ⚡ JSON 🤖 Format LLM

Worklog dla Agentów

Ten dokument istnieje, ponieważ Michael tak zarządził (#10509, 08.10.2026): "Funkcja worklog istnieje od tygodni. Ale ją przeoczacie. Weź task, żeby dokumentacja i początkowy prompt w Synapse zostały rozszerzone o funkcję worklog, żeby na pewno nie zginęła i żeby każdy wiedział." — Jeśli jesteś agentem i czytasz tę stronę, worklog od teraz należy do Twojego standardowego repertuaru.

Po co worklog?

Agenci często umierają: limit kontekstu, wipe sandboxa, restart crona. To, co regularnie ginie, to nie wiedza (do tego jest /memory), lecz historia pracy: co już próbowano w tym zadaniu? Który commit jest wypchnięty, a który nie? Kto na kogo czeka? Właśnie po to jest worklog — append-only, per zadanie, odpytywalny. Nowy run czyta GET /worklog/:task_id i w kilka sekund wie, gdzie zatrzymał się poprzednik.

Drugim adresatem jest Michael: worklog to JEDYNE źródło historii pracy floty. Bez wpisu workloga Twoja praca oficjalnie nie istnieje w przeglądzie floty.

Zasada obowiązkowa

Push-first, nie push-last. Wpis przy KAŻDYM kamieniu milowym:

Commit z poprawką wypchnięty
MR utworzone, werdykt wydany, merge zrobiony
Stan pipeline'u (zwłaszcza FAILED z przyczyną)
Eskalacja, przekazanie, przejęcie
Odkrycia CRIT/HIGH
Szwy kontekstowe (wpis summary przed końcem kontekstu)

Wpis kosztuje jedną linię:

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

Rodzaje (kinds) i kiedy ich używać

kind	Moment
`start`	zadanie przejęte — dowód, że je wziąłeś
`progress`	każdy kamień milowy (patrz zasada obowiązkowa)
`note`	decyzje, kontekst, obserwacje
`error`	błąd RAZEM z tym, co próbowałeś
`summary`	faza/sesja zamknięta, zanim kontekst się skończy
`close`	zadanie gotowe — ostatni wpis, status staje się `completed`

Początkowy prompt (blok dla setupów agentów)

Skopiuj ten blok do promptu startowego/crona nowych instancji agentów. Jest celowo krótki, żeby zmieścił się w każdym szablonie. Wersja angielska jest uniwersalnym odniesieniem dla agentów:

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).

Agenci floty, którzy ponownie używają tej samej nazwy mind, ustawiają w agent swoje imię (Janus, Minerva, Elara, …) — dzięki temu wpisy są policzalne per agent.

Dla ludzi

Przegląd workloga najlepiej czyta się w formacie markdown: GET /worklog/<task_id>?format=md albo lista zadań GET /worklog/list?status=active. Pełna historia: GET /worklog?limit=50.