SocialHub.AI
Mühendislik referansı · Socialhub Harness

Her yapay zeka aktörünü çalıştıran çalışma zamanı ortamı

Bir model size dil sağlar. Tek başına, gerçek verilerinize güvenilir bir şekilde bağlanamaz, doğru aracı seçip doğru şekilde çağıramaz, bir çağrı başarısız olduğunda kurtarma işlemini gerçekleştiremez, çok adımlı bir görevi tamamlanana kadar yürütemez veya tekrar oynatabileceğiniz bir yol bırakamaz. Socialhub Harness, tüm bunları yapan kurumsal ajan çalışma zamanı'dır; yetenekli bir modeli güvenilir bir ajana dönüştüren yürütme motorudur.

Flash'deki her yapay zeka aktörü — Pazarlama, Sadakat ve Risk yöneticileri, üye danışmanı ve perde arkasındaki her jeneratör — bir Ajan Tanımı'dır: bu çalışma zamanının yürüttüğü yapılandırılmış bir şablon (model yönlendirme, bağlam kaynakları, beceriler, her birinin bir kapsamı olan araçlar, bir MCP yüzey, iş akışı, bellek ve bir döngü politikası). Ve her aktör tek bir çalışma zamanı üzerinden çalıştığı için, yönetişim ayrı bir ürün değil, birleşik yürütmenin yapısal bir özelliğidir: bir model dil sağlar; bir çalışma zamanı eylem sağlar; birleşik bir çalışma zamanı ise yönetişimi ücretsiz olarak sağlar.

Bu referans, geliştiricinin o çalışma zamanına ilişkin görüşüdür - yürütme zamanında ne yaptığı, yürüttüğü Tanım türü ve eksenleri, becerilerin yürütülen adımlar halinde nasıl oluşturulduğu, her çalıştırmanın olay günlüğüne yaydığı tekrarlanabilir yörünge ve her şeyi tek bir yerde çalıştırmanın dışında kalan korumalar. İşletmeye genel bakış için Socialhub Harness ürün sayfasına bakın.

Çalışma zamanının yürütme sırasında yaptığı işlemler

Buradan başlayın, çünkü tüm sistemin amacı bu. Bir çalıştırma başladığında, Harness çalışma zamanı, bir dil modelinin kendi başına yapamayacağı işleri (aşağıdaki beş şeyi sırasıyla) yapar ve sonuç olarak görev tamamlanır ve, tekrar oynatabileceğiniz bir yol haritası elde edilir.

1 · Context assembly

Çalışma zamanı, aktörü temel alır: her çalıştırmada özeti ve gerçek iş verilerini (görev, üye/segment özetleri, marka kiti, metrikler) bir araya getirir, kişisel tanımlayıcı bilgileri en aza indirir. Model asla verilerinizi tahmin etmez; veriler ona verilir.

2 · Model routing

Çalışma zamanı, Tanım adlarından yola çıkarak, her adımda hangi mantık motorunun çalıştırılacağını, yedek seçeneklerle birlikte belirler. Yönlendirme, komut isteminin değil, çalışma zamanının işidir.

3 · Skill composition into steps

Çalışma zamanı, oluşturulan becerilerin sıralı adımlarını ve karar rehberliğini komut istemine enjekte eder, dolayısıyla yürütülen şey, modelin doğaçlama yaptığı ne olursa olsun, adlandırılmış, sürümü oluşturulmuş bir prosedürdür.

4 · The tool loop

Çalışma zamanı, seç-çağrı-gözle döngüsünü yönlendirir: yönetilen bir aracı seçer, izni kontrol eder, onu çağırır, sonucu okur ve hata durumunda kurtarır veya üst kademeye yükseltir; bu, çıplak model çağrısının sahip olmadığı güvenilirliktir.

5 · A reproducible trajectory

Her adım, sırayla, yalnızca ekleme yapılabilen olay günlüğüne - bir çalıştırma kimliği ve tam şablon sürümüyle damgalanmış olarak - kaydedilir, böylece çalıştırma denetlenebilir ve adım adım tekrar oynatılabilir.

