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.

AgentKit Nasıl Kullanılır: Yapay Zeka Ajanları Oluşturmak İçin Pratik, Uçtan Uca Bir Kılavuz

Eğer “AgentKit” hakkında bir şeyler duyduysanız ve onu nasıl kullanacağınızı merak ediyorsanız, doğru yerdesiniz. İşte püf noktası: AgentKit tek bir ürün değil. Bu isim birden fazla ekosistem tarafından kullanılıyor—özellikle Coinbase'in zincir içi/Web3 eylemleri için AgentKit'i, Inngest'in ajan ağlarını düzenlemek için AgentKit'i ve OpenAI Agents SDK'sını Coinbase'in kitiyle birlikte kullanan çeşitli öğreticiler. Bu kılavuz, her bir AgentKit'in ne olduğunu, neden birini diğerine tercih edeceğinizi ve adım adım nasıl kurulacağını, profesyonel ipuçları ve yeniden kullanabileceğiniz gerçek dünya kalıplarıyla birlikte açıklıyor.

Pratik ve çözüm odaklı bir yaklaşım benimseyeceğiz: hızlı karşılaştırmalar, net kurulum, çalıştırılabilir örnekler ve kaçınılması gereken tuzaklar.

Hangi “AgentKit”ten Bahsediyoruz?

Coinbase AgentKit (CDP/Zincir İçi): Yapay zeka ajanlarının cüzdanları yönetmesine, zincir içi işlemler göndermesine, token'ları dağıtmasına ve desteklenen ağlarda daha fazlasını yapmasına olanak tanır. Web3 tabanlı ajanlar (örn. bahşiş botları, token dağıtıcıları, NFT dağıtıcıları) oluşturmak için idealdir. Hızlı başlangıç kılavuzları ve çalıştaylar yaygın olarak mevcuttur.

Inngest AgentKit: Ajanları, araçları tanımlamak ve bunları ölçeklenebilir, olay odaklı yürütmeye odaklanmış bir ağ içinde çalıştırmak için bir çerçeve. Birden fazla ajanı, yeniden deneme mantığını ve arka plan iş akışlarını düzenlemek için harikadır.

Safe/Protocol Kits (bağlam): Ajanınızın akıllı hesap kontrolüne (çoklu imza, politika, toplu aramalar) ihtiyacı varsa, güvenli yürütme için Safe'in Protocol Kit'i genellikle zincir içi ajanlarla eşleştirilir.

Amacınız hızlı bir şekilde zincir içi bir yapay zeka ajanı oluşturmaksa, Coinbase AgentKit ile başlayın. Sağlam, çoklu ajan mimarisine ve zamanlamaya ihtiyacınız varsa, Inngest AgentKit güçlü bir seçimdir. Birçok ekip her ikisini de karıştırır: Gerekçelendirme için OpenAI Agents + zincir içi eylemler için Coinbase AgentKit + düzenleme için Inngest.

: Hızlı Karar Verme Rehberi

Fon taşıyabilen, token dağıtabilen veya dApp'lerle etkileşim kurabilen bir Web3 ajanı istiyorsunuz → Coinbase AgentKit'i kullanın.

Yeniden denemeler ve durum ile birden fazla ajanı/aracı düzenleyen dayanıklı, olay odaklı bir sisteme ihtiyacınız var → Inngest AgentKit'i kullanın.

Ajanınız için kurumsal düzeyde cüzdan güvenliğine veya çoklu imza yönetimine ihtiyacınız var → Ajanınızın yanında Safe’in Protocol Kit'ini entegre edin.

Bölüm 1: Coinbase AgentKit Nasıl Kullanılır (Zincir İçi Ajanlar)

Neden Coinbase AgentKit

Kullanıma hazır zincir içi görevler için oluşturulmuştur (cüzdan işlemleri, transferler, token yönetimi)

Temiz geliştirici deneyimi ve hızlı başlangıç araçları

