Status runtime prompt editorial
GET /prompts/{name}/runtime menjelaskan sumber editorial yang dikonfigurasi untuk chat
biasa dan artefak terakhir yang berhasil di-resolve oleh layanan yang melayani permintaan.
Satu-satunya nama yang dikelola adalah agent-editorial. Penerbitan versi immutable atau
pemindahan label Langfuse tidak mengaktifkan pengelolaan runtime. Playground memilih
kandidatnya secara terpisah.
Route memerlukan API key yang dikonfigurasi dan principal admin terverifikasi. Pada
deployment JWT, header X-User-* diabaikan dan token bearer admin terverifikasi wajib ada.
Kredensial tidak ada menghasilkan 401, non-admin terverifikasi 403, dan autentikasi
nonaktif 503. Pengecualian sementara API-key-only untuk GET /prompts tidak memberikan
akses status runtime. Nama yang tidak dikelola menghasilkan 404. Respons berhasil memakai
Cache-Control: no-store.
Respons
| Field | Arti |
|---|---|
name, environment, deployed_ref | Nama yang dikelola dan konfigurasi proses API ini. Ref dapat null. |
required_label, configured_label | Label yang diwajibkan environment dan konfigurasi sebenarnya. Saat pengelolaan nonaktif keduanya dapat berbeda. |
tracing_enabled, prompt_management_enabled | Flag integrasi dan pemilihan runtime yang terpisah. |
configured_source | file kecuali kedua flag aktif; jika keduanya aktif nilainya langfuse. Ini konfigurasi, bukan hasil fetch. |
remote_available | Keberhasilan pembacaan administratif. Kegagalan remote tetap menghasilkan 200 dengan false agar observasi lokal dapat dibaca. |
remote_selection | Null jika tidak tersedia atau tidak memiliki versi; selain itu berisi version, label, dan selection_reason. |
paths | Entri /query dan /query/v2: enabled untuk route, initialized untuk layanan, serta last_resolved. JSON dan SSE berbagi layanan pada route tersebut. |
selection_reason bernilai environment_label bila label environment yang dikonfigurasi
memilih versi tersebut; selain itu newest_version. Nilai kedua dapat terjadi ketika
konfigurasi memakai latest atau label environment tidak ditemukan. Respons lama /prompts
tetap mempertahankan active_version dan label; keduanya menggambarkan administrasi,
bukan penggunaan oleh runtime.
last_resolved bernilai null sampai layanan yang melayani permintaan berhasil melakukan
resolusi artefak. Jika ada, bentuknya:
{
"resolved_at": "2026-11-11T10:00:00Z",
"prompt": {
"name": "agent-editorial",
"version": null,
"label": "production",
"source": "file",
"contract_version": "agent-editorial-v1"
},
"content_sha256": "<SHA-256 pesan yang dikonsumsi dalam bentuk kanonis>"
}
Contoh ini memakai file walaupun label konfigurasi adalah production. Sumber dapat berupa
file, langfuse, langfuse_last_good, atau kandidat yang secara eksplisit diinjeksi pada
pengujian. Permintaan Playground biasa tidak mengisi observasi kedua route normal.
Restart/penggantian layanan menghapus observasi. Pembacaan status tidak membangun atau
melakukan resolusi provider. Body prompt, kredensial, pertanyaan, passage, dan identitas
pengguna tidak disertakan.
Hash mencakup urutan objek pesan {role, content}, berupa JSON UTF-8 dengan
ensure_ascii=false dan separator ringkas. Field audit per jawaban editorial_prompt
memuat hash serta provenance yang sama; synthesis.prompt pada jawaban tersimpan tetap
mempertahankan lima field provenance.
Tampilan dan rollback
Tampilkan pilihan label remote secara terpisah dari sumber konfigurasi dan artefak terakhir yang diamati. Tandai layanan yang belum diamati. Resolusi dapat mendahului publikasi atau mengalami kegagalan setelahnya; permintaan bersamaan dapat terbit dengan urutan berbeda. Status ini bukan hasil verifikasi kepatuhan bahasa atau catatan persetujuan. Konfirmasi provenance tersimpan dan trace masing-masing jawaban untuk memverifikasi rollout/rollback.
SDK dapat mengembalikan cache lama dengan source=langfuse selama refresh, termasuk ketika
refresh berulang kali gagal. Pemindahan label melalui admin pada proses yang sama
menginvalidasi cache, tetapi perubahan eksternal dan respons yang masih berjalan dapat
menyisakan konten lama. Respons publish atau TTL yang berlalu tidak membuktikan rollback
selesai. Aktivasi produksi dan pemindahan label tetap memerlukan tinjauan, evaluasi, serta
catatan perubahan yang terpisah. Pesan penolakan/error buatan kode mempertahankan lokalisasi
yang berlaku.