Bir model dil sağlar; bir çalışma zamanı eylem sağlar; birleşik bir çalışma zamanı ise ücretsiz olarak yönetişim sağlar. Aşağıdaki her şey — çalışma zamanının yürüttüğü Tanım, becerilerin nasıl oluşturulduğu, ürettiği olay günlüğü ve tuttuğu koruyucular — her aktör için tek bir yerde çalışan bu beş adımdan kaynaklanır.

Bir Aracının Anatomisi Tanımı — çalışma zamanının yürüttüğü işlemler

Çalışma zamanı bir Tanım yürütür: aşağıdaki parçaları oluşturan yapılandırılmış bir şablon — kod değil, serbest biçimli bir istem değil. Bunlardan herhangi birini düzenlemek, çalışma zamanının bir sonraki çalıştırmada alacağı yeni bir sürümlü şablon oluşturur; sürüm, o çalıştırmanın yaydığı her olaya damgalanır.

Plan bölümüNelerden oluşur
model yönlendirmeHer adımı ve geri dönüşleri hangi akıl yürütme motorunun yürüttüğü. Modelin adını verir; çalışma zamanı bu sorunu çözer.
bağlam kaynaklarıAktörün başladığı özet ve iş bilgileri — görev, üye/segment özetleri, marka kiti, metrikler — her çalıştırma için derlenir, kişisel veriler en aza indirilir.
becerilerAktöre oluşturulmuş yapılandırılmış oyun kitapları (aşağıya bakınız). Serbest biçimli istemler değil, adlandırılmış prosedürler.
araçlarAktörün alabileceği, her birinin bir kapsamı olan yönetilen eylemler. Tanım bir aracı adlandırır; asla onu vermez. Veritabanı otoritedir.
MCP yüzeyKapsamlı bir anahtarı elinde bulunduran harici bir aracı için Model Bağlam Protokolü üzerinden hangi araçların ve hangi dişlilerin altında kullanıma sunulduğu.
iş akışıSıralı adımlar veya grafik, iş listesi ve yönetilen aktörler için çalışma zamanının (talep etme, okuma, karar verme, eyleme geçme, tamamlama) harekete geçmesini sağlar.
bellekOyuncunun adımlar ve koşular boyunca taşıyabileceği ve her seferinde yeniden okuması gerekenler. Sınırlandırılmış, kişisel bilgilerin karalama defteri değil.
döngü politikasıDurdurma kuralı: maksimum adım, bütçe tavanı ve insana yükseltme durumu. Çalışma zamanı bunu zorunlu kılar; oyuncu bunu uzatamaz.

Yetenekleri adlandırır; asla yetkilendirmez. Bir Tanım, bir araca, bir modele veya bir veri kaynağına referans verebilir, ancak bu çalışma alanının ve bu anahtarın bunu gerçekten kullanıp kullanamayacağı, çalışma zamanı tarafından çağrı zamanında veritabanına karşı çözülür. Şablon, birleştirme yüzeyidir; çalışma zamanı yetkiyi tek bir yerde çözdüğü için, aşağıdaki koruyucular ücretsiz olarak geçerlidir.

Üç eksen boyunca tanımlanan bir Tanım türü

Her aktör için tek bir Definition türü vardır. Kişiye göre çatallanmaz — ortogonal eksenler boyunca açıklanır, bu nedenle aktörün harici bir ajan, Flash döngüsü içinde veya tek seferlik bir jeneratör olup olmadığına bakılmaksızın aynı çalışma zamanı, olay günlüğü ve koruyucular geçerlidir.

AxisDeğerlerNe yakalar
runtimeFormmcp_external · server_orchestrator · inline_functionTanımın NASIL yürütüldüğü. mcp_external = kapsam dahilindeki bir anahtarı tutan ve MCP üzerinden çağrı yapan harici bir aracı. server_orchestrator = çalışma zamanı sürücülerini adım adım bir Flash döngüsüne sokar. inline_function = bir ekranın akışında çağrılan tek atışlı bir oluşturucu.
agentTypeemployee · chatbot · functionİşletme için NEDİR? Çalışan = yönettiğiniz (hedefler, görevler, geri bildirim) isimli bir çalışan. Sohbet robotu = gerçek verilere dayalı konuşma yüzeyi. Fonksiyon = kişiliği olmayan tek amaçlı bir jeneratör veya sınıflandırıcı.
teknik türagent · generator · embedded · custom · workflowTasarım şablonunun mühendislik sınıflandırması — çok adımlı bir ajan, satır içi bir jeneratör, gömülü bir yetenek, çalışma alanı özel tanımı veya çok adımlı bir iş akışı grafiği.
iş alanı8 alandan biri (sağda)Hizmet verdiği işin HANGİ kısmı: Pazarlama ve Kampanya, Sadakat ve Elde Tutma, Risk ve Uyumluluk, Üye Hizmetleri, İçerik ve Yaratıcı, Müşteri İstihbaratı, Analiz ve İçgörüler, Araştırma ve Simülasyon.

