SocialHub.AI
Rujukan kejuruteraan · Socialhub Harness

Masa jalan yang melaksanakan setiap pelakon AI

Model memberi anda bahasa. Ia tidak boleh, dengan sendirinya, mengasaskan dirinya dengan data sebenar anda dengan andal, memilih alat yang betul dan memanggilnya dengan betul, memulihkan apabila panggilan gagal, menjalankan tugas berbilang langkah sehingga selesai atau meninggalkan trajektori yang boleh anda mainkan semula. Socialhub Harness ialah masa jalan ejen perusahaan yang melakukan semua itu — enjin pelaksanaan yang menukar model yang berkebolehan kepada ejen yang boleh dipercayai.

Setiap pelakon AI dalam Flash — pengurus Pemasaran, Kesetiaan dan Risiko, rencam ahli dan setiap penjana di sebalik tabir — ialah Definisi Ejen: pelan tindakan berstruktur (penghalaan model, sumber konteks, kemahiran, setiap alatan dengan skop, permukaan MCP, aliran kerja, memori dan dasar gelung) yang dilaksanakan oleh masa jalan ini. Dan kerana setiap pelakon menjalankan satu runtime, tadbir urus bukanlah produk yang berasingan — ia adalah sifat struktur pelaksanaan terpadu: model memberikan bahasa; runtime memberikan tindakan; runtime terpadu memberikan tadbir urus secara percuma.

Rujukan ini ialah pandangan pembangun tentang masa jalan tersebut — apa yang dilakukannya pada masa pelaksanaan, jenis Definisi yang dilaksanakannya dan paksinya, bagaimana kemahiran disusun menjadi langkah yang dilaksanakan, trajektori yang boleh dihasilkan semula yang dipancarkan oleh setiap jalan ke dalam log peristiwa dan pengawal yang tidak menjalankan semuanya di satu tempat. Untuk gambaran keseluruhan perniagaan, lihat halaman produk Socialhub Harness.

Apa yang dilakukan oleh masa jalan pada masa pelaksanaan

Mulakan di sini, kerana inilah tujuan keseluruhan sistem. Apabila sesuatu larian bermula, masa larian Harness melakukan kerja yang tidak boleh dilakukan oleh model bahasa untuk dirinya sendiri — lima perkara di bawah, mengikut urutan — dan hasilnya ialah tugas yang dijalankan sehingga siap dan trajektori yang boleh anda mainkan semula.

1 · Context assembly

Waktu jalan mendasarkan pelakon: ia mengumpulkan fakta perniagaan ringkas dan sebenar — tugas, penggulungan ahli/segmen, kit jenama, metrik — setiap jalan, diminimumkan PII. Model tidak pernah meneka data anda; ia diserahkan kepadanya.

2 · Model routing

Masa jalan menyelesaikan enjin penaakulan yang melaksanakan setiap langkah, dengan sandaran, daripada apa yang dinamakan oleh Definisi. Penghalaan ialah tugas masa jalan, bukan gesaan.

3 · Skill composition into steps

Masa jalan menyuntik langkah tertib kemahiran tersusun dan panduan keputusan ke dalam gesaan, jadi apa yang dilaksanakan ialah prosedur berversi bernama — bukan apa sahaja model yang diimprovisasi.

4 · The tool loop

Masa jalan memacu gelung pilih-panggilan-pemerhati: ia memilih alat yang dikawal, menyemak kebenaran, memanggilnya, membaca hasilnya dan memulihkan atau meningkatkan prestasi apabila gagal — kebolehpercayaan yang tidak dimiliki oleh panggilan model kosong.

5 · A reproducible trajectory

Setiap langkah dipancarkan, mengikut urutan, ke dalam log peristiwa tambahan sahaja — dicap dengan ID larian dan versi pelan tindakan yang tepat — jadi larian boleh diaudit dan boleh dimainkan semula langkah demi langkah.