Sosyal medyada (örn. X) kullanıcılarla arayüz oluşturan ve eylemleri zincir üzerinde çözen botlar/ajanlar için idealdir

Kurulum Genel Bakışı

CLI ve SDK'yı (hızlı başlangıca göre) yükleyin ve ağ, anahtarlar ve RPC uç noktaları için ortam değişkenlerini yapılandırın.

Bir proje başlatın ve ihtiyacınız olan zincir içi yetenekleri seçin.

Araçları (örn. cüzdan işlemleri, token dağıtımı) ajanıza bağlayın.

Araçları ne zaman çağıracağına karar vermek için ajanı bir akıl yürütme modeline (OpenAI veya benzeri) bağlayın.

Dakikalar içinde çalışmaya başlamak için resmi hızlı başlangıcı izleyin. Cüzdanları yöneten ve Twitter/X üzerinde etkileşim kuran bir Web3 yapay zeka ajanı oluşturma konusunda uygulamalı bir eğitim için, QuickNode kılavuzuna ve bir AgentKit Twitter botu oluşturma konulu bir video demosuna bakın.

Örnek Mimari

Akıl yürütme katmanı: İşlev/araç çağırma özellikli LLM

Eylem katmanı: Coinbase AgentKit araçları (transfer, token dağıtımı)

Kalıcılık: Ajan belleğini/hedeflerini bir veritabanında saklayın

Ön uç: Kullanıcı istemleri için Sohbet kullanıcı arayüzü veya sosyal bot (X)

En İyi Uygulamalar

En az ayrıcalık ilkesi: Ajan anahtarlarını gerekli kapsamlarla ve küçük bakiyelerle sınırlayın

Politika istemleri: Zincir içi eylemlere ne zaman izin verildiği hakkında açık kurallar tanımlayın

Koruyucu raylar: İşlem önizleme/onay, zaman penceresi başına limitler uygulayın

Gözlemlenebilirlik: Denetlenebilirlik için araç çağrılarını, işlemleri ve model çıktılarını günlüğe kaydedin

Yaygın Tuzaklar

Gevşek anahtar yönetimi: Sırları asla sabit kodlamayın; bir kasa kullanın

Sınırsız eylemler: Büyük değerli transferler için onaylar isteyin

Eksik oran limitleri: RPC uç noktalarını ve sosyal API'leri koruyun

Bölüm 2: Inngest AgentKit Nasıl Kullanılır (Ajan Ağları ve Düzenleme)

Neden Inngest AgentKit

Hedefleri ve araç setleri olan birinci sınıf, durumsuz çalışanlar olarak ajanlar

Karmaşık iş akışları için birden fazla ajanı koordine etmek için ağlar

Yeniden denemeler ve dayanıklı yürütme ile olay odaklı tasarım

İlk ajanı başlatmak ve bir ağ içinde çalıştırmak için hızlı başlangıçla başlayın. İş mantığını bağlamadan önce temel kavramları (ajanlar, araçlar, ağlar) okuyun.

Kurulum Adımları

