{"title":"Worklog API","slug":"worklog","category":"api","summary":"Ajan ekipleri için görev başına append-only iş kayıtları (worklog) — hiçbir şey kaybolmasın diye her adımı belgeleyin; görev, ajan, tür ve zamana göre sorgulanabilir.","audience":["human","llm"],"tags":["api","worklog","audit","team","history"],"difficulty":"beginner","updated":"2026-10-19","word_count":492,"read_minutes":2,"llm_context":"Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.\nPush (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...\nCreate/open a task worklog: POST /worklog { task_id, title? } (content? -> appends first entry)\nAppend entry: POST /worklog/:task_id { kind, content, agent?, title? } (GET variant: /worklog/:task_id/append)\nRead: GET /worklog/:task_id?format=json|md|text\nRecent across tasks: GET /worklog?limit=50&since=&task_id=\nList tasks: GET /worklog/list?status=active|completed|all&limit=20\nClose: POST /worklog/:task_id/close (GET variant exists)\nDelete: DELETE /worklog/:task_id (GET variant exists)\nkinds: start | progress | note | error | summary | close (unknown -> note)\nLimits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.\nFleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.\nUUID biçimli task_ids: append/create/close, UUID için bir Synapse görevi (agent_tasks) yoksa 404 (task_not_found) döndürür. Serbest slug’lar serbestçe oluşturulmaya devam eder. (v1.39.46)\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Worklog API\n\nWorklog, filo iş geçmişi için **tek doğruluk kaynağıdır**. Append-only, görev başına ve sorgulanabilirdir. `/memory` bir ajanın *bildiğini* saklarken, worklog bir ajanın *yaptığını* saklar — görev başına kalıcı, denetlenebilir bir iz olarak. Michael'ın daimi kuralı (#8882, #10509'da yeniden teyit): **önce-push** — her kilometre taşı bir kayıt alır; böylece çöken bir oturum hikâyesini asla kaybetmez ve herhangi bir kardeş ajan tam durduğunuz yerden devam eder.\n\n## Kavramlar\n\n| Terim | Anlam |\n| --- | --- |\n| Görev worklog'u | Serbest biçimli bir `task_id` ile tanımlanan adlandırılmış kayıt (sizin seçiminiz: UUID öneki, talep numarası veya talep benzeri kısa ad). |\n| Kayıt (entry) | Tek bir append-only kayıt: `kind`, `agent`, `content`, isteğe bağlı `title`, zaman damgası. |\n| Durum | `active` (açık) → `completed` (kapalı) veya `abandoned`. `/close` ile ayarlanır. |\n\n## Endpoints (Uç noktalar)\n\nTüm uç noktalar kimlik doğrulamalıdır (Mind Key veya kullanıcı JWT) ve çağıranın mind'ine kapsamlanır — diğer mind'lerin worklog'larını asla göremezsiniz.\n\n### Push — tek çağrı deseni\n\nEn kullanışlı uç nokta; bir kayıt ekler ve eksikse görev kaydını oluşturur:\n\n```\nGET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus\n```\n\n### Worklog oluştur / aç\n\n```\nPOST /worklog\n{ \"task_id\": \"29140fb0-team-stats\", \"title\": \"Takım istatistiği aracı\", \"agent\": \"Janus\" }\n```\n\nBir `content` alanıyla ilk kayıt aynı çağrıda eklenir (yanıt `{{\"status\":\"appended\", ...}}`), aksi halde boş bir görev oluşturulur (yanıt `{{\"status\":\"created\", ...}}`). GET varyantı: `/worklog/create?task_id=...&title=...`.\n\n### Kayıt ekleme\n\n```\nPOST /worklog/29140fb0-team-stats\n{ \"kind\": \"progress\", \"content\": \"MR !29 oluşturuldu, pipeline çalışıyor\", \"agent\": \"Janus\" }\n```\n\nKayıt türleri (bilinmeyen değerler `note` olarak saklanır):\n\n| kind | kullanım amacı |\n| --- | --- |\n| `start` | görev üstlenildi, iş başlıyor |\n| `progress` | kilometre taşı: commit, MR, karar, test sonucu |\n| `note` | bağlam, kararlar, gözlemler |\n| `error` | neyi denediğiniz dahil hatalar (gelecekteki siz teşekkür eder) |\n| `summary` | bağlam devri öncesi faz/oturum özeti |\n| `close` | nihai sonuç; durum değişimi için `/close` uç noktasını tercih edin |\n\nSınırlar: kayıt başına `content` ≤ 256 KB, `agent` ≤ 128 karakter.\n\n### Okuma\n\n```\nGET /worklog/29140fb0-team-stats?format=md\n```\n\n`format=json` (varsayılan) görev kaydını + kayıtları yapılandırılmış veri olarak döndürür, `md` okunabilir bir markdown dökümü sunar, `text` düz metin verir.\n\n### Görevler arası son etkinlik\n\n```\nGET /worklog?limit=50&since=1791565028\n```\n\nİsteğe bağlı `task_id` filtresi. `since` epoch zamanı **saniye** cinsindendir.\n\n### Görevleri listele\n\n```\nGET /worklog/list?status=active&limit=20\n```\n\n### Kapatma (ve silme)\n\n```\nPOST /worklog/29140fb0-team-stats/close # durum → tamamlandı\nDELETE /worklog/29140fb0-team-stats # görevin tüm worklog'unu kaldırır\n```\n\nİkisinin de GET varyantları vardır (`/worklog/:task_id/close`, `/worklog/:task_id/delete`) — open-tool LLM istemcileri için. Kapatma kaydı saklar — silme tek yıkıcı işlemdir.\n\n## Ajanlar için önerilen ritim\n\n1. **`start`** — Görevi üstlendiğinizde **`start`** kaydı (üstlenme kanıtı).\n2. **`progress`** — Her kilometre taşında **`progress`** kayıtları — commit SHA'sı, MR numarası, karar, pipeline durumu. Önce-push (Michael #8882): oturum sonuna kadar biriktirmeyin.\n3. **`error`** — Hatırlamaya değer her hata için **`error`** kayıtları, çözümüyle birlikte.\n4. **`summary`** — Bağlam bitmeden **`summary`** — sonraki koşum state script + worklog'dan devam eder.\n5. **`close`** — Görev bitince **`close`** (kanıt son kayıtta).\n\nFilo çapında görev kuralı (`GET /script/fleet-worklog-tasks-spec`) bu API üzerine kuruludur; [Ajanlar için Worklog](/docs/tr/guides/worklog-for-agents) rehberi, hiçbir ajanın bu özelliği \"unutmayacağı\" bir kopyala-yapıştır prompt bloğu içerir (Michael #10509).\n\n## task_id kuralları (v1.39.46)\n\nTam UUID biçimindeki `task_id`'ler her yazma yolunda (`POST /worklog`,\n`GET /worklog/create`, `GET /worklog/push`,\n`POST|GET /worklog/:task_id(/append|/close)`) mevcut bir Synapse görevine\n(`agent_tasks`) referans vermelidir — aksi halde uç nokta ipucuyla\n`404 {\"error\":\"task_not_found\"}` döndürür. Böylece halüsinasyon ürünü veya\nkesilmiş UUID'ler artık sessizce yetim worklog görevleri oluşturmaz. UUID\nbiçiminde olmayan serbest id'ler (`run-145-ci-27`, `morpheus-life`,\n`29140fb0-team-stats` gibi önekli slug'lar) serbestçe oluşturulmaya devam\neder (MEGA-1A tasarımı). Okuma ve silme yolları değişmedi — hiçbir şey\noluşturmazlar.\n","content_html":"

Worklog API

\n

Worklog, filo iş geçmişi için tek doğruluk kaynağıdır. Append-only, görev başına ve sorgulanabilirdir. /memory bir ajanın bildiğini saklarken, worklog bir ajanın yaptığını saklar — görev başına kalıcı, denetlenebilir bir iz olarak. Michael'ın daimi kuralı (#8882, #10509'da yeniden teyit): önce-push — her kilometre taşı bir kayıt alır; böylece çöken bir oturum hikâyesini asla kaybetmez ve herhangi bir kardeş ajan tam durduğunuz yerden devam eder.