Model memberikan bahasa; masa jalan memberikan tindakan; masa jalan bersatu memberikan tadbir urus secara percuma. Semua di bawah — Definisi masa jalan dilaksanakan, cara kemahiran dibentuk, log peristiwa yang dihasilkannya dan pengawal yang dipegang — mengikuti daripada lima langkah ini yang berjalan di satu tempat untuk setiap pelakon.

Anatomi Definisi Ejen — apa yang dijalankan oleh masa jalan

Masa jalan melaksanakan Definisi: pelan tindakan berstruktur — bukan kod, bukan gesaan bentuk bebas — yang menyusun bahagian di bawah. Mengedit mana-mana daripadanya menghasilkan pelan tindakan berversi baharu yang diambil oleh masa jalan pada jalan seterusnya; versi tersebut dicap pada setiap peristiwa yang dijalankan.

Bahagian Cetak BiruApa yang digubahnya
penghalaan modelEnjin penaakulan yang melaksanakan setiap langkah — dan langkah tambahan. Ia menamakan model; masa jalan menyelesaikannya.
sumber konteksFakta ringkas dan perniagaan yang dimulakan oleh pelakon — tugasan, penggulungan ahli/segmen, kit jenama, metrik — dipasang setiap larian, diminimumkan PII.
kemahiranBuku panduan berstruktur yang digubah ke atas pelakon (lihat di bawah). Prosedur bernama, bukan gesaan bentuk bebas.
toolsTindakan terkawal yang mungkin diambil oleh pelakon — setiap satu dengan skop. Definisi menamakan alat; ia tidak pernah memberikannya. Pangkalan data adalah autoriti.
MCP permukaanAlat yang didedahkan melalui Protokol Konteks Model untuk ejen luaran yang memegang kunci berskop, dan di bawah gear yang mana.
aliran kerjaLangkah-langkah atau graf tersusun yang memacu masa jalan — tuntut, baca, putuskan, bertindak, lengkapkan — untuk senarai kerja dan pelakon yang diatur.
memoriApa yang mungkin dibawa oleh pelakon merentasi langkah dan larian, dan apa yang mesti dibaca semula setiap kali. Terikat, bukan pad gores untuk PII.
dasar gelungPeraturan berhenti: langkah maksimum, siling bajet dan keadaan peningkatan kepada manusia. Masa jalan menguatkuasakannya; pelakon tidak boleh melanjutkannya.

Ia menamakan keupayaan; ia tidak pernah memberikannya. Definisi boleh merujuk alat, model atau sumber data, tetapi sama ada ruang kerja ini dan kunci ini benar-benar boleh menggunakannya diselesaikan oleh masa jalan terhadap pangkalan data pada masa panggilan. Pelan tindakan ialah permukaan komposisi; kerana masa jalan menyelesaikan autoriti di satu tempat, pengawal di bawah disimpan secara percuma.

Satu jenis Definisi, diterangkan merentasi tiga paksi

Terdapat satu jenis Definition untuk setiap pelakon. Ia tidak bercabang setiap persona — ia diterangkan di sepanjang paksi ortogon, jadi masa jalan, log peristiwa dan pengawal yang sama terpakai sama ada pelakon itu ialah ejen luaran, gelung dalamFlash atau penjana pukulan tunggal.

PaksiNilaiApa yang ditangkapnya
runtimeFormmcp_external · server_orchestrator · inline_functionBAGAIMANA definisi tersebut dilaksanakan. mcp_external = ejen luaran yang memegang kunci berskop, memanggil masuk MCP. server_orchestrator = satu dalam-Flash gelung pemacu masa jalan langkah demi langkah. inline_function = penjana pukulan tunggal yang digunakan dalam aliran skrin.
agentTypeemployee · chatbot · functionAPAKAH ia kepada perniagaan. pekerja = pekerja bernama yang anda uruskan (matlamat, tugasan, maklum balas). chatbot = permukaan perbualan yang berasaskan data sebenar. fungsi = penjana atau pengelas tujuan tunggal tanpa persona.
jenis teknikalagent · generator · embedded · custom · workflowPengelasan kejuruteraan pelan tindakan — ejen berbilang langkah yang tersusun, penjana sebaris, keupayaan terbenam, definisi ruang kerja tersuai atau graf aliran kerja berbilang langkah.
domain perniagaansalah satu daripada 8 domain (kanan)BAHAGIAN MANA dalam perniagaan yang dilayaninya: Pemasaran & Kempen, Kesetiaan & Pengekalan, Risiko & Pematuhan, Khidmat Ahli, Kandungan & Kreatif, Kecerdasan Pelanggan, Analitis & Wawasan, Penyelidikan & Simulasi.

