Lewati ke konten utama

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​

FieldArti
name, environment, deployed_refNama yang dikelola dan konfigurasi proses API ini. Ref dapat null.
required_label, configured_labelLabel yang diwajibkan environment dan konfigurasi sebenarnya. Saat pengelolaan nonaktif keduanya dapat berbeda.
tracing_enabled, prompt_management_enabledFlag integrasi dan pemilihan runtime yang terpisah.
configured_sourcefile kecuali kedua flag aktif; jika keduanya aktif nilainya langfuse. Ini konfigurasi, bukan hasil fetch.
remote_availableKeberhasilan pembacaan administratif. Kegagalan remote tetap menghasilkan 200 dengan false agar observasi lokal dapat dibaca.
remote_selectionNull jika tidak tersedia atau tidak memiliki versi; selain itu berisi version, label, dan selection_reason.
pathsEntri /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.