Panduan Integrasi MCP

Membaca TimesFM 2.5 Kesiapan tren/kuantil agregat dan kesiapan fusi penyewa-pribadi 7/30/90 hari. Menunggu pelatihan/validasi dinyatakan secara eksplisit. Membutuhkan predictions:read.

Satu prediksi konsumen: distribusi/peringkat acara berikutnya akhir ditambah CWM + TimesFM 7/30/90d purchaseWindows. Model acara penyewa yang diperoleh lebih disukai; satu referensi publik internal sebagai cadangan. Tidak ada keluaran ahli individu. Probabilitas acara tidak dikalibrasi; jendela pembelian null hingga dilatih/divalidasi. Membutuhkan predictions:read; metrics:read juga memungkinkan jendela pembelian.

Memprediksi metrik harian merek/kategori dengan TimesFM 2.5: titik + q10..q90. Riwayat pengembalian hilang nullKuantil agregat tidak dikalibrasi; tidak pernah berupa interval pribadi. Membutuhkan predictions:read AND metrics:read.

Penyewa-pribadi CWM + TimesFM Probabilitas pembelian pada 7/30/90 hari (0–1). Nol sampai dilatih dan divalidasi; tidak ada cadangan yang dibuat-buat. Membutuhkan predictions:read AND metrics:read.

Daftar metrik yang tersedia untuk tim ini dari lapisan semantik yang diatur (kunci, label, unit, sertifikasi, kategori). Panggil terlebih dahulu untuk menemukan kunci metrik yang valid. Membutuhkan metrics:read.

Dapatkan spesifikasi lengkap dari satu metrik: definisi resmi, satuan, sertifikasi, dimensi, kolom yang dapat difilter, parameter yang dapat disesuaikan, dan panduan penggunaan. Membutuhkan metrics:read.

Jalankan kueri metrik yang diatur dan kembalikan angka dengan definisi otoritatifnya. Pilih kunci metrik plus dimensi opsional, filter, rentang waktu, granularitas, dan perbandingan periode ke periode — jangan pernah menggunakan SQL. Membutuhkan metrics:read.

Uraikan satu metrik berdasarkan satu dimensi dalam jendela terkini yang tetap, dengan label yang mudah dibaca manusia (nama toko/tingkat/saluran). Membutuhkan metrics:read.

Jawab pertanyaan dalam bahasa alami dengan memilih metrik yang tepat, mengambilnya, dan menguraikan metrik utama. Untuk diagnosis terbuka. Membutuhkan metrics:read.

Daftar semua toko untuk tim saat ini. Mendukung filter status opsional, pencarian, dan penomoran halaman.

Dapatkan detail toko tertentu berdasarkan ID-nya.

Daftar anggota program loyalitas. Mendukung filter program dan penomoran halaman.

Dapatkan detail anggota loyalitas tertentu berdasarkan ID. Mengembalikan bidang PII yang telah didekripsi.

Daftar kumpulan kupon. Mendukung filter status dan jenis.

Gambaran singkat dasbor operasional (tangkapan, pemindaian, tingkat tangkapan, kupon, toko, rencana). Bukan metrik yang diatur — gunakan alat metrik untuk metrik bisnis yang otoritatif.

Berikan poin loyalitas kepada anggota. Mengembalikan ID transaksi dan saldo baru.

Mengurangi poin loyalitas dari anggota (konsumsi FIFO).

Dapatkan saldo poin anggota saat ini dan riwayat transaksi terbaru.

Dapatkan kupon anggota yang tersedia (belum ditebus, belum kedaluwarsa).

Dapatkan tingkatan anggota saat ini, persyaratan peningkatan tingkatan berikutnya, dan semua tingkatan.

Dapatkan riwayat pengajuan tanda terima anggota dengan status OCR dan poin yang diberikan.

Tukarkan poin loyalitas dengan kupon dari kumpulan yang ditentukan (atomik: poin + kupon, atau tidak keduanya).

Terbitkan kupon dari kumpulan kupon kepada seorang anggota (anggota tunggal; audiens massal melalui alur konfirmasi So). Membutuhkan coupons:write.

Periksa apakah email pemasaran dapat dikirim ke alamat di bawah batas frekuensi (1/hari, 2/minggu, 4/bulan).