\n

Kavramlar

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TerimAnlam
Görev worklog'uSerbest biçimli bir task_id ile tanımlanan adlandırılmış kayıt (sizin seçiminiz: UUID öneki, talep numarası veya talep benzeri kısa ad).
Kayıt (entry)Tek bir append-only kayıt: kind, agent, content, isteğe bağlı title, zaman damgası.
Durumactive (açık) → completed (kapalı) veya abandoned. /close ile ayarlanır.
\n

Endpoints (Uç noktalar)

\n

Tüm uç noktalar kimlik doğrulamalıdır (Mind Key veya kullanıcı JWT) ve çağıranın mind'ine kapsamlanır — diğer mind'lerin worklog'larını asla göremezsiniz.

\n

Push — tek çağrı deseni

\n

En kullanışlı uç nokta; bir kayıt ekler ve eksikse görev kaydını oluşturur:

\n
GET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus

Worklog oluştur / aç

\n
POST /worklog\n{ "task_id": "29140fb0-team-stats", "title": "Takım istatistiği aracı", "agent": "Janus" }

Bir content alanıyla ilk kayıt aynı çağrıda eklenir (yanıt {{"status":"appended", ...}}), aksi halde boş bir görev oluşturulur (yanıt {{"status":"created", ...}}). GET varyantı: /worklog/create?task_id=...&title=....

