SocialHub.AI
Yeni · her çalışma alanında yayında

Yapay Zeka Yönetişimi: İç Gözlem ve Onaylar

Flash, AI tarafından başlatılan her eylemi, AI Etkinliği ve Onaylar konsolundaki çalışma alanı başına yapılandırılmış bir eylem başına yetkilendirme donanımının (auto, review veya forbidden) arkasına yerleştirir. MCP üzerindeki bir AI istemcisi için bu iki anlama gelir: harekete geçmeden önce iş nesnelerini ve gerçekleştirmenize izin verilen eylemleri keşfedebilirsiniz ve yazma çağrılarınız, yürütülen, insan onayı bekleyen veya makine tarafından okunabilir bir nedenden dolayı reddedilen yapılandırılmış sonuçlar döndürür.

Bu kılavuz içgörü araçlarını, inceleme kademesindeki yazma anlamını ve onay yaşam döngüsünü kapsar. MCP entegrasyon kılavuzunda belgelenen aynı yönetilen MCP sunucusunun üzerine kuruludur. İş özeti için Yapay Zeka Yönetişimi ve Onayları ürün sayfasına bakın. Kademe yönlendirme her çalışma alanında canlıdır.

İşletme-object iç gözlem (kapsam introspection:read)

Üç okuma aracı, bir yapay zeka istemcisinin işe dokunmadan önce işin biçimini öğrenmesini sağlar: hangi nesnelerin var olduğu (çalışma alanının kendi özel alanları ve özel nesneleri dahil), her özniteliğin anlamı, nesnelerin nasıl ilişkili olduğu ve hangi eylemlerin yürütülebildiği — ön koşulları ve varsayılan kademesiyle. İyi davranan bir aracı önce bunları çağırır ve bekleyen veya reddedilen bir yazma sonucunu, çalışma alanının neye izin verdiğine dair son söz sayar.

list_objectsoku

Anahtarın çalışma alanında bulunan iş nesnelerini keşfedin: üye, sipariş, kupon, kampanya, mağaza, ürün, segment, etiket — ayrıca çalışma alanının tanımladığı özel nesneler. Her object'ın anahtarını, etiketini ve tek satırlık anlamını döndürür. Okumadan veya işlem yapmadan önce neyin mevcut olduğunu öğrenmek için önce arayın.

Parametreler: (none)
describe_objectoku

Bir object'ın tam şekli: nitelikleri (çalışma alanının özel alanları dahil), türleri ve iş anlamları ve diğer nesnelerle ilişkileri (örneğin, bir sipariş bir üyeye aittir; bir kupon bir üyeye verilebilir). PII alanları yalnızca meta veri olarak döndürülür — ad, tür, anlam ve bir PII bayrağı — asla değerleri döndürülmez.

Parametreler: object
list_actionsoku

Bir yapay zeka istemcisinin yapabileceği eylemler, her eylemin ön koşulları ve platform varsayılan yetki kademesiyle (auto / review / forbidden; gear_source: 'default'). Yalnızca ona dokunan eylemleri görmek için object alanına göre süzün. Çalışma alanınız eylem başına farklı bir kademe belirleyebilir ve uygulanan bu ayardır — yazma sonucu, bir çağrının yürütüldüğünü, beklemede olduğunu veya reddedildiğini söyler.

Parametreler: object?

PII, tasarım gereği yalnızca meta verilerdir. İçgözlem, kişisel bilgileri (adları, türleri, anlamları ve pii bayrağı) tutan ancak bunların değerlerini asla döndürmeyen alanları tanımlar. Gerçek üye verilerinin okunması, üye okuma araçları ve kendi kapsamlarından geçer.

Örnek: bir object tanımlayın, ardından dişlileri kontrol edin

İstek/yanıt şeklinin açıklayıcı örnekleri (kısaltılmış - gerçek yanıtlar her alanı ve eylemi listeler):

