SocialHub.AI
Referensi teknik · Socialhub Harness

Runtime yang menjalankan setiap aktor AI

Sebuah model memberi Anda bahasa. Model itu sendiri tidak dapat secara andal mendasarkan dirinya pada data nyata Anda, memilih alat yang tepat dan memanggilnya dengan benar, pulih ketika panggilan gagal, menjalankan tugas multi-langkah hingga selesai, atau meninggalkan jejak yang dapat Anda putar ulang. Socialhub Harness adalah runtime agen perusahaan yang melakukan semua itu — mesin eksekusi yang mengubah model yang mumpuni menjadi agen yang dapat diandalkan.

Setiap aktor AI di Flash — manajer Pemasaran, Loyalitas, dan Risiko, petugas layanan anggota, dan setiap generator di balik layar — adalah Definisi Agen: cetak biru terstruktur (perutean model, sumber konteks, keterampilan, alat masing-masing dengan cakupan, permukaan MCP, alur kerja, memori, dan kebijakan perulangan) yang dieksekusi oleh runtime ini. Dan karena setiap aktor berjalan melalui satu runtime, tata kelola bukanlah produk terpisah — ini adalah properti struktural dari eksekusi terpadu: model memberikan bahasa; runtime memberikan tindakan; runtime terpadu memberikan tata kelola secara gratis.

Referensi ini adalah pandangan pengembang tentang runtime tersebut — apa yang dilakukannya pada saat eksekusi, tipe Definisi yang dieksekusi dan sumbunya, bagaimana keterampilan tersusun menjadi langkah-langkah yang dieksekusi, lintasan yang dapat direproduksi yang dipancarkan setiap eksekusi ke dalam log peristiwa, dan pengaman yang muncul dari menjalankan semuanya di satu tempat. Untuk gambaran umum bisnis, lihat halaman produk Socialhub Harness.

Apa yang dilakukan runtime pada saat eksekusi

Mulailah dari sini, karena inilah inti dari keseluruhan sistem. Ketika sebuah eksekusi dimulai, runtime Harness melakukan pekerjaan yang tidak dapat dilakukan oleh model bahasa itu sendiri — lima hal di bawah ini, secara berurutan — dan hasilnya adalah tugas yang diselesaikan dan sebuah lintasan yang dapat Anda putar ulang.

1 · Context assembly

Runtime mendasari aktor: ia menyusun ringkasan dan fakta bisnis nyata — tugas, ringkasan anggota/segmen, perlengkapan merek, metrik — per eksekusi, dengan PII yang diminimalkan. Model tidak pernah menebak data Anda; data tersebut diberikan kepadanya.

2 · Model routing

Runtime menentukan mesin penalaran mana yang mengeksekusi setiap langkah, dengan mekanisme cadangan, dari apa yang dinamai Definisi. Pengaturan rute adalah tugas runtime, bukan prompt.

3 · Skill composition into steps

Runtime menyuntikkan langkah-langkah terurut dan panduan pengambilan keputusan dari keterampilan yang disusun ke dalam perintah, sehingga yang dieksekusi adalah prosedur bernama dan berversi — bukan apa pun yang diimprovisasi oleh model.

4 · The tool loop

Runtime menggerakkan loop pilih-panggil-amati: ia memilih alat yang diatur, memeriksa izin, memanggilnya, membaca hasilnya, dan memulihkan atau meningkatkan jika terjadi kegagalan — keandalan yang tidak dimiliki oleh panggilan model biasa.

5 · A reproducible trajectory

Setiap langkah dipancarkan, secara berurutan, ke dalam log peristiwa hanya-tambah — dicap dengan ID eksekusi dan versi cetak biru yang tepat — sehingga eksekusi dapat diaudit dan diputar ulang langkah demi langkah.

Sebuah model memberikan bahasa; runtime memberikan aksi; runtime terpadu memberikan tata kelola secara gratis. Semua yang di bawah ini — Definisi yang dieksekusi oleh runtime, bagaimana keterampilan disusun, log peristiwa yang dihasilkannya, dan penjaga yang menahannya — mengikuti dari lima langkah ini yang berjalan di satu tempat untuk setiap aktor.

Anatomi Definisi Agen — apa yang dieksekusi oleh runtime