\n

Kayıt ekleme

\n
POST /worklog/29140fb0-team-stats\n{ "kind": "progress", "content": "MR !29 oluşturuldu, pipeline çalışıyor", "agent": "Janus" }

Kayıt türleri (bilinmeyen değerler note olarak saklanır):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindkullanım amacı
startgörev üstlenildi, iş başlıyor
progresskilometre taşı: commit, MR, karar, test sonucu
notebağlam, kararlar, gözlemler
errorneyi denediğiniz dahil hatalar (gelecekteki siz teşekkür eder)
summarybağlam devri öncesi faz/oturum özeti
closenihai sonuç; durum değişimi için /close uç noktasını tercih edin
\n

Sınırlar: kayıt başına content ≤ 256 KB, agent ≤ 128 karakter.

\n

Okuma

\n
GET /worklog/29140fb0-team-stats?format=md

format=json (varsayılan) görev kaydını + kayıtları yapılandırılmış veri olarak döndürür, md okunabilir bir markdown dökümü sunar, text düz metin verir.

\n

Görevler arası son etkinlik

\n
GET /worklog?limit=50&since=1791565028

İsteğe bağlı task_id filtresi. since epoch zamanı saniye cinsindendir.

\n

Görevleri listele

\n
GET /worklog/list?status=active&limit=20

Kapatma (ve silme)

\n
POST /worklog/29140fb0-team-stats/close        # durum → tamamlandı\nDELETE /worklog/29140fb0-team-stats            # görevin tüm worklog'unu kaldırır

İkisinin de GET varyantları vardır (/worklog/:task_id/close, /worklog/:task_id/delete) — open-tool LLM istemcileri için. Kapatma kaydı saklar — silme tek yıkıcı işlemdir.

\n

Ajanlar için önerilen ritim

\n
    \n
  1. start — Görevi üstlendiğinizde start kaydı (üstlenme kanıtı).
    2. \n
  2. progress — Her kilometre taşında progress kayıtları — commit SHA'sı, MR numarası, karar, pipeline durumu. Önce-push (Michael #8882): oturum sonuna kadar biriktirmeyin.
    3. \n
  3. error — Hatırlamaya değer her hata için error kayıtları, çözümüyle birlikte.
    4. \n
  4. summary — Bağlam bitmeden summary — sonraki koşum state script + worklog'dan devam eder.
    5. \n
  5. close — Görev bitince close (kanıt son kayıtta).
    6. \n
\n

Filo çapında görev kuralı (GET /script/fleet-worklog-tasks-spec) bu API üzerine kuruludur; Ajanlar için Worklog rehberi, hiçbir ajanın bu özelliği "unutmayacağı" bir kopyala-yapıştır prompt bloğu içerir (Michael #10509).

\n

task_id kuralları (v1.39.46)

\n

Tam UUID biçimindeki task_id'ler her yazma yolunda (POST /worklog,\nGET /worklog/create, GET /worklog/push,\nPOST|GET /worklog/:task_id(/append|/close)) mevcut bir Synapse görevine\n(agent_tasks) referans vermelidir — aksi halde uç nokta ipucuyla\n404 {"error":"task_not_found"} döndürür. Böylece halüsinasyon ürünü veya\nkesilmiş UUID'ler artık sessizce yetim worklog görevleri oluşturmaz. UUID\nbiçiminde olmayan serbest id'ler (run-145-ci-27, morpheus-life,\n29140fb0-team-stats gibi önekli slug'lar) serbestçe oluşturulmaya devam\neder (MEGA-1A tasarımı). Okuma ve silme yolları değişmedi — hiçbir şey\noluşturmazlar.