// describe_object { "object": "member" }
{
  "object": "member",
  "label": "Member",
  "meaning": "A loyalty program member owned by this workspace.",
  "fields": [
    { "name": "email",            "type": "string",  "pii": true,
      "meaning": "Contact email. PII: metadata only — values are never returned here." },
    { "name": "tier",             "type": "string",  "pii": false,
      "meaning": "Current loyalty tier." },
    { "name": "membership_no",    "type": "string",  "pii": false, "custom": true,
      "meaning": "Workspace-defined custom field." }
  ],
  "relationships": [
    { "to": "order",  "kind": "has_many",  "meaning": "Orders placed by this member." },
    { "to": "coupon", "kind": "has_many",  "meaning": "Coupons issued to this member." },
    { "to": "tag",    "kind": "has_many",  "meaning": "Tags currently applied to this member." }
  ]
}
// list_actions { "object": "member" }
{ "actions": [
  { "key": "earn_points", "object": "member", "gear": "review", "gear_source": "default", "gear_locked": false,
    "preconditions": ["compliance_outreach","budget","write_guard"], "reversal": "undo", "value_cap": { "amount": 10000 } },
  { "key": "issue_coupon", "object": "member", "gear": "review", "gear_source": "default", "gear_locked": false,
    "preconditions": ["compliance_outreach","budget","write_guard","pool_ownership"], "reversal": "undo" },
  { "key": "assign_tag", "object": "member", "gear": "review", "gear_source": "default", "gear_locked": false,
    "preconditions": ["write_guard"], "reversal": "compensating" },
  { "key": "add_member_note", "object": "member", "gear": "auto", "gear_source": "default", "gear_locked": false,
    "preconditions": ["write_guard"], "reversal": "compensating" }
], "count": 4 }

Bugün gear her eylemin platform varsayılanıdır (gear_source: 'default'), çalışma alanınızın kendi ayarı değildir. earn_points ve issue_coupon gibi aracı haklarının varsayılanı review değeridir: bir aracının hakkı bir kişinin onaylaması için kuyruğa alınır ve yalnızca onaylanırsa çalışır; add_member_note varsayılanı auto değeridir. Her çalışma alanı eylem başına kendi kademesini ayarlayabilir ve bu ayarlar henüz burada görünmez — bu yüzden list_actions değerini bir başlangıç noktası sayın ve kademeleri uzun oturumlar boyunca önbelleğe almak yerine her yazma sonucuna (yürütüldü, beklemede veya reddedildi) güvenin.

Araçları inceleme donanımının altına yazın: beklemede / reddedildi

Bir MCP yazma aracı, dişlisi review olan bir eylemi hedeflediğinde, çağrı yan etkiyi yürütmez. Yapılandırılmış bir sonuç döndürür: ya teklif insan onayı için sıraya alınmıştır (pending) ya da makine tarafından okunabilir bir reason_code ve bir suggested_action ile doğrudan reddedilmiştir (refused).

// proposed — waiting for a human
{
  "status": "pending",
  "proposal_id": "prop_9f2c…",
  "key": "issue_coupon",
  "expires_at": "2026-07-10T00:00:00Z",  // 7 days
  "message": "Queued for human approval in
              AI Activity & Approvals."
}
// refused — with a reason and a next step
{
  "status": "refused",
  "key": "issue_coupon",
  "reason_code": "recently_rejected",
  "suggested_action": "A human rejected this
    proposal recently. Do not re-propose;
    consider a different action or ask the
    operator."
}
reason_codeAnlamıTemsilcinizin yapması gerekenler
gear_forbiddenİşlem bu çalışma alanı için yasaklanmış olarak ayarlanmıştır veya sahip olmadığı bir yetkiyi gerektiren şekilde çağrılmıştır.Tekrar denemeyin. Reddedilme durumunu bildirin; takip edin. suggested_action (genellikle alternatif bir eylem veya 'bir insandan vites değiştirmesini istemek' anlamına gelir).
recently_rejectedBir insan yakın zamanda aynı hedef için aynı teklifi reddetti - platform onu tekrar sıraya almayacak.İnsan kararını saygı gösterin. Yeniden önermeyin veya yeniden ifade etmeyin; uyun. suggested_action.