Runtime mengeksekusi Definisi: cetak biru terstruktur — bukan kode, bukan prompt bentuk bebas — yang menyusun bagian-bagian di bawah ini. Mengedit salah satu di antaranya menghasilkan cetak biru versi baru yang diambil oleh runtime pada eksekusi berikutnya; versi tersebut dicap pada setiap peristiwa yang dipancarkan oleh eksekusi tersebut.

Bagian Cetak BiruApa yang terkandung di dalamnya
perutean modelMesin penalaran mana yang mengeksekusi setiap langkah — dan mekanisme cadangannya. Mesin ini memberi nama model; runtime menyelesaikannya.
sumber konteksRingkasan dan fakta bisnis yang menjadi dasar aktor — tugas, ringkasan anggota/segmen, perlengkapan merek, metrik — disusun per proses, dengan minimalisasi PII.
keterampilanBuku panduan terstruktur yang disusun pada aktor (lihat di bawah). Prosedur bernama, bukan petunjuk bentuk bebas.
alatTindakan yang diatur yang dapat dilakukan aktor — masing-masing dengan cakupan. Definisi menyebutkan sebuah alat; definisi tidak pernah memberikannya. Basis data adalah otoritasnya.
Permukaan MCPAlat mana yang diekspos melalui Protokol Konteks Model untuk agen eksternal yang memegang kunci lingkup, dan di bawah perangkat mana.
alur kerjaLangkah-langkah berurutan atau grafik yang dijalankan oleh runtime — klaim, baca, putuskan, bertindak, selesaikan — untuk daftar kerja dan aktor yang diatur.
memoriApa yang mungkin dibawa aktor di sepanjang langkah dan proses, dan apa yang harus dibaca ulang setiap kali. Terbatas, bukan tempat untuk mencatat informasi pribadi.
kebijakan perulanganAturan penghentian: langkah maksimum, batas anggaran, dan kondisi peningkatan ke manusia. Runtime memberlakukannya; aktor tidak dapat memperpanjangnya.

Ini menamai kemampuan; tidak pernah memberikannya. Sebuah Definisi dapat merujuk pada alat, model, atau sumber data, tetapi apakah ruang kerja ini dan kunci ini benar-benar dapat menggunakannya diselesaikan oleh runtime terhadap basis data pada saat pemanggilan. Cetak biru adalah permukaan komposisi; karena runtime menyelesaikan otoritas di satu tempat, penjaga di bawahnya berlaku secara gratis.

Satu tipe Definisi, dijelaskan melalui tiga sumbu

Terdapat satu tipe Definition untuk setiap aktor. Tipe ini tidak bercabang per persona — tipe ini dijelaskan di sepanjang sumbu ortogonal, sehingga runtime, log peristiwa, dan pengaman yang sama berlaku terlepas dari apakah aktor tersebut adalah agen eksternal, loop dalam Flash, atau generator sekali pakai.

AxisNilaiApa yang ditangkapnya
runtimeFormmcp_external · server_orchestrator · inline_functionBAGAIMANA definisi dieksekusi. mcp_external = agen eksternal yang memegang kunci lingkup, memanggil melalui MCP. server_orchestrator = loop dalam Flash yang dijalankan runtime langkah demi langkah. inline_function = generator sekali jalan yang dipanggil dalam alur layar.
agentTypeemployee · chatbot · functionAPA artinya bagi bisnis. karyawan = pekerja bernama yang Anda kelola (tujuan, tugas, umpan balik). chatbot = antarmuka percakapan yang didasarkan pada data nyata. fungsi = generator atau pengklasifikasi satu tujuan tanpa persona.
jenis teknisagent · generator · embedded · custom · workflowKlasifikasi teknik cetak biru — agen multi-langkah yang tersusun, generator sebaris, kemampuan tertanam, definisi khusus ruang kerja, atau grafik alur kerja multi-langkah.
domain bisnissalah satu dari 8 domain (kanan)BAGIAN bisnis mana yang dilayaninya: Pemasaran & Kampanye, Loyalitas & Retensi, Risiko & Kepatuhan, Layanan Anggota, Konten & Kreatif, Intelijen Pelanggan, Analitik & Wawasan, Riset & Simulasi.