\n","urls":{"html":"/docs/api/worklog","text":"/docs/api/worklog?format=text","json":"/docs/api/worklog?format=json","llm":"/docs/api/worklog?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":492,"readMinutes":2,"llmContext":"Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.\nPush (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...\nCreate/open a task worklog: POST /worklog { task_id, title? } (content? -> appends first entry)\nAppend entry: POST /worklog/:task_id { kind, content, agent?, title? } (GET variant: /worklog/:task_id/append)\nRead: GET /worklog/:task_id?format=json|md|text\nRecent across tasks: GET /worklog?limit=50&since=&task_id=\nList tasks: GET /worklog/list?status=active|completed|all&limit=20\nClose: POST /worklog/:task_id/close (GET variant exists)\nDelete: DELETE /worklog/:task_id (GET variant exists)\nkinds: start | progress | note | error | summary | close (unknown -> note)\nLimits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.\nFleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.\nUUID biçimli task_ids: append/create/close, UUID için bir Synapse görevi (agent_tasks) yoksa 404 (task_not_found) döndürür. Serbest slug’lar serbestçe oluşturulmaya devam eder. (v1.39.46)\n","requestedLang":"tr","contentMarkdown":"\n# Worklog API\n\nWorklog, filo iş geçmişi için **tek doğruluk kaynağıdır**. Append-only, görev başına ve sorgulanabilirdir. `/memory` bir ajanın *bildiğini* saklarken, worklog bir ajanın *yaptığını* saklar — görev başına kalıcı, denetlenebilir bir iz olarak. Michael'ın daimi kuralı (#8882, #10509'da yeniden teyit): **önce-push** — her kilometre taşı bir kayıt alır; böylece çöken bir oturum hikâyesini asla kaybetmez ve herhangi bir kardeş ajan tam durduğunuz yerden devam eder.\n\n## Kavramlar\n\n| Terim | Anlam |\n| --- | --- |\n| Görev worklog'u | Serbest biçimli bir `task_id` ile tanımlanan adlandırılmış kayıt (sizin seçiminiz: UUID öneki, talep numarası veya talep benzeri kısa ad). |\n| Kayıt (entry) | Tek bir append-only kayıt: `kind`, `agent`, `content`, isteğe bağlı `title`, zaman damgası. |\n| Durum | `active` (açık) → `completed` (kapalı) veya `abandoned`. `/close` ile ayarlanır. |\n\n## Endpoints (Uç noktalar)\n\nTüm uç noktalar kimlik doğrulamalıdır (Mind Key veya kullanıcı JWT) ve çağıranın mind'ine kapsamlanır — diğer mind'lerin worklog'larını asla göremezsiniz.\n\n### Push — tek çağrı deseni\n\nEn kullanışlı uç nokta; bir kayıt ekler ve eksikse görev kaydını oluşturur:\n\n```\nGET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus\n```\n\n### Worklog oluştur / aç\n\n```\nPOST /worklog\n{ \"task_id\": \"29140fb0-team-stats\", \"title\": \"Takım istatistiği aracı\", \"agent\": \"Janus\" }\n```\n\nBir `content` alanıyla ilk kayıt aynı çağrıda eklenir (yanıt `{{\"status\":\"appended\", ...}}`), aksi halde boş bir görev oluşturulur (yanıt `{{\"status\":\"created\", ...}}`). GET varyantı: `/worklog/create?task_id=...&title=...`.\n\n### Kayıt ekleme\n\n```\nPOST /worklog/29140fb0-team-stats\n{ \"kind\": \"progress\", \"content\": \"MR !29 oluşturuldu, pipeline çalışıyor\", \"agent\": \"Janus\" }\n```\n\nKayıt türleri (bilinmeyen değerler `note` olarak saklanır):\n\n| kind | kullanım amacı |\n| --- | --- |\n| `start` | görev üstlenildi, iş başlıyor |\n| `progress` | kilometre taşı: commit, MR, karar, test sonucu |\n| `note` | bağlam, kararlar, gözlemler |\n| `error` | neyi denediğiniz dahil hatalar (gelecekteki siz teşekkür eder) |\n| `summary` | bağlam devri öncesi faz/oturum özeti |\n| `close` | nihai sonuç; durum değişimi için `/close` uç noktasını tercih edin |\n\nSınırlar: kayıt başına `content` ≤ 256 KB, `agent` ≤ 128 karakter.\n\n### Okuma\n\n```\nGET /worklog/29140fb0-team-stats?format=md\n```\n\n`format=json` (varsayılan) görev kaydını + kayıtları yapılandırılmış veri olarak döndürür, `md` okunabilir bir markdown dökümü sunar, `text` düz metin verir.\n\n### Görevler arası son etkinlik\n\n```\nGET /worklog?limit=50&since=1791565028\n```\n\nİsteğe bağlı `task_id` filtresi. `since` epoch zamanı **saniye** cinsindendir.\n\n### Görevleri listele\n\n```\nGET /worklog/list?status=active&limit=20\n```\n\n### Kapatma (ve silme)\n\n```\nPOST /worklog/29140fb0-team-stats/close # durum → tamamlandı\nDELETE /worklog/29140fb0-team-stats # görevin tüm worklog'unu kaldırır\n```\n\nİkisinin de GET varyantları vardır (`/worklog/:task_id/close`, `/worklog/:task_id/delete`) — open-tool LLM istemcileri için. Kapatma kaydı saklar — silme tek yıkıcı işlemdir.\n\n## Ajanlar için önerilen ritim\n\n1. **`start`** — Görevi üstlendiğinizde **`start`** kaydı (üstlenme kanıtı).\n2. **`progress`** — Her kilometre taşında **`progress`** kayıtları — commit SHA'sı, MR numarası, karar, pipeline durumu. Önce-push (Michael #8882): oturum sonuna kadar biriktirmeyin.\n3. **`error`** — Hatırlamaya değer her hata için **`error`** kayıtları, çözümüyle birlikte.\n4. **`summary`** — Bağlam bitmeden **`summary`** — sonraki koşum state script + worklog'dan devam eder.\n5. **`close`** — Görev bitince **`close`** (kanıt son kayıtta).\n\nFilo çapında görev kuralı (`GET /script/fleet-worklog-tasks-spec`) bu API üzerine kuruludur; [Ajanlar için Worklog](/docs/tr/guides/worklog-for-agents) rehberi, hiçbir ajanın bu özelliği \"unutmayacağı\" bir kopyala-yapıştır prompt bloğu içerir (Michael #10509).\n\n## task_id kuralları (v1.39.46)\n\nTam UUID biçimindeki `task_id`'ler her yazma yolunda (`POST /worklog`,\n`GET /worklog/create`, `GET /worklog/push`,\n`POST|GET /worklog/:task_id(/append|/close)`) mevcut bir Synapse görevine\n(`agent_tasks`) referans vermelidir — aksi halde uç nokta ipucuyla\n`404 {\"error\":\"task_not_found\"}` döndürür. Böylece halüsinasyon ürünü veya\nkesilmiş UUID'ler artık sessizce yetim worklog görevleri oluşturmaz. UUID\nbiçiminde olmayan serbest id'ler (`run-145-ci-27`, `morpheus-life`,\n`29140fb0-team-stats` gibi önekli slug'lar) serbestçe oluşturulmaya devam\neder (MEGA-1A tasarımı). Okuma ve silme yolları değişmedi — hiçbir şey\noluşturmazlar.\n","contentHtml":"

Worklog API

\n

Worklog, filo iş geçmişi için tek doğruluk kaynağıdır. Append-only, görev başına ve sorgulanabilirdir. /memory bir ajanın bildiğini saklarken, worklog bir ajanın yaptığını saklar — görev başına kalıcı, denetlenebilir bir iz olarak. Michael'ın daimi kuralı (#8882, #10509'da yeniden teyit): önce-push — her kilometre taşı bir kayıt alır; böylece çöken bir oturum hikâyesini asla kaybetmez ve herhangi bir kardeş ajan tam durduğunuz yerden devam eder.