Her ret, bu biçimde bir reason_code artı bir suggested_action taşır; yukarıdaki kodları dallanacak kodlar ve alanı genişletilebilir olarak kabul edin. Reddetmek, sizin için zor bir sınırdır, tekrar denemeniz gereken bir hata değildir: bir reddi atlatmak için asla bir teklifi yeniden ifade etmeyin.

Onay yaşam döngüsü

Bir pending önerisi tam olarak tek bir şekilde sonuçlanır: approved, rejected veya expired. İnsanlar bunu Yapay Zeka Etkinliği ve Onaylar konsolunda işler (eylem türüne göre tek tek veya toplu).

DurumNasıl oluyorSonra
pendingEylemin donanımı incelenirken bir yazma aracı çağrıldı; teklif, insan onayı için sıraya alındı.onaylandı · reddedildi · süresi doldu
approvedBir insan tarafından onaylandı. Platform, yürütmeden önce yapay zekanın belirttiği gerekçeyi yeniden doğrular; eğer artık geçerli değilse (örneğin, müşteri zaten yeniden satın aldıysa), işlem yürütülmez.terminal (sonuç karar günlüğüne kaydedilir; geri alınabilir işlemler tek tıklamayla geri alınabilir)
rejectedBir insan bunu, isteğe bağlı olarak bir notla birlikte reddetti. Aynı teklif daha sonra şu şekilde reddedilir: recently_rejected yeniden gönderilmesi durumunda.terminal
expired7 gün içinde karar verilmezse, teklif kendiliğinden sona erer ve hiçbir şey uygulanmaz.terminal

İdempotansiyel garantileri

  • Bir onay, bir yürütme. Bir teklifi onaylamak, eylemini tam olarak bir kez yürütür; tekrarlanan bir onay, ikinci bir yan etki olmadan depolanan sonucu yeniden oynatır.
  • Yeniden gönderme işlemi kopyalamaz. Aynı teklif beklemedeyken yazma aracını tekrar çağırmak aynı pending sonucunu döndürür ve proposal_id — ikinci bir kart kuyruğa almaz.
  • Onay yeniden doğrulanır, yürütme koşulludur. Onay zamanında platform, yapay zekanın belirttiği gerekçenin hala geçerli olup olmadığını yeniden kontrol eder; eğer artık geçerli değilse (örneğin müşteri zaten yeniden satın aldıysa), hiçbir şey yürütülmez — eylem yerine sonuç kaydedilir.
  • Her şey denetlenir. Teklif, karar, yetkilendirme yolu (auto veya adı belirtilmiş bir kişi), uygulama ve sonuç, geri alınabilir işlemlerin tek tıklamayla geri alınabileceği karar günlüğüne kaydedilir.

Sunucu sınırdır. Kademeler, yeniden doğrulama, süre dolumu ve eylem başına devre kesici SocialHub.AI tarafında uygulanır — aracının akıl yürütmesine veya istemci tarafındaki onayına asla bırakılmaz. Gönderim kademelerin kontrolünde değildir: geri kazanma ve diğer aracı mesajları yalnızca kendi gönderim sınırları içinde çıkar (onay ve sıklık tavanları) ve kampanya taslakları kendilerini asla göndermez.

Şeffaflık temel öğeleri ve şeffaf kutu modeli envanteri

Aynı şeffaf kutu disiplini — her otomatik karar kaydedilir ve açıklanabilir, kişisel veriler model bağlamının dışında tutulur — yönetilen eylemlerin ötesine uzanır: trafik optimizasyonunu denemek, giden LLM istemlerine ve ürün genelinde sıralama, tahmin ve tespiti destekleyen klasik ML model envanterine.

A/B trafik otomatik optimizasyonu: karar günlüğü

