Tadbir Urus AI: Muhasabah Diri & Kelulusan
Flash meletakkan setiap tindakan yang dimulakan AI di belakang gear kebenaran setiap tindakan — auto, review atau forbidden — dikonfigurasikan setiap ruang kerja dalam konsol Aktiviti & Kelulusan AI. Untuk klien AI yang melebihi MCP ini bermakna dua perkara: anda boleh menemui objek perniagaan dan tindakan yang dibenarkan anda lakukan sebelum bertindak, dan panggilan tulis anda mengembalikan hasil berstruktur — dilaksanakan, menunggu kelulusan manusia atau ditolak dengan alasan yang boleh dibaca oleh mesin.
Panduan ini merangkumi alat introspeksi, semantik penulisan di bawah gear semakan dan kitaran hayat kelulusan. Ia dibina pada pelayan MCP yang dikawal sama yang didokumenkan dalam panduan Integrasi MCP. Untuk gambaran keseluruhan perniagaan, lihat halaman produk Tadbir Urus & Kelulusan AI. Penghalaan gear diaktifkan secara progresif — tingkah laku di bawah terpakai apabila tindakan yang dikawal dilancarkan ke ruang kerja anda.
Perniagaan-object introspeksi (skop introspection:read)
Tiga alat baca membolehkan klien AI mempelajari bentuk perniagaan sebelum menyentuhnya: objek yang wujud (termasuk medan tersuai ruang kerja dan objek tersuai), maksud setiap atribut, bagaimana objek berkaitan dan tindakan yang boleh dilaksanakan — dengan prasyarat dan gear semasa. Ejen yang berkelakuan baik memanggil ini terlebih dahulu dan hanya mencadangkan tindakan yang sebenarnya dibenarkan oleh gear.
list_objectsbacaTemui objek perniagaan yang tersedia untuk ruang kerja kunci: ahli, pesanan, kupon, kempen, kedai, produk, segmen, tag — serta sebarang objek tersuai yang telah ditakrifkan oleh ruang kerja. Mengembalikan setiap kunci, label dan makna satu baris object. Hubungi dahulu untuk mengetahui apa yang wujud sebelum membaca atau bertindak.
(none)describe_objectbacaBentuk penuh satu object: atributnya (termasuk medan tersuai ruang kerja) dengan jenis dan makna perniagaannya, dan hubungannya dengan objek lain (cth. pesanan milik ahli; kupon boleh dikeluarkan kepada ahli). Medan PII dikembalikan sebagai metadata sahaja — nama, jenis, semantik dan bendera pii — tidak pernah nilainya.
objectlist_actionsbacaTindakan yang mungkin diambil oleh klien AI, dengan prasyarat setiap tindakan dan gear kebenaran semasanya (auto / semak / dilarang) seperti yang dikonfigurasikan oleh ruang kerja. Tapis mengikut object untuk melihat hanya tindakan yang menyentuhnya. Apa yang dikembalikan ini adalah apa yang akan dikuatkuasakan oleh lapisan tadbir urus — gunakannya untuk mengelakkan cadangan tindakan yang akan ditolak.
object?PII adalah metadata sahaja, mengikut reka bentuk. Introspeksi menerangkan medan yang menyimpan maklumat peribadi (nama, jenis, makna dan bendera pii) tetapi tidak pernah mengembalikan nilainya. Membaca data ahli sebenar melalui alat bacaan ahli dan skop mereka sendiri.
Contoh: huraikan object, kemudian semak gear
Contoh deskriptif bentuk permintaan/respons (disingkatkan — respons sebenar menyenaraikan setiap medan dan tindakan):
// 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"] }
]
}gear yang anda lihat ialah gear yang akan dikuatkuasakan — ruang kerja mengkonfigurasinya setiap tindakan dalam konsol, dan pemutus litar setiap tindakan boleh menurunkan tindakan kepada review pada bila-bila masa (ia hanya bergerak ke bawah secara automatik; hanya manusia yang memulihkannya). Semak semula dengan list_actions dan bukannya menyimpan gear untuk sesi yang panjang.
Alat tulis di bawah gear semakan: belum selesai / ditolak
Apabila alat tulis MCP menyasarkan tindakan yang gearnya ialah review, panggilan tersebut tidak melaksanakan kesan sampingan. Ia mengembalikan hasil berstruktur: sama ada cadangan itu telah diarahkan untuk kelulusan manusia (pending), atau ia ditolak terus (refused) dengan reason_code yang boleh dibaca mesin dan suggested_action.
// 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 | Maksud | Apa yang perlu dilakukan oleh ejen anda |
|---|---|---|
gear_forbidden | Gear tindakan ditetapkan kepada dilarang untuk ruang kerja ini (atau tindakan tidak boleh automatik — contohnya penghantaran — dan telah dipanggil dengan cara yang memerlukan auto). | Jangan cuba lagi. Tegur penolakan itu; ikuti suggested_action (biasanya tindakan alternatif atau 'meminta manusia menukar gear'). |
recently_rejected | Seorang manusia baru-baru ini menolak cadangan yang sama untuk sasaran yang sama — platform tidak akan membariskannya semula. | Hormati keputusan manusia. Jangan cadangkan semula atau ubah kata; ikuti suggested_action. |
Setiap penolakan membawa reason_code dalam bentuk ini ditambah suggested_action — anggap kod di atas sebagai kod untuk dicabangkan dan medan sebagai boleh dikembangkan. Penolakan adalah batasan yang sukar untuk anda baca, bukan ralat untuk dicuba semula: jangan sekali-kali mengubah kata cadangan untuk melepasi penolakan.
Kitaran hayat kelulusan
Cadangan pending menyelesaikan tepat satu cara: approved, rejected atau expired. Manusia bertindak ke atasnya dalam konsol Aktiviti & Kelulusan AI (jenis tindakan tunggal atau kelompok); e-mel ringkasan harian memaparkan apa yang sedang menunggu.
| Keadaan | Bagaimana ia berlaku | Kemudian |
|---|---|---|
pending | Alat tulis telah dipanggil semasa peralatan tindakan sedang disemak — cadangan sedang beratur untuk kelulusan manusia. | diluluskan · ditolak · tamat tempoh |
approved | Seorang manusia telah meluluskannya. Sebelum melaksanakannya, platform tersebut akan mengesahkan semula penaakulan AI yang dinyatakan; jika ia tidak lagi berkesan (cth. pelanggan telah membeli balik), tindakan tersebut tidak akan dilaksanakan. | terminal (keputusan direkodkan dalam log keputusan; boleh dibatalkan secara individu) |
rejected | Seorang manusia menolaknya, secara pilihan dengan nota. Cadangan yang sama kemudiannya ditolak dengan recently_rejected jika dihantar semula. | terminal |
expired | Tiada keputusan dalam masa 7 hari — cadangan tamat tempoh dengan sendirinya dan tiada apa yang dilaksanakan. | terminal |
Jaminan idempotensi
- Satu kelulusan, satu pelaksanaan. Meluluskan cadangan melaksanakan tindakannya tepat sekali; kelulusan berulang memainkan semula hasil yang disimpan tanpa kesan sampingan kedua.
- Penghantaran semula tidak akan berganda. Memanggil alat tulis sekali lagi untuk cadangan yang sama semasa ia sedang menunggu akan mengembalikan hasil
pendingyang sama danproposal_id— ia tidak akan memasukkan kad kedua ke dalam barisan. - Kelulusan disahkan semula, pelaksanaan adalah bersyarat. Pada masa kelulusan, platform menyemak semula sama ada penaakulan AI yang dinyatakan masih sah; jika ia tidak lagi sah (pelanggan telah membeli balik, contohnya), tiada apa yang akan dilaksanakan — hasilnya direkodkan dan bukannya tindakan.
- Semuanya diaudit dan boleh dibatalkan secara individu. Cadangan, keputusan, laluan kebenaran (
autoatau manusia yang dinamakan), pelaksanaan dan hasil semuanya berada dalam log keputusan, di mana satu entri boleh dibatalkan.
Pelayan ialah sempadan. Gear, pengesahan semula, tamat tempoh dan pemutus litar setiap tindakan dikuatkuasakan di pihak Flash — tidak pernah dipercayai oleh penaakulan ejen atau pengesahan pihak kliennya. Tindakan jenis penghantaran tidak boleh berjalan secara automatik, apa sahaja yang diminta oleh klien.
Primitif ketelusan & inventori model kotak kaca
Disiplin kotak kaca yang sama — setiap keputusan automatik yang direkodkan dan boleh dijelaskan, data peribadi yang disimpan di luar konteks model — melangkaui tindakan yang dikawal: untuk mencuba pengoptimuman trafik, kepada gesaan LLM keluar dan kepada inventori model ML klasik yang menguasakan kedudukan, ramalan dan pengesanan merentasi produk.
Pengoptimuman automatik trafik A/B: log keputusan
Kempen berulang (automasi dan perjalanan) boleh memilih untuk Optimumkan trafik secara automatik dari semasa ke semasa, yang memperuntukkan semula pemberat penghantaran merentasi varian eksperimen berdasarkan prestasi klik yang diperhatikan. Setiap peruntukan semula boleh diaudit:
- Log keputusan tambahan sahaja. Setiap pengiraan semula setiap jam menulis satu rekod dengan pemberat yang dikenakan dan rasional yang boleh dibaca oleh manusia. Rekod tidak pernah ditulis semula — log tersebut ialah sejarah penuh mengapa trafik kelihatan seperti itu.
- Pemisahan yang dikonfigurasikan tidak pernah diubah. Pemisahan yang dikonfigurasikan untuk eksperimen anda kekal tidak disentuh sebagai garis dasar; pemberat yang dioptimumkan dikira dan direkodkan di sampingnya.
- Aras penerokaan: 10%. Tiada pemberat varian yang pernah jatuh di bawah 10%, jadi setiap varian terus menerima trafik dan pembalikan kekal dapat dikesan.
- Pembahagian genap sehingga ≥100 dihantar setiap varian. Pemberat kekal pada pembahagian yang dikonfigurasikan sehingga setiap varian mempunyai sekurang-kurangnya ~100 penghantaran — tiada pengagihan semula pada data nipis dan tiada "pemenang" statistik yang pernah diisytiharkan oleh mekanisme ini.
Penyamaran LLM PII pada jahitan penyedia
Sebelum sebarang gesaan meninggalkan Flash untuk penyedia LLM luaran, pengecam peribadi ahli disembunyikan — digunakan pada lapisan penyedia, jadi setiap ciri AI melaluinya:
- Nama samaran deterministik. Alamat e-mel, nombor telefon dan larian digit seperti kad digantikan dengan token pelengkap yang stabil. Pengecam yang sama sentiasa dipadankan dengan nama samaran yang sama, jadi penaakulan model merentasi gesaan kekal koheren.
- Pelindungan terpakai pada setiap gesaan keluar daripada setiap ciri AI — tiada apa yang perlu didayakan dan ia tidak boleh dimatikan daripada produk.
- Pelindung muka sahaja, tidak pernah dibuka. Pemetaan adalah sehala di sempadan output: output model tidak pernah ditulis semula untuk mengembalikan pengecam sebenar, jadi PII mentah tidak boleh melalui respons LLM secara pergi balik.
Mengapa ini penting hari ini. Gesaan AI Flash dibina daripada agregat dan data kempen dan bukannya rekod peribadi — jahitan penyamaran ialah jaminan yang dikuatkuasakan yang kekal apabila ciri AI berkembang, bukan tampalan di atas kebocoran.
Inventori model kotak kaca
Setiap keupayaan ramalan atau statistik dalam produk ialah model klasik dan deterministik — tiada pemarkahan kotak hitam, tiada persampelan, jadi data yang sama sentiasa menghasilkan model yang sama. Setiap satu membawa pintu kejujuran yang eksplisit: di bawah pintu ia memancarkan tiada apa-apa dan bukannya tekaan, dan setiap skor dihantar dengan nombor yang diperlukan untuk mengiranya semula. Inventori semasa:
| Model | Kuasa | Pintu kejujuran |
|---|---|---|
| Peningkatan dua model (dua padanan logistik deterministik) | SoClaw kedudukan senarai kerja menang-kembali — nilai-berisiko × peningkatan, dilatih berdasarkan RCT program yang sentiasa aktif | Hanya mengaktifkan selepas ≥200 baris yang diproses matang, ≥50 baris penangguhan dan ≥20 penukaran, dengan kedua-dua padanan berkumpul — di bawah itu, kedudukan kembali kepada nilai berisiko tulen. Ahli peningkatan negatif (jangan ganggu) merosot; setiap tugasan menyimpan snapshot skornya. |
| Gamma antara pembelian setiap ahli (kaedah-saat-saat) | Tarikh pembelian seterusnya yang dijangkakan pada profil + keadaan segmen “Hari Sehingga Pembelian Seterusnya yang Dijangka” (negatif = lewat tempoh) | Memerlukan ≥3 jurang yang diperhatikan (iaitu ≥4 pembelian) dan get pekali variasi (≤1.5) pada keteraturan irama — pembeli tidak tetap mendapat NULL, tidak pernah tarikh yang direka-reka. Tarikh jangkaan yang lepas dipancarkan sebagai isyarat tertunggak yang jujur. |
| Regresi logistik terlaras L2 setiap pasukan | Kecenderungan klik (0–100), ubah suai setiap malam pada 90 hari terakhir penghantaran pasukan sendiri | Label klik sahaja (tidak pernah dibuka — Apple MPP mengembangkannya); ciri klik terdahulu yang dikawal kebocoran; penurunan kecerunan kelompok penuh deterministik pada jadual tetap. Padankan get ≥500 penghantaran / ≥30 klik / ≥50 ahli; ahli memerlukan ≥3 penghantaran terkini untuk dijaringkan. |
| Item-kNN yang dinormalkan kosinus | Padanan produk “Juga dibeli” merentasi permukaan cadangan | co_count / √(pembeli(A) × pembeli(B)) membetulkan bias populariti; pasangan memerlukan ≥2 pembeli kongsi untuk menjadi kenyataan; kiraan pembelian bersama mentah disimpan bersama skor sebagai bukti yang boleh diperiksa. |
| Peraturan perkaitan (sokongan / keyakinan / peningkatan) | Cadangan jualan silang, digali setiap malam daripada barisan pesanan peniaga sendiri | Sesuatu peraturan memerlukan ≥3 pesanan yang berlaku bersama dan keyakinan ≥5%; setiap peraturan menyimpan kiraan pesanan mentah yang diperolehnya, jadi sebarang angka boleh dikira semula dengan tangan. Permukaan profil ahli tidak termasuk produk yang telah dimiliki dan hanya dipaparkan untuk pembeli aktif. |
| Pencarian statistik yang mantap (median / MAD) | Yang behavior_outlier pengesan penipuan mata | Z teguh ≥ 6 ditambah lantai mutlak (≥10 transaksi perolehan; pasukan di bawah 50 ahli aktif dilangkau); pengurangan bulanan setiap ahli; pembekuan sahaja — ia membuka ulasan dan tidak pernah terbatal dengan sendirinya. |
| Bahaya berkadar Kaplan-Meier + Cox (kemungkinan separa Nelder-Mead) | Pengekalan mengikut kohort pendaftaran bulanan + panel “apa yang berkaitan dengan pengekalan” | Takrifan bercetak pada paparan: diputar = 90 hari tanpa pembelian, pembeli tidak pernah dikecualikan, kohort di bawah 30 ahli tersembunyi dan didedahkan. Cox fit memerlukan ≥30 peristiwa putar yang diperhatikan dan dihadkan pada 3 kovariat; korelasi dilabelkan sebagai korelasi, bukan sebab-akibat. |
| Holt-Winters (musim mingguan, pemalar tetap) | Tinjauan hasil 14 hari seterusnya pada papan pemuka | Pemalar pelicinan yang diperbaiki — tiada permukaan penalaan setiap pasukan; membaca metrik pendapatan yang diperakui yang sama seperti setiap skrin lain; garis putus-putus + jalur ralat dengan asas dolarnya dicetak; tersembunyi sepenuhnya di bawah sejarah 4 minggu; dilabelkan sebagai unjuran, bukan komitmen. |
Tiada satu pun daripada model ini yang bertindak sendiri: ia memberi kedudukan, skor dan penandaan, dan semua yang menggerakkan wang atau menghubungi ahli masih melepasi gear tindakan yang dikawal di atas.
Untuk butiran kejuruteraan penuh pada setiap model — kaedah, input, lajur output, pintu kejujuran dan permukaan penggunaan — lihat Rujukan Model Ramalan.