Praktik terbaikKasus penggunaan

Agen perdagangan

Copy page



Bangun agen belanja dan agen merchant di Claude menggunakan Claude for commerce, sebuah blueprint open-source dengan implementasi yang berfungsi pada Messages API, Claude Agent SDK, dan Claude Managed Agents.

Panduan ini menunjukkan cara membangun agen perdagangan di Claude: "shopping agent" (agen belanja) yang digunakan pelanggan di dalam aplikasi Anda, dan "merchant agent" (agen merchant) untuk orang-orang yang menjalankan toko, baik staf operasional bisnis itu sendiri maupun para penjual di platformnya. Panduan ini melakukannya melalui Claude for commerce, sebuah "blueprint" (cetak biru) open-source yang berisi implementasi yang berfungsi dari setiap agen pada Messages API, Claude Agent SDK, dan Claude Managed Agents, contoh yang dapat dijalankan untuk ritel, perjalanan, telekomunikasi, dan hiburan, serta plugin Claude Code yang membuat kerangka desain yang sama untuk sistem Anda sendiri.

Kode, instruksi penyiapan, dan dokumentasi keamanan tersedia di repositori Claude for commerce di GitHub. Untuk mengetahui cara agen dibangun beserta alasannya, termasuk desain agen tunggal dengan skill, komponen UI sebagai alat, keamanan yang ditegakkan oleh harness, "prompt caching" (caching prompt), memori, dan eval, baca postingan engineering Panduan anatomi agen perdagangan yang efektif.

Agen belanja

Agen belanja berada di dalam aplikasi Anda dan menjangkau sistem Anda melalui satu antarmuka backend yang Anda implementasikan di atas layanan katalog, keranjang, preferensi, pesanan, kebijakan, dan pemenuhan pesanan Anda. Tidak ada metode pada antarmuka tersebut yang membuat pesanan atau memindahkan uang. Dalam percakapan, agen dapat:

• Mencari di katalog, membandingkan kandidat akhir, dan mengubah kebutuhan yang dijelaskan menjadi daftar pilihan dan rekomendasi.
• Merencanakan serangkaian item yang terkoordinasi untuk suatu tujuan seperti perjalanan, acara, atau ruangan, dan menyesuaikannya dengan anggaran.
• Menampilkan produk, perbandingan, rencana, status pesanan, dan keranjang sebagai komponen UI yang dirender dalam percakapan.
• Mengisi keranjang dan menyerahkannya ke checkout Anda.
• Menjawab pertanyaan tentang pesanan, pengiriman, pengembalian, dan kebijakan dari sistem pesanan dan kebijakan Anda sendiri.
• Mengingat apa yang diminta pelanggan untuk diingat dan menerapkannya di sesi berikutnya.

Lima skill dimuat sesuai kebutuhan untuk mencakup pencarian dan penemuan, riset pembelian, perencanaan menuju suatu tujuan, layanan pelanggan, serta memori dan personalisasi. Aturan yang dibutuhkan agen di sebagian besar giliran, seperti grounding, semantik keranjang dan checkout, serta presentasi, ditempatkan di "system prompt" (prompt sistem) sebagai gantinya.

Agen menyebutkan produk, harga, ketersediaan, dan ketentuan toko hanya berdasarkan hasil alat dalam percakapan, dan penulisan ke keranjang hanya menerima ID produk yang dikembalikan oleh alat katalog atau pesanan dalam sesi tersebut. Checkout menyiapkan ringkasan yang dikonfirmasi pelanggan di aplikasi Anda. Jika Anda menggunakan checkout yang di-hosting, back end Anda mengembalikan URL-nya dan host merendernya tanpa meneruskannya melalui model.

Agen merchant

Agen merchant mendukung orang-orang yang menjalankan toko. Agen ini menjangkau sistem analitik, katalog, inventaris, harga, dan kampanye Anda melalui antarmuka backend-nya sendiri, dan dapat:

• Menjelaskan kinerja bisnis: mengapa suatu metrik berubah, segmen mana yang mendorongnya, dan laju dibandingkan dengan periode yang sebanding. Delegasi analisis opsional menjalankan kueri hanya-baca dengan batas waktu dan ukuran.
• Menyajikan ringkasan harian tentang hal-hal yang perlu diperhatikan, termasuk stok rendah, produk yang lambat terjual, dan pengecualian pesanan.
• Meningkatkan konten listing dan memperbaiki data katalog dari materi yang diberikan operator.
• Merekomendasikan perubahan harga dan promosi dalam batas "guardrails" (pagar pengaman) toko, dengan pratinjau margin.
• Menyusun draf kampanye pemasaran lengkap dengan audiens, penempatan, dan anggaran.

Lima skill-nya mencakup wawasan kinerja, inventaris dan operasional, katalog dan listing, harga dan promosi, serta kampanye pemasaran.

Setiap penulisan yang diusulkan agen merchant, baik pembaruan listing, perubahan harga, tindakan inventaris, promosi, maupun kampanye, merupakan "staged change" (perubahan yang disiapkan) dengan ID yang dibuat server, yang dilihat operator sebagai kartu pratinjau. Pagar pengaman seperti perubahan harga maksimum, kedalaman promosi, ukuran restock, anggaran kampanye, dan kolom yang dilindungi diperiksa saat perubahan disiapkan dan sekali lagi saat diterapkan. Perubahan hanya diterapkan setelah seseorang menyetujuinya di luar percakapan: tombol di portal merchant pada jalur Messages API, prompt konfirmasi di konsol Agent SDK, atau kebijakan izin always-ask pada alat apply di Claude Managed Agents. Persetujuan yang diketik di chat tidak menyetujui apa pun.

Contoh vertikal

Setiap contoh mencakup etalase pelanggan dan portal merchant dengan data fiktif.

Tempat menjalankannya

Runtime Messages API dan Agent SDK berjalan pada Claude API, Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry, atau melalui gateway Anda sendiri. Jalur Claude Managed Agents berjalan pada Claude API. Panduan deployment di repositori menunjukkan di mana setiap jalur memilih platformnya dan format ID model yang diharapkan oleh masing-masing jalur.

Bangun milik Anda sendiri dengan plugin Claude Code

Blueprint ini dilengkapi dengan plugin Claude Code yang membaca repositori hasil clone sebagai referensinya dan membangun agen untuk sistem Anda sendiri. Empat perintahnya mencakup jalur dari nol hingga agen yang telah diuji:

Plugin ini juga membawa enam skill tentang arsitektur, caching prompt, UI sebagai alat, kepercayaan dan keamanan, eval, serta operasional merchant, yang dimuat setiap kali percakapan Claude Code cocok dengannya. Instruksi instalasi tersedia di README repositori.

Untuk mengadaptasi referensi secara manual, implementasikan antarmuka backend belanja atau merchant di atas layanan Anda, nonaktifkan sistem yang tidak Anda miliki dengan flag konfigurasi agar alat dan baris prompt terkait dihapus, lalu atur nama merek, nama asisten, dan gaya bahasa Anda. Panduan backend di repositori menjelaskan identitas dan kredensial, alur berurutan, penyerahan ke checkout, serta produk dengan opsi. Sebuah pilot dapat mengimplementasikan pencarian dan detail produk, lalu membuat stub untuk sisanya.

Memulai