Tekrarlayan kampanyalar (otomasyonlar ve yolculuklar), gözlemlenen tıklama performansına göre deney varyantları arasında teslimat ağırlıklarını yeniden dağıtan Zaman içinde trafiği otomatik olarak optimize etme seçeneğine katılabilir. Her yeniden dağıtım denetlenebilir:

  • Sadece eklemeli karar günlüğü. Her saatlik yeniden hesaplama, uygulanan ağırlıklar ve insan tarafından okunabilir bir gerekçeyle bir kayıt yazar. Kayıtlar asla yeniden yazılmaz — günlük, trafiğin neden böyle göründüğünün tam geçmişidir.
  • Yapılandırılan bölme hiçbir zaman değiştirilmez. Denemenizin yapılandırılmış bölmesine temel olarak dokunulmaz; optimize edilmiş ağırlıklar hesaplanır ve onunla birlikte kaydedilir.
  • Keşif tabanı: %10. Hiçbir varyantın ağırlığı %10'un altına düşmez, bu nedenle her varyant trafik almaya devam eder ve bir geri dönüş tespit edilebilir kalır.
  • Varyant başına ≥100 teslimata kadar eşit dağılım. Ağırlıklar, her varyant en az ~100 teslimata ulaşana kadar yapılandırılmış dağılımda kalır — ince verilerde yeniden tahsis yapılmaz ve bu mekanizma tarafından hiçbir zaman istatistiksel bir "kazanan" ilan edilmez.

Sağlayıcı dikişinde LLM PII maskeleme

Herhangi bir istem Flash'dan harici bir LLM sağlayıcısına gitmeden önce, üye kişisel tanımlayıcıları maskelenir - sağlayıcı arayüzünde uygulanır, böylece her yapay zeka özelliği buradan geçer:

  • Belirli takma adlar. E-posta adresleri, telefon numaraları ve kart benzeri rakam dizileri, kararlı yedek belirteçlerle değiştirilir. Aynı tanımlayıcı her zaman aynı takma ada eşlenir, bu nedenle modelin bir istem üzerindeki akıl yürütmesi tutarlı kalır.
  • Maskeleme, her yapay zeka özelliğinden gelen her giden isteme uygulanır — etkinleştirilecek bir şey yoktur ve üründen kapatılamaz.
  • Sadece maske, asla maskesi kaldırılmaz. Eşleme, çıktı sınırında tek yönlüdür: model çıktısı, gerçek tanımlayıcıları yeniden oluşturmak için asla yeniden yazılmaz, bu nedenle ham kişisel tanımlayıcı bilgiler bir LLM yanıtı üzerinden gidiş-dönüş yapamaz.

Bugün bunun önemi. Flash'in yapay zeka istemleri, kişisel kayıtlardan ziyade toplu veriler ve kampanya verilerinden oluşturulmuştur; maskeleme dikişi, yapay zeka özellikleri büyüdükçe geçerli olan zorunlu bir garantidir, bir sızıntının üzerine yama değildir.

Cam kutu modeli envanteri

Üründeki her tahmine dayalı veya istatistiksel yetenek, klasik, deterministik bir modeldir; kara kutu puanlaması yoktur, örnekleme yoktur; dolayısıyla aynı veriler her zaman aynı modeli üretir. Her biri açık bir dürüstlük kapısı taşıyor: Kapının altında tahmin yerine hiçbir şey yayılmıyor ve her puan, onu yeniden hesaplamak için gereken sayılarla birlikte geliyor. Mevcut envanter:

ModelGüçlerDürüstlük kapıları
İki modelli yükseltme (iki deterministik lojistik uyum)SoClaw geri kazanma iş listesi sıralaması — riske maruz değer × artış, programın kendi her zaman açık olan RCT'sine göre eğitilmiştirYalnızca ≥200'den fazla olgunlaşmış işlenmiş satırı, ≥50'den fazla bekleme satırını ve ≥20'den fazla dönüşümü etkinleştirir; her iki uyum da yakınsamıştır; bunun altında sıralama saf riske maruz değere geri döner. Negatif yükseltme (rahatsız etmeyin) üyeleri batar; her görev kendi puanının anlık görüntüsünü saklar.
Üye başına satın alma arası Gama (anlık yöntem)Profildeki beklenen bir sonraki satın alma tarihi + “Beklenen Bir Sonraki Satın Almaya Kadar Kalan Günler” segment koşulu (negatif = gecikmiş)En az 3 gözlemlenen boşluk (yani en az 4 satın alma) ve ritim düzenliliğinde bir varyasyon katsayısı kapısı (≤1,5) gerektirir — düzensiz bir alıcı NULL alır, asla uydurma bir tarih almaz. Geçmişteki beklenen bir tarih, dürüst bir gecikme sinyali olarak iletilir.
Takım başına L2 düzenlemeli lojistik regresyonTıklama eğilimi (0-100), ekibin son 90 günlük gönderimlerine göre her gece yeniden düzenleyinYalnızca tıklama etiketi (hiçbir zaman açılmaz — Apple MPP onları şişirir); sızıntıya karşı korumalı tıklama öncesi özelliği; sabit bir programa göre deterministik tam toplu gradyan inişi. Uygun kapılar ≥500 gönderme / ≥30 tıklama / ≥50 üye; Bir üyenin puanlanabilmesi için en son 3 gönderime ihtiyacı vardır.
Kosinüs normalleştirilmiş öğe-kNNÖneri yüzeylerinde "ayrıca satın alındı" ürün eşleştirmesico_count / √(alıcılar(A) × alıcılar(B)) popülerlik yanlılığını düzeltir; çiftlerin oluşması için ≥2 ortak alıcıya ihtiyaç vardır; ham ortak satın alma sayısı, incelenebilir kanıt olarak puanla birlikte saklanır.
İlişkilendirme kuralları (destek / güven / artış)Satıcının kendi sipariş hatlarından her gün elde edilen çapraz satış önerileriBir kuralın ≥3 eş zamanlı siparişe ve ≥%5 güvene ihtiyacı vardır; her kural, türetildiği ham sipariş sayılarını saklar, böylece herhangi bir rakam elle yeniden hesaplanabilir. Üye profili yüzeyi, zaten sahip olunan ürünleri hariç tutar ve yalnızca aktif alıcılar için gösterilir.
Sağlam istatistik aykırı değeri (medyan / MAD)O behavior_outlier puan sahtekarlığı tespit cihazıSağlam z ≥ 6 artı mutlak tabanlar (≥10 kazanç işlemi; 50'den az aktif üyesi olan ekipler atlanır); üye başına aylık gruplandırılmış mükerrer kayıt silme; yalnızca dondurma — bir inceleme başlatır ve asla kendiliğinden iptal olmaz.
Kaplan-Meier + Cox orantılı tehlikeler (Nelder-Mead kısmi olasılık)Aylık kayıt grubuna göre elde tutma + "elde tutmanın neyle bağlantılı olduğu" paneliEkranda basılı tanım: Müşteri kaybı = 90 gün boyunca satın alma yapmama, hiç satın alma yapmayanlar hariç, 30'dan az üyesi olan gruplar gizlenmiş ve açıklanmıştır. Cox uyumu için ≥30 gözlemlenen müşteri kaybı olayı gereklidir ve 3 kovaryant ile sınırlandırılmıştır; korelasyonlar nedensellik değil, korelasyon olarak etiketlenmiştir.
Holt-Winters (haftalık mevsimsellik, sabit değerler)Kontrol panelinde önümüzdeki 14 günün gelir görünümüSabit yumuşatma sabitleri — takım başına ayar yüzeyi yok; diğer tüm ekranlarla aynı onaylı gelir ölçütünü okuyor; dolar bazında basılmış kesikli çizgi + hata bandı; 4 haftalık geçmiş verilerinin altında tamamen gizli; taahhüt değil, tahmin olarak etiketlenmiş.

Bu modellerin hiçbiri kendi başına hareket etmez: sıralar, puanlar ve işaretler. Bir aracı onların ortaya çıkardığı şey üzerine harekete geçtiğinde puanları, kuponları ve üye düzenlemeleri yukarıdaki yönetilen eylem kademelerinden geçer ve mesajları yalnızca geri kazanmanın gönderim sınırları içinde çıkar.

Her modelin tüm mühendislik detayları için — yöntem, girdiler, çıktı sütunları, dürüstlük kapıları ve tüketim yüzeyleri — Tahmin Modelleri Referansı bölümüne bakın.