40+ aktor yang diatur, satu model. Daftar aktifnya adalah 5 agen yang tersusun (multi-langkah, diatur oleh server: empat manajer ditambah petugas layanan pelanggan), 28 fungsi sebaris (generator dan pengklasifikasi sekali pakai yang terintegrasi dalam produk), dan 8 kemampuan tertanam (pembantu dalam alur pada layar). Masing-masing memiliki tipe Definisi yang sama, hanya berbeda di sepanjang sumbu di atas.

Keterampilan: buku panduan berbasis basis data yang disusun untuk seorang agen

Skill adalah panduan terstruktur, yang disimpan dalam basis data dan disusun ke dalam cetak biru agen seperti halnya Anda memberikan SOP kepada karyawan baru. Ini bukan paragraf teks petunjuk — ini adalah catatan tertulis dengan bagian-bagian berikut:

trigger

Kondisi di mana keterampilan ini berlaku untuk proses saat ini.

required state

Status anggota/bisnis yang harus ada agar keterampilan dapat berjalan secara bertanggung jawab — jika tidak ada, keterampilan tersebut gagal dan tidak dapat diakses oleh seseorang.

tool allowlist

Subset alat agen yang dapat digunakan oleh keterampilan ini — penyempitan, bukan perluasan, dari apa yang sudah diizinkan oleh cetak biru.

ordered steps

Prosedur yang dijalankan runtime, secara berurutan.

verifier rules

Pemeriksaan yang harus dilewati pada hasilnya sebelum langkah tersebut dianggap selesai.

decision guidance

Cara memilih — termasuk kapan harus MENAHAN atau meningkatkan — dinyatakan sebagai panduan, bukan cabang yang dikodekan secara kaku.

Saat dijalankan, runtime — sehingga yang dieksekusi bukanlah “apa pun yang dihasilkan model,” tetapi prosedur bernama dan berversi yang dapat dibaca dan disetujui oleh tim Anda. Karena keterampilan bersifat otoritatif basis data, keterampilan yang sama dapat disusun ke lebih dari satu agen, dan mengubahnya akan mengubah setiap agen yang menggunakannya — tanpa penyebaran ulang.

Output runtime: lintasan yang dapat direproduksi

Memproduksi lintasan yang dapat diputar ulang adalah langkah ke-5 dari apa yang dilakukan runtime — dan itu juga merupakan bukti audit Anda. Apa pun aktornya dan bagaimana pun cara kerjanya, setiap eksekusi memancarkan aliran peristiwa ke dalam satu log peristiwa hanya-tambah. Setiap peristiwa diberi cap dengan ID eksekusi dan versi cetak biru (definisi) yang tepat yang menghasilkannya — sehingga suatu eksekusi dapat diaudit dan diputar ulang. Jenis peristiwa yang dipancarkan oleh suatu eksekusi adalah:

01jalankan dimulai02niat pengguna03konteks dimuat04model yang dipilih05prompt assembled06alasan07Pemeriksaan izin08alat yang disebut09Hasil alat10aksi / hasil11Biaya12proses berakhir

Bersamaan dengan itu, log tersebut memuat panggilan alat MCP yang dicerminkan (ketika aktor menggerakkan Flash di atas MCP) dan hasil bisnis penutup — sehingga lintasan, dari niat hingga hasil, berada di satu tempat.

// one run's trajectory (abbreviated — every event carries runId + definitionVersion)
{
  "runId": "run_a1f9…",
  "definition": "loyalty-manager",
  "definitionVersion": 4,
  "events": [
    { "type": "run_started",     "at": "2026-08-26T09:14:02Z" },
    { "type": "user_intent",     "intent": "work the win-back worklist" },
    { "type": "context_loaded",  "sources": ["task", "member_rollup", "churn_signal"] },
    { "type": "model_selected",  "model": "…" },
    { "type": "prompt_assembled","skill": "winback-worklist-execution" },
    { "type": "reasoning",       "summary": "high value, at-risk, consented" },
    { "type": "permission_check","tool": "issue_coupon", "result": "allowed" },
    { "type": "tool_called",     "tool": "issue_coupon", "args": { "value": 10 } },
    { "type": "tool_result",     "ok": true },
    { "type": "cost",            "tokens": 3120, "usd": 0.04 },
    { "type": "run_ended",       "outcome": "coupon issued · within budget" }
  ]
}

