What is AgentKit, and which one should I use?

AgentKit commonly refers to Coinbase AgentKit for onchain actions and Inngest AgentKit for orchestrating agents. Choose Coinbase for Web3 tasks (wallets, tokens) and Inngest for multi-agent, event-driven workflows.

How do I safely let an AI agent move funds onchain?

Use small balances, strict tool schemas, and confirmation prompts for risky actions. For production, integrate Safe smart accounts and require multisig or policy approvals.

Can I combine OpenAI Agents with Coinbase AgentKit?

Yes. Connect your reasoning layer (OpenAI Agents/function calling) to Coinbase AgentKit tools. Many devs also add Inngest for orchestration and retries.

What are common pitfalls when using AgentKit?

Hardcoding keys, skipping testnets, and allowing unbounded actions are the big ones. Add rate limits, spend caps, and robust observability to stay safe.

Where can I find a quickstart to build a Web3 AI agent?

Start with Coinbase’s AgentKit quickstart for setup and examples, plus tutorials from QuickNode and workshop videos for end-to-end guidance.

Cara Menggunakan AgentKit: Panduan Praktis dan Lengkap untuk Membangun Agen AI

Jika Anda pernah mendengar tentang “AgentKit” dan bertanya-tanya bagaimana cara menggunakannya, Anda berada di tempat yang tepat. Inilah masalahnya: AgentKit bukanlah produk tunggal. Nama ini digunakan oleh beberapa ekosistem—terutama AgentKit Coinbase untuk tindakan onchain/Web3, AgentKit Inngest untuk mengatur jaringan agen, dan berbagai tutorial yang menggunakan OpenAI Agents SDK bersama dengan kit Coinbase. Panduan ini menguraikan apa itu setiap AgentKit, mengapa Anda memilih satu di atas yang lain, dan bagaimana cara mengaturnya langkah demi langkah, dengan tips pro dan pola dunia nyata yang dapat Anda gunakan kembali.

Kami akan mengambil pendekatan praktis & berorientasi solusi: perbandingan cepat, pengaturan yang jelas, contoh yang dapat dijalankan, dan jebakan yang harus dihindari.

“AgentKit” Mana yang Anda Bicarakan?

Coinbase AgentKit (CDP/Onchain): Memungkinkan agen AI mengelola dompet, mengirim transaksi onchain, menyebarkan token, dan lainnya di seluruh jaringan yang didukung. Ideal untuk membangun agen asli Web3 (mis., bot pemberi tip, penyebar token, distributor NFT). Panduan memulai cepat dan lokakarya tersedia secara luas.

Inngest AgentKit: Kerangka kerja untuk menentukan agen, alat, dan menjalankannya di dalam jaringan, yang berfokus pada eksekusi berbasis peristiwa yang terukur. Cocok untuk mengatur banyak agen, logika percobaan ulang, dan alur kerja latar belakang.

Safe/Protocol Kits (konteks): Jika agen Anda memerlukan kontrol akun pintar (multisig, kebijakan, panggilan batch), Safe’s Protocol Kit sering dipasangkan dengan agen onchain untuk eksekusi yang aman.

Jika tujuan Anda adalah membangun agen AI onchain dengan cepat, mulailah dengan Coinbase AgentKit. Jika Anda memerlukan arsitektur multi-agen dan penjadwalan yang kuat, Inngest AgentKit sangat cocok. Banyak tim menggabungkan keduanya: OpenAI Agents untuk penalaran + Coinbase AgentKit untuk tindakan onchain + Inngest untuk orkestrasi.

: Panduan Keputusan Cepat

Anda menginginkan agen Web3 yang dapat memindahkan dana, menyebarkan token, atau berinteraksi dengan dapps → Gunakan Coinbase AgentKit.

Anda memerlukan sistem berbasis peristiwa yang tahan lama yang mengatur beberapa agen/alat dengan percobaan ulang dan status → Gunakan Inngest AgentKit.

Anda memerlukan keamanan dompet tingkat perusahaan atau tata kelola multisig untuk agen Anda → Integrasikan Safe’s Protocol Kit bersama agen Anda.

Bagian 1: Cara Menggunakan Coinbase AgentKit (Agen Onchain)

Mengapa Coinbase AgentKit

Dibangun untuk tugas onchain langsung (operasi dompet, transfer, manajemen token)

Pengalaman pengembang yang bersih dan alat memulai cepat

Ideal untuk bot/agen yang berinteraksi dengan pengguna di media sosial (mis., X) dan menyelesaikan tindakan onchain

Ikhtisar Pengaturan

Instal CLI dan SDK (sesuai dengan memulai cepat) dan konfigurasi variabel lingkungan untuk jaringan, kunci, dan titik akhir RPC.

Inisialisasi proyek dan pilih kemampuan onchain yang Anda butuhkan.

Ikat alat (mis., operasi dompet, penyebaran token) ke agen Anda.

Hubungkan agen ke model penalaran (OpenAI atau serupa) untuk memutuskan kapan harus memanggil alat.

