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özlem araçlarını, inceleme donanımı kapsamındaki yazma anlambilimini ve onay yaşam döngüsünü kapsar. MCP Entegrasyon kılavuzunda belgelenen aynı yönetilen MCP sunucusu üzerine kuruludur. İşletmeye genel bakış için Yapay Zeka Yönetişimi ve Onayları ürün sayfasına bakın. Dişli yönlendirme aşamalı olarak etkinleştirilir; yönetilen eylemler çalışma alanınızda kullanıma sunuldukça aşağıdaki davranış geçerlidir.
İşletme-object iç gözlem (kapsam introspection:read)
Üç okuma aracı, bir yapay zeka istemcisinin işletmeye dokunmadan önce işletmenin yapısını öğrenmesini sağlar: hangi nesnelerin mevcut olduğu (çalışma alanının kendi özel alanları ve özel nesneleri dahil), her bir özniteliğin ne anlama geldiği, nesnelerin nasıl ilişkili olduğu ve hangi eylemlerin yürütülebilir olduğu - ön koşulları ve mevcut donanımlarıyla birlikte. İyi huylu bir temsilci önce bunları arar ve yalnızca mekanizmaların gerçekten izin verdiği eylemleri önerir.
list_objectsokuAnahtarı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.
(none)describe_objectokuBir 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.
objectlist_actionsokuBir yapay zeka istemcisinin gerçekleştirebileceği eylemler, her eylemin ön koşulları ve çalışma alanı tarafından yapılandırıldığı mevcut yetkilendirme mekanizması (otomatik / inceleme / yasak) ile birlikte. Yalnızca ilgili eylemleri görmek için object'a göre filtreleyin. Bu, yönetim katmanının tam olarak neyi uygulayacağını gösterir; reddedilecek eylemler önermekten kaçınmak için bunu kullanın.
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": [
{ "action": "issue_coupon", "gear": "review",
"preconditions": ["member has consent", "coupon pool has stock"] },
{ "action": "earn_points", "gear": "auto",
"preconditions": ["amount within the workspace cap"] },
{ "action": "assign_tag", "gear": "auto",
"preconditions": ["tag exists and is active"] },
{ "action": "add_member_note", "gear": "auto",
"preconditions": ["note passes server-side sanitation"] },
{ "action": "send_campaign", "gear": "review", "locked": true,
"preconditions": ["sending can never be auto — a human always approves"] }
]
}Gördüğünüz gear, uygulanacak olan dişlidir — çalışma alanı bunu konsolda eylem başına yapılandırır ve eylem başına bir devre kesici, bir eylemi herhangi bir zamanda review'e düşürebilir (yalnızca otomatik olarak aşağı iner; yalnızca bir insan geri yükler). Uzun oturumlar için dişlileri önbelleğe almak yerine list_actions ile tekrar kontrol edin.
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…",
"action": "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",
"action": "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_code | Anlamı | Temsilcinizin yapması gerekenler |
|---|---|---|
gear_forbidden | İşlemin dişlisi bu çalışma alanı için yasaklanmış olarak ayarlanmıştır (veya işlem asla otomatik olamaz - örneğin gönderme - ve otomatik gerektiren bir ş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_rejected | Bir 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 çözülür: approved, rejected veya expired. İnsanlar bunu Yapay Zeka Etkinlik ve Onaylar konsolunda (tekli veya toplu olarak işlem türüne göre) gerçekleştirir; günlük özet e-postası bekleyenleri gösterir.
| Durum | Nasıl oluyor | Sonra |
|---|---|---|
pending | Eylemin donanımı incelenirken bir yazma aracı çağrıldı; teklif, insan onayı için sıraya alındı. | onaylandı · reddedildi · süresi doldu |
approved | Bir 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; bireysel olarak iptal edilebilir) |
rejected | Bir 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 |
expired | 7 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ı
pendingsonucunu döndürür veproposal_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 ve ayrı ayrı iptal edilebilir. Teklif, karar, yetkilendirme yolu (
autoveya adı belirtilmiş bir kişi), uygulama ve sonuç, tek bir girişin geri alınabileceği karar günlüğüne kaydedilir.
Sunucu sınırdır. Dişliler, yeniden doğrulama, sona erme ve işlem başına devre kesici Flash tarafında uygulanır — asla ajanın mantığına veya istemci tarafındaki onayına güvenilmez. Gönderme türündeki eylemler, istemci ne isterse istesin asla otomatik olarak çalıştırılamaz.
Ş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:
| Model | Güçler | Dü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ştir | Yalnı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 regresyon | Tıklama eğilimi (0-100), ekibin son 90 günlük gönderimlerine göre her gece yeniden düzenleyin | Yalnı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ştirmesi | co_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 gece elde edilen çapraz satış önerileri | Bir 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" paneli | Ekranda 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 ve para hareket ettiren veya bir üyeyle iletişime geçen her şey, yukarıdaki yönetilen eylem mekanizmalarından geçer.
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.