Baca lintasan lari melalui aplikasi Flash. Ambil satu lari berdasarkan ID, atau daftar lari terbaru:

# one run's full trajectory
GET https://flash.socialhub.ai/api/flash/agent-runs/{runId}

# list recent runs
GET https://flash.socialhub.ai/api/flash/agent-runs

Entri tidak pernah diedit, hanya ditambahkan — log adalah riwayat lengkap tentang apa yang dilakukan setiap aktor dan mengapa, dapat direkonstruksi langkah demi langkah dari ID eksekusi yang dicap dan versi cetak biru.

Tata kelola gratis: lima pengaman yang tertutup karena gagal

Berikut adalah manfaat dari runtime terpadu. Karena eksekusi setiap aktor mengalir melalui satu runtime, batas keamanan tidak perlu dipasang pada setiap agen — itu adalah properti struktural dari satu tempat semua tindakan melewatinya. Kelima penjaga ini dimiliki oleh kode, dijalankan di bawah setiap aktor pada setiap tindakan, dan tidak ada pengaturan yang dapat mematikannya. komposisi dari sebuah Definisi — keterampilan, alat, model, dan konteksnya — dapat Anda konfigurasikan di konsol Karyawan AI; penjaga di bawah ini tidak.

PenjagaApa yang ditegakkannya
Lingkup otorisasi × ​​tingkat paketSetiap panggilan alat diperiksa terhadap cakupan kunci DAN tingkatan rencana ruang kerja. Definisi tersebut menamai sebuah alat; wewenang untuk menjalankannya berada di dalam basis data, yang diselesaikan pada saat pemanggilan. Alat yang tidak dapat dijangkau oleh kunci tersebut akan disembunyikan.
Batas nilai tulis + tarifPenulisan yang menghasilkan nilai (poin, kupon) dibatasi oleh batas nilai per panggilan dan batas laju penulisan per kunci, keduanya diberlakukan secara fail-closed di server — terlepas dari apa pun yang diklaim oleh permintaan aktor atau konfirmasi sisi klien.
Buku AnggaranSetiap eksekusi dijalankan di dalam anggaran token + biaya, yang telah diisi sebelum aktor bertindak dan dikurangi saat dijalankan. Ketika buku besar habis, eksekusi berhenti — aktor tidak akan pernah bisa melampaui pengeluaran.
Tombol pemutusSetiap aktor — seluruh definisi atau satu tindakan — dapat dijeda secara instan. Nonaktif secara default, dibatasi saat aktif, dan dapat dihentikan saat Anda ingin menghentikannya.
AuditSetiap langkah ditulis ke log peristiwa hanya-tambah dengan ID eksekusi dan versi cetak biru yang tepat. Tidak ada yang dilakukan aktor yang tidak tercatat, dan tidak ada pengaturan yang dapat menekan entri log.

Konfigurasikan komposisi di /flash/agents. Konsol Karyawan AI adalah tempat Anda mengedit keterampilan, alat, model, dan konteks aktor — menghasilkan cetak biru versi baru. Yang tidak pernah dapat Anda edit di sana adalah batas keamanan: lima pengaman di atas diberlakukan dalam kode, bukan dalam konfigurasi.

Di mana Harness cocok dengan bagian platform lainnya

Harness adalah runtime eksekusi di bawah setiap aktor AI — dan, karena semuanya berjalan melaluinya, lapisan tata kelola juga. Dua referensi yang berdekatan mencakup bagian-bagian yang diandalkannya:

  • MCP permukaan. Aktor mcp_external memegang kunci lingkup dan memanggil alat yang diatur oleh Flash melalui Protokol Konteks Model. Titik akhir, otentikasi, konfigurasi klien, dan katalog alat lengkap ada di panduan Integrasi MCP.
  • Mekanisme otorisasi & persetujuan. Mekanisme per tindakan (otomatis / tinjauan / terlarang), semantik penulisan tertunda / ditolak, dan siklus hidup persetujuan yang berada di atas pengaman otorisasi didokumentasikan dalam Tata Kelola AI: Introspeksi & Persetujuan.