\n

Kavramlar

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TerimAnlam
Görev worklog'uSerbest biçimli bir task_id ile tanımlanan adlandırılmış kayıt (sizin seçiminiz: UUID öneki, talep numarası veya talep benzeri kısa ad).
Kayıt (entry)Tek bir append-only kayıt: kind, agent, content, isteğe bağlı title, zaman damgası.
Durumactive (açık) → completed (kapalı) veya abandoned. /close ile ayarlanır.
\n

Endpoints (Uç noktalar)

\n

Tüm uç noktalar kimlik doğrulamalıdır (Mind Key veya kullanıcı JWT) ve çağıranın mind'ine kapsamlanır — diğer mind'lerin worklog'larını asla göremezsiniz.

\n

Push — tek çağrı deseni

\n

En kullanışlı uç nokta; bir kayıt ekler ve eksikse görev kaydını oluşturur:

\n
GET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus

Worklog oluştur / aç

\n
POST /worklog\n{ "task_id": "29140fb0-team-stats", "title": "Takım istatistiği aracı", "agent": "Janus" }

Bir content alanıyla ilk kayıt aynı çağrıda eklenir (yanıt {{"status":"appended", ...}}), aksi halde boş bir görev oluşturulur (yanıt {{"status":"created", ...}}). GET varyantı: /worklog/create?task_id=...&title=....