40+ yönetilen aktör, tek model. Canlı kadro 5 oluşturulmuş ajan (çok adımlı, sunucu tarafından yönetilen: dört yönetici artı üye danışmanı), 28 satır içi fonksiyon (ürün boyunca işlenmiş tek seferlik jeneratörler ve sınıflandırıcılar) ve 8 gömülü yetenek (ekranda akış içi yardımcılar) içerir. Bunların her biri aynı Tanım türündedir ve yalnızca yukarıdaki eksenler boyunca farklılık gösterir.

Beceriler: Bir temsilci üzerinde oluşturulan veritabanı yetkili oyun kitapları

Bir beceri, veritabanında saklanan ve yeni bir çalışana bir standart işletim prosedürü (SOP) verdiğiniz gibi bir temsilcinin planına yerleştirilen yapılandırılmış bir kılavuzdur. Bu, bir paragraf komut metni değildir; aşağıdaki bölümlerden oluşan yazılı bir kayıttır:

trigger

Bu becerinin mevcut çalıştırmaya uygulanma koşulu.

required state

Becerinin sorumlu bir şekilde çalışması için mevcut olması gereken üye/iş durumu — yoksa, kişiye kapalı olarak başarısız olur.

tool allowlist

Bu becerinin kullanabileceği temsilci araçlarının alt kümesi - planın zaten izin verdiği şeylerin daralması, asla genişlemesi değil.

ordered steps

Çalışma zamanının sırasıyla yürüdüğü prosedür.

verifier rules

Adımın tamamlanmış sayılmasından önce sonuca geçmesi gereken kontroller.

decision guidance

Nasıl seçileceği - ne zaman TUTULACAĞI veya üst kademeye iletileceği dahil - sabit kodlanmış bir dal değil, kılavuz olarak ifade edilmiştir.

Çalışma zamanında, çalışma zamanı ; dolayısıyla yürütülen şey, "modelin ortaya çıkardığı şey" değil, ekibinizin okuyabileceği ve onaylayabileceği adlandırılmış, sürümlendirilmiş bir prosedürdür. Beceriler veritabanı yetkilisi olduğundan, aynı beceri birden fazla aracıda oluşturulabilir ve onu değiştirmek, onu kullanan her aracıyı değiştirir; yeniden konuşlandırmaya gerek yoktur.

Çalışma zamanının çıktısı: tekrarlanabilir bir yol haritası

Tekrar oynatılabilir bir yörünge oluşturmak, çalışma zamanının yaptığı işin 5. adımıdır ve aynı zamanda denetim kanıtınızdır. Aktör ne olursa olsun ve nasıl çalışırsa çalışsın, her çalıştırma tek bir sadece eklemeli olay günlüğüne bir olay akışı yayar. Her olay, bir çalıştırma kimliği ve onu üreten tam şablon (tanım) sürümü ile damgalanır; böylece bir çalıştırma denetlenebilir ve tekrar oynatılabilir. Bir çalıştırmanın yaydığı sıralı olay türleri:

01çalışma başlatıldı02Kullanıcı amacı03bağlam yüklendi04seçilen model05(Okunamayan metin)06akıl yürütme07izin kontrolü08araç adı09araç sonucu10eylem / sonuç11Maliyet12Çalışma sona erdi

Bunların yanı sıra, kayıt, aynalı MCP araç çağrılarını (aktör Flash'ü MCP üzerinden sürdüğünde) ve kapanış iş sonucunu taşır — böylece niyetten sonuca giden yol tek bir yerde bulunur.

// 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" }
  ]
}