Ikuti memulai cepat resmi untuk mulai berjalan dalam hitungan menit. Untuk tutorial langsung tentang membangun agen AI Web3 yang mengelola dompet dan berinteraksi di Twitter/X, lihat panduan QuickNode dan demo video tentang membuat bot Twitter AgentKit.

Contoh Arsitektur

Lapisan penalaran: LLM dengan panggilan fungsi/alat

Lapisan tindakan: Alat Coinbase AgentKit (transfer, penyebaran token)

Persistensi: Simpan memori/tujuan agen dalam database

Antarmuka depan: UI obrolan atau bot sosial (X) untuk perintah pengguna

Praktik Terbaik

Prinsip hak istimewa terendah: batasi kunci agen ke cakupan yang diperlukan dan saldo kecil

Perintah kebijakan: tentukan aturan eksplisit tentang kapan tindakan onchain diizinkan

Pengaman: terapkan pratinjau/konfirmasi transaksi, batasan per jangka waktu

Observabilitas: catat panggilan alat, transaksi, dan keluaran model untuk auditabilitas

Kesalahan Umum

Manajemen kunci yang longgar: jangan pernah membuat kode rahasia secara permanen; gunakan vault

Tindakan tak terbatas: memerlukan konfirmasi untuk transfer bernilai besar

Batas laju yang hilang: lindungi titik akhir RPC dan API sosial

Bagian 2: Cara Menggunakan Inngest AgentKit (Jaringan Agen & Orkestrasi)

Mengapa Inngest AgentKit

Agen sebagai pekerja stateless kelas satu dengan tujuan dan perangkat alat

Jaringan untuk mengoordinasikan beberapa agen untuk alur kerja yang kompleks

Desain berbasis peristiwa dengan percobaan ulang dan eksekusi yang tahan lama

Mulailah dengan memulai cepat untuk memutar agen pertama Anda dan menjalankannya di dalam jaringan. Baca konsep inti—agen, alat, jaringan—sebelum menghubungkan logika bisnis.

Langkah-langkah Pengaturan

Tentukan tujuan agen Anda dan alat yang tersedia (API, layanan internal, kit onchain).

Buat jaringan dan daftarkan agen.

Kirim peristiwa untuk memicu agen; gunakan percobaan ulang dan backoff untuk ketahanan.

Tambahkan observabilitas: log, jejak, hasil.

Pola Orkestrasi

Supervisor-worker: agen perencana mendelegasikan tugas ke agen spesialis

Event-sourcing: perubahan status memicu agen untuk bereaksi (mis., payment_received → fulfillment_agent)

Human-in-the-loop: persetujuan untuk tindakan berisiko, dengan jeda/lanjutkan

Tips

Jaga agar agen tetap stateless; lewati konteks melalui peristiwa/penyimpanan status

Alat versi dan perintah untuk melacak kinerja dari waktu ke waktu

Simulasikan mode kegagalan; verifikasi idempotensi untuk panggilan eksternal

Bagian 3: Eksekusi Aman dengan Safe (Opsional tetapi Direkomendasikan)

Jika agen Anda mengelola dana atau menjalankan operasi admin, integrasikan akun pintar dengan tata kelola. Safe’s Protocol Kit menyediakan pembuatan, konfigurasi, dan eksekusi untuk akun pintar dan alur multisig.

Kasus penggunaan: Agen onchain mengirimkan transaksi, sementara pemilik (manusia atau agen supervisor) ikut menandatangani

Manfaat: Kontrol kebijakan, batas pengeluaran, dan pemulihan aman

Pola: Agen mengusulkan transaksi; mesin kebijakan (atau manusia) menandatangani dan mengeksekusi

Langkah demi Langkah: Membangun Agen Onchain Minimal

Di bawah ini adalah alur konseptual yang dapat Anda adaptasi (agnostik bahasa, gaya pseudocode). Konsultasikan Coinbase memulai cepat untuk kode yang berfungsi dan perintah CLI.

Inisialisasi proyek dan instal dependensi

Buat direktori proyek dan instal AgentKit SDK dan klien LLM Anda

Atur variabel lingkungan: URL RPC, kunci pribadi atau dompet terkelola, jaringan

Tentukan alat dan kemampuan

Dompet: get_balance, transfer(to, amount)

Token: deploy_erc20(name, symbol, supply)

Panggilan kontrak baca/tulis sesuai kebutuhan

Hubungkan model penalaran

Berikan perintah sistem yang mendefinisikan tujuan dan batasan

Daftarkan alat dengan skema untuk panggilan fungsi yang aman

Tambahkan keamanan dan kebijakan

Terapkan konfirmasi untuk transfer di atas ambang batas

Batasi pengeluaran harian, daftar putih alamat penerima untuk produksi

Kirim antarmuka dasar

CLI: agent ask "Send 0.01 ETH to 0x..."

Web/Obrolan: UI minimal untuk mengirimkan tugas dan menampilkan tanda terima