Ajan hedefinizi ve mevcut araçları (API'ler, dahili hizmetler, zincir içi kitler) tanımlayın.

Bir ağ oluşturun ve ajanları kaydedin.

Ajanları tetiklemek için olaylar yayınlayın; dayanıklılık için yeniden denemeler ve geri çekilme kullanın.

Gözlemlenebilirlik ekleyin: günlükler, izler, sonuçlar.

Düzenleme Kalıpları

Denetleyici-çalışan: bir planlayıcı ajan, görevleri uzman ajanlara devreder

Olay kaynak kullanımı: durum değişiklikleri, ajanları tepki vermeye tetikler (örn. payment_received → fulfillment_agent)

İnsan-döngüde: riskli eylemler için onaylar, duraklatma/devam ettirme ile

İpuçları

Ajanları durumsuz tutun; bağlamı olaylar/durum depoları aracılığıyla aktarın

Zaman içindeki performansı izlemek için araçları ve istemleri sürümleyin

Arıza modlarını simüle edin; harici aramalar için idempotentliği doğrulayın

Bölüm 3: Safe ile Güvenli Yürütme (İsteğe Bağlı Ancak Önerilir)

Ajanınız fon yönetiyorsa veya yönetici işlemleri yürütüyorsa, akıllı hesapları yönetimle entegre edin. Safe'in Protocol Kit'i, akıllı hesaplar ve çoklu imza akışları için oluşturma, yapılandırma ve yürütme sağlar.

Kullanım durumu: Zincir içi bir ajan işlem gönderir, sahipler (insanlar veya denetleyici ajanlar) birlikte imzalar

Fayda: Politika kontrolleri, harcama limitleri ve güvenli kurtarma

Kalıp: Ajan işlemleri önerir; bir politika motoru (veya insan) imzalar ve yürütür

Adım Adım: Minimum Zincir İçi Ajan Oluşturma

Aşağıda uyarlayabileceğiniz kavramsal bir akış bulunmaktadır (dilden bağımsız, sözde kod tarzı). Çalışan kod ve CLI komutları için Coinbase hızlı başlangıcına bakın.

Projeyi başlatın ve bağımlılıkları yükleyin

Bir proje dizini oluşturun ve AgentKit SDK'sını ve LLM istemcinizi yükleyin

Ortam değişkenlerini ayarlayın: RPC URL'si, özel anahtar veya yönetilen cüzdan, ağ

Araçları ve yetenekleri tanımlayın

Cüzdan: get_balance, transfer(to, amount)

Token'lar: deploy_erc20(name, symbol, supply)

Gerektiğinde sözleşme çağrılarını okuyun/yazın

Akıl yürütme modelini bağlayın

Hedefleri ve kısıtlamaları tanımlayan bir sistem istemi sağlayın

Güvenli işlev çağırma için araçları şemalarla kaydedin

Güvenlik ve politikalar ekleyin

Eşiğin üzerindeki transferler için onay uygulayın

Günlük harcamayı sınırlayın, üretim için alıcı adreslerini izin verilenler listesine alın

Temel bir arayüz gönderin

CLI: agent ask "0.01 ETH'yi 0x...'e gönder"

Web/Sohbet: Görevleri göndermek ve makbuzları görüntülemek için minimum kullanıcı arayüzü

Önce bir test ağında test edin

Musluk fonları; eylem günlüklerini ve işlem karmalarını doğrulayın

Gözlemlenebilirlikle üretime geçin

Telemetriyi yakalayın, başarısız işlemlerle ilgili uyarılar ve model davranışındaki sapmalar

Üretimde İşe Yarayan Kalıplar

Planla-sonra-hareket et: araçları çağırmadan önce adımları özetlemek için modeli kullanın

Kuru çalıştırma modu: işlemleri önizleyin ve onay isteyin

Bütçe zarfları: her göreve bir harcama sınırı ve araç zaman aşımları verin

Sentetik izleme: planlanmış görevler ajanın sağlığını ve RPC bağlantısını doğrular

Gerçek Dünya Örnek Senaryoları

Topluluk bahşiş botu: Kullanıcılar X'te bottan bahseder; ajan, doğrulanan cüzdanlara zincir üzerinde bahşiş verir

Müşteri ödülleri: Ajan zincir içi eylemleri izler ve haftalık olarak ödül token'ları gönderir

DAO operasyonları: Ajan teklifler için Safe işlemlerini tasarlar; çoklu imza incelemeden sonra imzalar

Pazar yeri asistanı: Ajan NFT'leri listeler ve kullanıcı sorularına yanıt verir, onaydan sonra alım satımları gerçekleştirir

Rehberli bir Web3 ajan yapımı için, Agents SDK + AgentKit entegrasyonunda yol gösteren QuickNode eğitimine ve Coinbase'in çalıştayına bakın.

Sorun Giderme: Hızlı Düzeltmeler

Ajanım işlem gönderemiyor: Ağı, gas ayarlarını ve anahtar izinlerini kontrol edin; önce bir test ağı deneyin

Araç çağrıları düzensiz: Araç şemalarını ve doğrulamayı sıkılaştırın; ön kontrol istemleri ekleyin

Çalışmalar kararsız: Geri çekilme ile yeniden denemeler ekleyin; RPC oran limitlerini ve durum kodlarını izleyin

Güvenlik endişeleri: Anahtarları döndürün, fonları karantinaya alın, Safe tabanlı onaylara geçin

Bu Arada: Sider.AI ile İş Akışınızı Hızlandırın

Belirtmekte fayda var—istemler, yapıştırıcı kod ve belgeler üzerinde yineleme yapıyorsanız, bir yardımcı yardımcı olabilir. Sider.AI ile, aracılar için oluşturma-ölçme-öğrenme döngülerini hızlandırarak, araştırmayı, kod parçacıklarını ve deney günlüklerini düzenleyicinizin yanında düzenli tutabilirsiniz. Buradan keşfedin:

Temel Çıkarımlar

“AgentKit” genellikle Coinbase'in zincir içi araç setine ve Inngest'in düzenleme kitine atıfta bulunur—zincir içi eylemlere mi yoksa çoklu ajan koordinasyonuna mı ihtiyacınız olduğuna bağlı olarak seçin.

Küçük başlayın: test ağı, minimum araçlar, katı politikalar; yetenekleri kademeli olarak ekleyin.

Finansal veya yönetici yetki için, yönetim ve güvenlik için Safe'i entegre edin.

Ajana üretim yazılımı gibi davranın: günlük kaydı, uyarılar, limitler ve insan onayı.

Daha Fazla Bilgi

Coinbase AgentKit hızlı başlangıcı ve CLI

Çalıştay: Coinbase AgentKit ile OpenAI Agents SDK

Bir Web3 yapay zeka ajanı kılavuzu oluşturun (QuickNode)

Inngest AgentKit hızlı başlangıcı ve kavramları,

Güvenli akıllı hesaplar için Safe Protocol Kit

SSS

S1:AgentKit nedir ve hangisini kullanmalıyım? AgentKit genellikle zincir içi eylemler için Coinbase AgentKit'e ve ajanları düzenlemek için Inngest AgentKit'e atıfta bulunur. Web3 görevleri (cüzdanlar, token'lar) için Coinbase'i ve çoklu ajan, olay odaklı iş akışları için Inngest'i seçin.

S2:Bir yapay zeka ajanının zincir üzerinde güvenli bir şekilde para taşımasına nasıl izin veririm? Küçük bakiyeler, katı araç şemaları ve riskli eylemler için onay istemleri kullanın. Üretim için Safe akıllı hesaplarını entegre edin ve çoklu imza veya politika onayları gerektirin.

S3:OpenAI Agents'ı Coinbase AgentKit ile birleştirebilir miyim? Evet. Akıl yürütme katmanınızı (OpenAI Agents/işlev çağırma) Coinbase AgentKit araçlarına bağlayın. Birçok geliştirici ayrıca düzenleme ve yeniden denemeler için Inngest ekler.

S4:AgentKit kullanırken yaygın tuzaklar nelerdir? Anahtarları sabit kodlamak, test ağlarını atlamak ve sınırsız eylemlere izin vermek en büyükleridir. Güvende kalmak için oran limitleri, harcama sınırları ve sağlam gözlemlenebilirlik ekleyin.

S5:Bir Web3 yapay zeka ajanı oluşturmak için hızlı başlangıcı nerede bulabilirim? Kurulum ve örnekler için Coinbase’in AgentKit hızlı başlangıcıyla başlayın, ayrıca uçtan uca rehberlik için QuickNode'dan eğitimler ve çalıştay videoları.