Flash uygulaması aracılığıyla bir koşunun gidişatını okuyun. Kimliğe göre bir koşu alın veya son koşuları listeleyin:

# 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

Girişler asla düzenlenmez, yalnızca eklenir — günlük, her aktörün ne yaptığının ve neden yaptığının eksiksiz geçmişidir ve damgalanmış çalıştırma kimliği ve şablon sürümünden adım adım yeniden oluşturulabilir.

Ücretsiz yönetim: beş başarısız kapalı koruma

İşte birleşik bir çalışma süresinin getirisi. Her oyuncunun yürütmesi tek bir çalışma zamanından geçtiğinden, güvenlik tabanının her aracıya cıvatalanması gerekmez; bu, tüm eylemin geçtiği tek yerin yapısal bir özelliğidir. Bu beş muhafız koda aittir, her eylemde her aktörün emri altında çalışır ve hiçbir ayar onları kapatamaz. Bir Tanımın bileşimini (becerileri, araçları, modeli ve bağlamı) AI Çalışanları konsolunda yapılandırabilirsiniz; aşağıdaki korumalar değil.

KorumaNeyi zorunlu kılıyor
Yetkilendirme kapsamı × plan seviyesiHer araç çağrısı, anahtarın kapsamına VE çalışma alanının plan katmanına göre kontrol edilir. Tanım, bir aracı adlandırır; onu çalıştırma yetkisi, çağrı anında çözümlenen veritabanında bulunur. Anahtarın erişemediği bir araç basitçe gizlenir.
Yazma değeri sınırları + ücretDeğer taşıyan yazma işlemleri (puanlar, kuponlar), sunucuda başarısız olursa kapanacak şekilde uygulanan, çağrı başına değer sınırı ve tuş başına yazma hızı limiti ile sınırlandırılmıştır; bu, aktörün istemi veya istemci tarafı onayının iddia ettiği herhangi bir şeyden bağımsızdır.
Bütçe defteriHer çalıştırma, oyuncu harekete geçmeden önce ön ücretlendirilen ve ilerledikçe çekilen bir jeton + maliyet bütçesi dahilinde gerçekleştirilir. Defter tükendiğinde akış durur; bir aktör asla harcamadan kaçamaz.
Acil durdurma düğmesiHerhangi bir aktör - tüm bir tanım veya tek bir eylem - anında duraklatılabilir. Varsayılan olarak kapalı, açıkken sınırlı ve durdurmak istediğiniz anda durdurulabilir.
DenetimHer adım, çalıştırma kimliği ve tam şablon sürümüyle birlikte yalnızca ekleme yapılabilen olay günlüğüne yazılır. Bir aktörün yaptığı hiçbir şey kaydedilmeden kalmaz ve hiçbir ayar bir günlük girişini engelleyemez.

/flash/agents adresinde kompozisyonu yapılandırın. AI Çalışanları konsolu, bir oyuncunun becerilerini, araçlarını, modelini ve bağlamını düzenleyerek yeni sürümlü bir plan oluşturduğunuz yerdir. Orada asla düzenleyemeyeceğiniz şey güvenlik tabanıdır: Yukarıdaki beş koruma, konfigürasyonda değil, kodda uygulanır.

Harness'nin platformun geri kalanıyla uyum sağladığı yer

Harness, her yapay zeka aktörünün altında çalışan yürütme ortamıdır ve her şey onun üzerinden geçtiği için yönetim katmanı da onundur. İki bitişik referans, dayandığı parçaları kapsar:

  • MCP yüzey. Bir mcp_external aktör, kapsamlı bir anahtara sahiptir ve Model Bağlam Protokolü üzerinden Flash'ün yönetilen araçlarını çağırır. Uç nokta, kimlik doğrulama, istemci yapılandırması ve tam araç kataloğu MCP Entegrasyon kılavuzunda yer almaktadır.
  • Yetkilendirme mekanizmaları ve onaylar. Eylem başına mekanizma (otomatik / inceleme / yasak), bekleyen / reddedilen yazma semantiği ve yetkilendirme koruyucusunun üzerinde yer alan onay yaşam döngüsü, Yapay Zeka Yönetişimi: İç Gözlem ve Onaylar bölümünde belgelenmiştir.