40+ pelakon yang dikawal, satu model. Senarai langsung ialah 5 ejen tersusun (berbilang langkah, diatur pelayan: empat pengurus dan concierge ahli), 28 fungsi sebaris (penjana dan pengelas pukulan tunggal yang diulir melalui produk), dan 8 keupayaan terbenam (pembantu aliran masuk pada skrin). Setiap satu daripadanya adalah jenis Definisi yang sama, hanya berbeza di sepanjang paksi di atas.

Kemahiran: buku permainan berwibawa pangkalan data yang dikarang kepada ejen

Kemahiran ialah buku panduan berstruktur , disimpan dalam pangkalan data dan digubah ke dalam pelan tindakan ejen seperti cara anda memberikan SOP kepada pekerja baharu. Ia bukan perenggan teks gesaan — ia adalah rekod yang ditaip dengan bahagian berikut:

trigger

Keadaan di mana kemahiran ini terpakai pada larian semasa.

required state

Keadaan ahli/perniagaan yang mesti hadir agar kemahiran dapat dijalankan secara bertanggungjawab — jika tiada, ia gagal untuk seseorang.

tool allowlist

Subset alat ejen yang mungkin digunakan oleh kemahiran ini — penyempitan, bukan pelebaran, daripada apa yang telah dibenarkan oleh pelan tindakan.

ordered steps

Prosedur yang dijalankan oleh masa jalan, mengikut urutan.

verifier rules

Semakan yang mesti lulus pada keputusan sebelum langkah dianggap selesai.

decision guidance

Cara memilih — termasuk bila hendak TAHAN atau eskalasi — dinyatakan sebagai panduan, bukan cawangan yang dikodkan secara tetap.

Semasa masa jalan, masa jalan — jadi apa yang dilaksanakan bukanlah "apa sahaja yang dihasilkan oleh model," tetapi prosedur bernama dan berversi yang boleh dibaca dan diluluskan oleh pasukan anda. Oleh kerana kemahiran adalah berwibawa pangkalan data, kemahiran yang sama boleh digubah ke atas lebih daripada satu ejen, dan mengubahnya mengubah setiap ejen yang menggunakannya — tiada penggunaan semula.

Output masa jalan: trajektori yang boleh dihasilkan semula

Menghasilkan trajektori yang boleh dimainkan semula adalah langkah 5 daripada apa yang dilakukan oleh masa jalan — dan ia juga merupakan bukti audit anda. Apa pun pelakon dan bagaimana ia dijalankan, setiap larian memancarkan aliran peristiwa ke dalam satu log peristiwa tambahan sahaja . Setiap peristiwa dicap dengan ID larian dan versi pelan tindakan (definisi) tepat yang menghasilkannya — jadi larian boleh diaudit dan dimainkan semula. Jenis peristiwa tersusun yang dipancarkan oleh larian:

01jalan dimulakan02niat pengguna03konteks dimuatkan04model dipilih05gesaan dipasang06penaakulan07semak kebenaran08alat dipanggil09keputusan alat10tindakan / hasil11kos12jalan tamat

Bersebelahan dengan ini, log membawa panggilan alat MCP yang dicerminkan (apabila pelakon memacu Flash ke atas MCP) dan hasil perniagaan penutup — jadi trajektori, dari niat kepada 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 trajektori larian melalui aplikasi Flash. Ambil satu larian mengikut ID, atau senaraikan larian terkini:

# 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 ditambah — log ialah sejarah lengkap tentang apa yang dilakukan oleh setiap pelakon dan sebabnya, boleh dibina semula langkah demi langkah daripada ID larian yang dicop dan versi pelan tindakan.

Tadbir urus secara percuma: lima pengawal tertutup gagal

Berikut ialah hasil daripada masa jalan bersatu. Oleh kerana setiap pelaksanaan pelakon mengalir melalui satu masa jalan, lantai keselamatan tidak perlu diikat pada setiap ejen — ia merupakan sifat struktur tempat tunggal semua tindakan melaluinya. Lima pengawal ini dimiliki oleh kod, dijalankan di bawah setiap pelakon pada setiap tindakan, dan tiada tetapan yang boleh mematikannya. Komposisi Definisi — kemahiran, alatan, model dan konteksnya — adalah milik anda untuk dikonfigurasikan dalam konsol Pekerja AI; pengawal di bawah tidak.

PengawalApa yang dikuatkuasakannya
Skop kebenaran × peringkat pelanSetiap panggilan alat disemak terhadap skop kunci DAN peringkat pelan ruang kerja. Definisi menamakan alat; kuasa untuk menjalankannya berada dalam pangkalan data, diselesaikan pada masa panggilan. Alat yang tidak dapat dicapai oleh kunci hanya tersembunyi.
Had nilai tulis + kadarPenulisan yang menggerakkan nilai (mata, kupon) dibatasi oleh had nilai setiap panggilan dan had kadar penulisan setiap kekunci, kedua-duanya dikuatkuasakan sebagai penutupan kegagalan pada pelayan — bebas daripada apa-apa yang dituntut oleh gesaan pelakon atau pengesahan pihak klien.
Lejar belanjawanSetiap larian dilaksanakan di dalam bajet token + kos, dicaj terlebih dahulu sebelum pelakon bertindak dan dikeluarkan semasa ia dijalankan. Apabila lejar habis, larian berhenti — pelakon tidak boleh lari dengan perbelanjaan.
Kill-switchMana-mana pelakon — keseluruhan definisi atau tindakan tunggal — boleh dijeda serta-merta. Dimatikan secara lalai, dihadkan apabila dihidupkan dan boleh dihentikan sebaik sahaja anda mahu ia berhenti.
AuditSetiap langkah ditulis pada log peristiwa tambahan sahaja dengan ID jalanan dan versi pelan tindakan yang tepat. Tiada apa yang dilakukan oleh pelakon tidak direkodkan, dan tiada tetapan yang boleh menyekat entri log.

Konfigurasikan komposisi pada /flash/agents. Konsol Pekerja AI ialah tempat anda mengedit kemahiran, alatan, model dan konteks pelakon — menghasilkan pelan tindakan versi baharu. Apa yang anda tidak boleh edit di sana ialah lantai keselamatan: lima pengawal di atas dikuatkuasakan dalam kod, bukan dalam konfigurasi.

Di mana Harness sesuai dengan platform lain

Harness ialah masa pelaksanaan di bawah setiap pelakon AI — dan, kerana semuanya berjalan melaluinya, lapisan tadbir urus juga. Dua rujukan bersebelahan merangkumi bahagian yang menjadi sandarannya:

  • MCP permukaan. Aktor mcp_external memegang kunci berskop dan memanggil alat yang dikawal Flash melalui Protokol Konteks Model. Titik akhir, pengesahan, konfigurasi klien dan katalog alat penuh terdapat dalam panduan Integrasi MCP.
  • Peralatan & kelulusan kebenaran. Peralatan setiap tindakan (auto / semakan / dilarang), semantik penulisan yang belum selesai / ditolak dan kitaran hayat kelulusan yang berada di atas pengawal kebenaran didokumenkan dalam Tadbir Urus AI: Muhasabah Diri & Kelulusan.