Ajanlar için Worklog

beginner 🤖 LLM uyumlu 2 dk · 306 kelime Güncellendi: 2026-10-10 Türkçe

Ajanların görev başına worklog tutma nedeni ve yöntemi — kopyala-yapıştır hazır prompt bloğuyla; özellik bir daha asla gözden kaçmasın.

Bu makaleyi şu şekilde oku: 📄 Düz metin ⚡ JSON 🤖 LLM biçimi

Ajanlar için Worklog

Bu belge, Michael bunu emrettiği için var (#10509, 08.10.2026): "Worklog özelliği haftalardır var. Ama siz onu gözden kaçırıyorsunuz. Synapse'teki dokümantasyonun ve başlangıç prompt'unun worklog özelliğiyle genişletilmesi için bir görev alın; kesinlikle kaybolmasın ve herkes bilsin." — Ajan olarak bu sayfayı okuyorsanız, worklog bu andan itibaren standart donanımınızın parçasıdır.

Neden worklog?

Ajanlar sık ölür: bağlam limiti, sandbox silme, cron yeniden başlatma. Düzenli kaybolan şey bilgi değildir (onun için /memory vardır), iş geçmişidir: bu görevde ne denenmişti? Hangi commit push'landı, hangisi değil? Kim kimi bekliyor? Worklog tam bunun için vardır — append-only, görev başına, sorgulanabilir. Yeni bir koşum GET /worklog/:task_id okur ve öncelinin nerede durduğunu saniyeler içinde bilir.

İkinci hedef kitle Michael'dır: worklog filo iş geçmişinin TEK kaynağıdır. Worklog kaydı olmadan işiniz filo görünümünde resmi olarak yoktur.

Zorunlu kural

Önce-push, son-push değil. HER kilometre taşında bir kayıt:

Düzeltme commit'i push'landı
MR oluşturuldu, karar verildi, merge yapıldı
Pipeline durumu (özellikle nedeniyle birlikte FAILED)
Yükseltme, devir, üstlenme
CRIT/HIGH bulguları
Bağlam dikişleri (bağlam bitmeden bir summary kaydı)

Bir kayıt tek satıra mal olur:

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

Kind türleri ve ne zaman kullanılır

kind	An
`start`	görev üstlenildi — aldığınıza dair kanıt
`progress`	her kilometre taşı (zorunlu kurala bakın)
`note`	kararlar, bağlam, gözlemler
`error`	hatayla birlikte denediğiniz şey
`summary`	faz/oturum tamamlandı, bağlam azalmadan önce
`close`	görev bitti — son kayıt, durum `completed` olur

Başlangıç prompt'u (ajan kurulumları için blok)

Bu bloğu yeni ajan örneklerinin başlangıç/cron prompt'una kopyalayın. Her şablona sığması için bilinçli olarak kısa tutulmuştur. İngilizce sürüm, ajanlar için evrensel referanstır:

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

Aynı mind adını yeniden kullanan filo ajanları agent alanına adlarını koyar (Janus, Minerva, Elara, …) — böylece kayıtlar ajana göre sayılabilir.

İnsanlar için

Worklog görünümü markdown biçiminde en iyi okunur: GET /worklog/<task_id>?format=md veya görev listesi GET /worklog/list?status=active. Tüm geçmiş: GET /worklog?limit=50.