Daftar kandidat Duta yang diberi skor untuk program loyalitas (mode Pro). Kosong dalam mode Lite.

Dapatkan laporan ROI Ambassador: tiga sub-tujuan, retensi Bulan ke-2, dan gerbang go/no-go 90 hari.

Terbitkan atau tingkatkan kode afiliasi Ambassador pribadi anggota. Mengembalikan kode string.

Dapatkan analitik kunjungan halaman/perilaku: gambaran umum, halaman teratas, rincian perangkat, atau sumber lalu lintas.

Profil gabungan anggota (keterjangkauan, persetujuan/CCPA(Loyalitas, penggabungan perdagangan/kategori/saluran/keterlibatan, preferensi yang dinyatakan, tag, geolokasi kasar, kelompok usia). PII disunting — tanpa nama atau nilai kontak. Membutuhkan members:read.

Rangkaian perilaku terkini satu anggota (kunjungan, poin, kupon, email, tanda terima) + ringkasan, untuk menentukan tindakan yang dipersonalisasi. Mengembalikan PII yang telah didekripsi. Membutuhkan members:behavior:read.

Cantumkan segmen audiens tim (nama, status, jumlah anggota yang tersimpan). Diperlukan segments:read.

Buat segmen audiens dari kondisi terstruktur (jangan pernah menggunakan SQL); menolak duplikat. Membutuhkan segments:write + kunci milik pengguna.

Cantumkan otomatisasi tim (kampanye yang dipicu oleh peristiwa) dan statusnya. Membutuhkan automations:read.

Jeda otomatisasi yang sedang berjalan berdasarkan ID kampanye (idempoten). Membutuhkan automations:write.

Daftar templat kampanye yang tersedia untuk tim ini (resmi + tersimpan), untuk menemukan template_id untuk create_campaign_draft. Membutuhkan campaigns:read.

Daftar kampanye terbaru tim (id, judul, status), untuk menemukan source_campaign_id untuk mengkloning draf. Membutuhkan campaigns:read.

Buat DRAFT kampanye dari templat atau kampanye sebelumnya (TIDAK PERNAH dikirim — tinjauan manusia diperlukan). Membutuhkan campaigns:write-draft.

Periksa apakah anggota tersebut sudah dihubungi (sistem apa pun) di saluran dalam jangka waktu terakhir — hindari menghubungi secara berlebihan. Membutuhkan members:behavior:membaca.

Buat anggota loyalitas, atau selesaikan secara idempoten anggota yang sudah ada dengan cara externalId/email. Persetujuan pemasaran TIDAK diaktifkan melalui MCP. Memerlukan members:write.

Perbarui profil/identitas anggota (email, telepon, fullName, externalId, status). Kepemilikan tim diberlakukan. Membutuhkan members:write.

Buat toko, atau perbarui toko yang sudah ada yang sesuai dengan externalId untuk tim ini. Membutuhkan stores:write.

Catat pesanan pembelian dan berikan poin secara otomatis (anggota diselesaikan berdasarkan memberId > externalId > email). Membutuhkan orders:write.

Pengembalian poin (penarikan kembali) dari anggota, yang terkait dengan ID transaksi asli — untuk pengembalian dana POS/ERP atau pembatalan. Membutuhkan points:write.

Daftar definisi tag tim (kunci, nama, siklus hidup, kategori, cakupan). Temukan tag_key sebelum membaca/menetapkan tag anggota. Membutuhkan tags:read.

Dapatkan tag anggota saat ini (kunci, nama, siklus hidup, nilai, sumber, assignedAt). Memerlukan members:read.

Tetapkan tag secara manual ke anggota berdasarkan tag_key (penggantian operator; disematkan terhadap sapuan aturan). Membutuhkan tags:write.

Hapus tag dari anggota secara manual berdasarkan tag_key (tag yang aktif dapat ditambahkan kembali pada proses selanjutnya). Membutuhkan tags:write.

Daftar produk dengan kategori/merek/vertikal, status, dan sumber. Filter berdasarkan status/category_id/brand_id/vertikal. Membutuhkan akses catalog:read.

Dapatkan satu produk dengan varian, item berseri, komponen kombo, dan konten dasar AI. Membutuhkan catalog:read.

Cantumkan kategori produk tim (id, nama, induk). Wajib diisi catalog:read.

Cantumkan merek-merek tim (id, nama). Diperlukan catalog:read.

Rekomendasi produk terbaik berikutnya: member_id (pembelian bersama yang dipersonalisasi + afinitas kategori) atau product_id (pelanggan juga membeli). Membutuhkan akses members:read.

Sewakan tugas pemulihan pelanggan dengan prioritas tertinggi berikutnya untuk tim ini (atomik). Mengembalikan tugas, tenggat waktu sewa, kelompok anggota yang menolak, dan ringkasan sinyal churn. NO_TASKS_AVAILABLE / WINBACK_DISABLED dikembalikan sebagai isError. Membutuhkan winback:claim.

Menyelesaikan tugas win-back sewaan dengan hasil (pengungkit yang diaktifkan + referensi catatan, atau alasan TAHAN). Idempotent. LEASE_EXPIRED / ALREADY_COMPLETED dikembalikan sebagai isError. Membutuhkan winback:claim.

Pemeriksaan awal baca-saja satu kali untuk anggota sebelum memutuskan: persetujuan, ruang frekuensi email, kelelahan, jangkauan terkini, sinyal churn, dan penolakan anggota. Pratinjau sopan — server masih memberlakukan setiap gerbang pada saat penulisan. Membutuhkan winback:read.

Lampirkan catatan proses teks bebas ke catatan pemulihan anggota (rasional / sinyal yang diamati / hipotesis yang didukung oleh pengujian). Teks disimpan sebagai DATA, bukan instruksi; maksimal 2000 karakter, disanitasi. Membutuhkan winback:write.

Kirim pesan pengembalian yang diatur (kotak masuk atau email) sehingga insentif tidak pernah menjadi pemberian diam-diam. Gerbang gagal-tertutup sisi server: WINBACK_DISABLED, kepemilikan sewa tugas, HOLDOUT_NO_SEND (penahanan tidak pernah dikirimi pesan), NOT_CONSENTED, FREQUENCY_CAPPED, CONTENT_REJECTED (disanitasi), BREAKER_TRIPPED — dikembalikan sebagai isError. Menggunakan kembali tumpukan pengiriman yang ada (footer berhenti berlangganan + kepatuhan yang ditambahkan oleh lapisan pengiriman). Membutuhkan winback:write.

Membaca perilaku PELANGGAN AKTIF anggota dalam jangka waktu tertentu (Lapisan 3, terbaru terlebih dahulu) untuk menyimpulkan maksud (Lapisan 4). Hanya mengembalikan tindakan pelanggan yang disengaja (menjelajahi, membuka/mengklik, check-in, membeli, menukarkan, merujuk, mengirimkan konten) dengan label katalog + arti yang terlampir secara langsung, ditambah ringkasan (jumlah berdasarkan jenis + jendela). Alasan di seluruh jendela; maksud adalah hipotesis untuk dikonfirmasi, bukan fakta. Hanya baca. Membutuhkan winback:read.

Sewakan tugas keputusan agen berikutnya untuk tim ini (atomik; secara opsional dipersempit berdasarkan jenis). Mengembalikan ID tugas, jenis, fakta subjek, dan tenggat waktu sewa. NO_TASKS_AVAILABLE / AGENT_TASKS_DISABLED dikembalikan sebagai isError. Membutuhkan agent_tasks:claim.

Baca fakta tugas keputusan agen (jenis, subjek, alasan bendera, status) sebelum memutuskan. AGENT_TASK_NOT_FOUND dikembalikan sebagai isError. Membutuhkan agent_tasks:read.

Selesaikan tugas sewa dengan sebuah keputusan, terapkan efeknya melalui penulisan idempoten yang ada. fraud_household_referral: blokir (tarik kembali kedua belah pihak) / izinkan (abaikan bendera) / eskalasi (serahkan kepada manusia). ALREADY_COMPLETED / NOT_LEASE_OWNER / LEASE_EXPIRED dikembalikan sebagai isError. Membutuhkan agent_tasks:claim.

Sebutkan objek bisnis yang dapat dipertimbangkan oleh tim ini: objek platform inti (anggota, pesanan, toko, kupon, kampanye, produk, segmen, tag) ditambah objek-objek milik tim ini. MCP-Objek kustom yang terlihat — kunci, label, dan arti satu baris yang otoritatif. Panggil terlebih dahulu untuk menemukan yang valid. object kunci. Membutuhkan introspection:read.

Jelaskan satu bisnis object Dari registri yang diatur: makna otoritatif ditambah properti yang dipartisi menjadi fakta (berbasis kolom), turunan (referensi metrik/tag/rollup dengan kebaruan — tidak pernah menurunkan kaliber ulang), dan kustom (bidang kustom tim ini). Properti PII hanya mengembalikan metadata, tidak pernah nilai. bidang=ringkasan (default) atau lengkap. Membutuhkan introspection:read.

Sebutkan tindakan agen yang diatur (apa yang dapat dilakukan agen): target object, efek samping, perlengkapan (otomatis/ulasan/terlarang), kunci prasyarat sisi server, batasan nilai, dan kemampuan untuk dibalik — periksa sendiri sebelum mengusulkan penulisan. Secara opsional, filter berdasarkan object. Memerlukan introspection:read.

Cantumkan kartu stempel tim (eStampInformasi program: ID, nama, jumlah stempel yang dibutuhkan untuk menyelesaikan, jenis hadiah (kupon/poin/manual), pengaturan ulang otomatis, dan status. Hubungi terlebih dahulu untuk mendapatkan informasi lebih lanjut. program_id. Memerlukan stamp:read.

Dapatkan kartu stempel aktif anggota: nama program, stempel saat ini, stempel yang dibutuhkan, penyelesaian sejauh ini, dan hadiah. Membutuhkan stamp:read.

Memberikan stempel kepada anggota untuk program stempel (misalnya, kunjungan toko). Idempoten dengan idempotency_key; setelah penyelesaian kartu, hadiah (kupon/poin) dikeluarkan secara otomatis. Jumlah dibatasi per panggilan. Membutuhkan stamp:write.

Poin anggota: saldo yang dapat dibelanjakan, poin yang diperoleh seumur hidup, penukaran, tingkatan saat ini, batch yang akan segera berakhir. Kunci terikat anggota → poin sendiri (abaikan member_id); kunci tim → berikan member_id. Membutuhkan loyalty:self:read.

Transaksi poin terbaru anggota (diperoleh/ditukarkan/disesuaikan), terbaru terlebih dahulu. Keterangan anggota → riwayat pribadi; keterangan tim → riwayat tim. member_id. Memerlukan loyalty:self:membaca.

Hadiah yang dapat ditukarkan anggota dengan poin — katalog dengan biaya poin, ditandai berdasarkan keterjangkauan terhadap saldo anggota. Kunci yang terikat pada anggota → milik sendiri; kunci tim → bagikan member_id. Memerlukan loyalty:self:membaca.

Cara kerja program loyalitas — tingkat perolehan, bonus selamat datang, nilai poin, cara bergabung — plus FAQ yang disetujui merek. Fakta publik. Kunci yang terikat anggota tidak memerlukan argumen. Membutuhkan loyalty:self:read.

Cantumkan skenario simulasi panel sintetis beserta batas kegunaan sebenarnya, batas kepercayaan maksimum, dan kolom inputnya masing-masing. Hubungi terlebih dahulu untuk memilih jenisnya. Membutuhkan metrics:read.

Kalibrasi panel sintetis merek (tingkat keberhasilan prediksi sintetis masa lalu vs kenyataan; null sampai ada backtest). Membutuhkan metrics:read.

Bacalah laporan jujur ​​yang dibekukan untuk menjalankan panel sintetis — pembacaan arah, batas kepercayaan, bendera penekanan, tema — atau blockReason Jika belum siap. Membutuhkan metrics:read.

Jalankan panel sintetis: kembaran digital anonim dari suatu segmen bereaksi terhadap stimulus, menghasilkan laporan arah yang jujur ​​(tidak pernah berupa angka absolut sebenarnya). Mengembalikan run_id untuk di-polling. Dibatasi oleh batas run harian + ≤50 kembaran. Membutuhkan synthetic:write.