Uji di testnet terlebih dahulu

Faucet dana; verifikasi log tindakan dan hash transaksi

Pindah ke produksi dengan observabilitas

Tangkap telemetri, peringatan tentang transaksi yang gagal, dan penyimpangan dalam perilaku model

Pola yang Bekerja dalam Produksi

Rencanakan-kemudian-bertindak: gunakan model untuk menguraikan langkah-langkah sebelum memanggil alat

Mode dry-run: pratinjau transaksi dan minta persetujuan

Amplop anggaran: berikan setiap tugas batas pengeluaran dan batas waktu alat

Pemantauan sintetis: tugas terjadwal memvalidasi kesehatan agen dan konektivitas RPC

Skenario Contoh Dunia Nyata

Bot pemberi tip komunitas: Pengguna menyebutkan bot di X; agen memberi tip dompet yang diverifikasi onchain

Hadiah pelanggan: Agen melacak tindakan onchain dan mengirim token hadiah setiap minggu

Operasi DAO: Agen menyusun transaksi Safe untuk proposal; multisig menandatangani setelah peninjauan

Asisten pasar: Agen mencantumkan NFT dan membalas pertanyaan pengguna, mengeksekusi perdagangan setelah konfirmasi

Untuk pembangunan agen Web3 terpandu, lihat tutorial QuickNode dan lokakarya Coinbase yang membahas integrasi Agents SDK + AgentKit.

Pemecahan Masalah: Perbaikan Cepat

Agen saya tidak dapat mengirim transaksi: Periksa jaringan, pengaturan gas, dan izin kunci; coba testnet terlebih dahulu

Panggilan alat tidak menentu: Kencangkan skema alat dan validasi; tambahkan perintah pra-pemeriksaan

Jalankanannya tidak stabil: Tambahkan percobaan ulang dengan backoff; pantau batas laju RPC dan kode status

Masalah keamanan: Putar kunci, karantina dana, pindah ke persetujuan berbasis Safe

Ngomong-ngomong: Percepat Alur Kerja Anda dengan Sider.AI

Perlu dicatat—jika Anda melakukan iterasi pada perintah, kode lem, dan dokumen, sidekick dapat membantu. Dengan Sider.AI, Anda dapat menjaga penelitian, potongan kode, dan log percobaan tetap teratur di samping editor Anda, mempercepat loop build-measure-learn untuk agen. Jelajahi di sini:

Poin-Poin Penting

“AgentKit” umumnya mengacu pada toolkit onchain Coinbase dan kit orkestrasi Inngest—pilih berdasarkan kebutuhan Anda untuk tindakan onchain vs. koordinasi multi-agen.

Mulai dari yang kecil: testnet, alat minimal, kebijakan ketat; tambahkan kemampuan secara bertahap.

Untuk otoritas keuangan atau admin, integrasikan Safe untuk tata kelola dan keamanan.

Perlakukan agen seperti perangkat lunak produksi: pencatatan, peringatan, batasan, dan persetujuan manusia.

Pembelajaran Lebih Lanjut

Coinbase AgentKit memulai cepat dan CLI

Lokakarya: OpenAI Agents SDK dengan Coinbase AgentKit

Bangun panduan agen AI Web3 (QuickNode)

Inngest AgentKit memulai cepat dan konsep,

Safe Protocol Kit untuk akun pintar yang aman

FAQ

Q1:Apa itu AgentKit, dan mana yang harus saya gunakan? AgentKit umumnya mengacu pada Coinbase AgentKit untuk tindakan onchain dan Inngest AgentKit untuk mengatur agen. Pilih Coinbase untuk tugas Web3 (dompet, token) dan Inngest untuk alur kerja multi-agen dan berbasis peristiwa.

Q2:Bagaimana cara saya dengan aman membiarkan agen AI memindahkan dana onchain? Gunakan saldo kecil, skema alat yang ketat, dan perintah konfirmasi untuk tindakan berisiko. Untuk produksi, integrasikan akun pintar Safe dan perlukan persetujuan multisig atau kebijakan.

Q3:Dapatkah saya menggabungkan OpenAI Agents dengan Coinbase AgentKit? Ya. Hubungkan lapisan penalaran Anda (OpenAI Agents/panggilan fungsi) ke alat Coinbase AgentKit. Banyak pengembang juga menambahkan Inngest untuk orkestrasi dan percobaan ulang.

Q4:Apa kesalahan umum saat menggunakan AgentKit? Hardcoding kunci, melewatkan testnet, dan mengizinkan tindakan tak terbatas adalah yang utama. Tambahkan batas laju, batas pengeluaran, dan observabilitas yang kuat agar tetap aman.

Q5:Di mana saya dapat menemukan mulai cepat untuk membangun agen AI Web3? Mulailah dengan mulai cepat Coinbase’s AgentKit untuk pengaturan dan contoh, ditambah tutorial dari QuickNode dan video lokakarya untuk panduan ujung ke ujung.