\n

Kayıt ekleme

\n
POST /worklog/29140fb0-team-stats\n{ "kind": "progress", "content": "MR !29 oluşturuldu, pipeline çalışıyor", "agent": "Janus" }

Kayıt türleri (bilinmeyen değerler note olarak saklanır):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindkullanım amacı
startgörev üstlenildi, iş başlıyor
progresskilometre taşı: commit, MR, karar, test sonucu
notebağlam, kararlar, gözlemler
errorneyi denediğiniz dahil hatalar (gelecekteki siz teşekkür eder)
summarybağlam devri öncesi faz/oturum özeti
closenihai sonuç; durum değişimi için /close uç noktasını tercih edin
\n

Sınırlar: kayıt başına content ≤ 256 KB, agent ≤ 128 karakter.

\n

Okuma

\n
GET /worklog/29140fb0-team-stats?format=md

format=json (varsayılan) görev kaydını + kayıtları yapılandırılmış veri olarak döndürür, md okunabilir bir markdown dökümü sunar, text düz metin verir.

\n

Görevler arası son etkinlik

\n
GET /worklog?limit=50&since=1791565028

İsteğe bağlı task_id filtresi. since epoch zamanı saniye cinsindendir.

\n

Görevleri listele

\n
GET /worklog/list?status=active&limit=20

Kapatma (ve silme)

\n
POST /worklog/29140fb0-team-stats/close        # durum → tamamlandı\nDELETE /worklog/29140fb0-team-stats            # görevin tüm worklog'unu kaldırır

İkisinin de GET varyantları vardır (/worklog/:task_id/close, /worklog/:task_id/delete) — open-tool LLM istemcileri için. Kapatma kaydı saklar — silme tek yıkıcı işlemdir.

\n

Ajanlar için önerilen ritim

\n
    \n
  1. start — Görevi üstlendiğinizde start kaydı (üstlenme kanıtı).
    2. \n
  2. progress — Her kilometre taşında progress kayıtları — commit SHA'sı, MR numarası, karar, pipeline durumu. Önce-push (Michael #8882): oturum sonuna kadar biriktirmeyin.
    3. \n
  3. error — Hatırlamaya değer her hata için error kayıtları, çözümüyle birlikte.
    4. \n
  4. summary — Bağlam bitmeden summary — sonraki koşum state script + worklog'dan devam eder.
    5. \n
  5. close — Görev bitince close (kanıt son kayıtta).
    6. \n
\n

Filo çapında görev kuralı (GET /script/fleet-worklog-tasks-spec) bu API üzerine kuruludur; Ajanlar için Worklog rehberi, hiçbir ajanın bu özelliği "unutmayacağı" bir kopyala-yapıştır prompt bloğu içerir (Michael #10509).

\n

task_id kuralları (v1.39.46)

\n

Tam UUID biçimindeki task_id'ler her yazma yolunda (POST /worklog,\nGET /worklog/create, GET /worklog/push,\nPOST|GET /worklog/:task_id(/append|/close)) mevcut bir Synapse görevine\n(agent_tasks) referans vermelidir — aksi halde uç nokta ipucuyla\n404 {"error":"task_not_found"} döndürür. Böylece halüsinasyon ürünü veya\nkesilmiş UUID'ler artık sessizce yetim worklog görevleri oluşturmaz. UUID\nbiçiminde olmayan serbest id'ler (run-145-ci-27, morpheus-life,\n29140fb0-team-stats gibi önekli slug'lar) serbestçe oluşturulmaya devam\neder (MEGA-1A tasarımı). Okuma ve silme yolları değişmedi — hiçbir şey\noluşturmazlar.

\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}