Blockchain0x'i ajan yığınınıza entegre edin.
Her popüler ajan çerçevesi için gerçek kod. Varsa gönderilen bir paket, yoksa kısa bir SDK tarifi.
Çerçevenizi seçin. Bir paket gönderdiğimiz yerlerde onu kurarsınız; aksi takdirde SDK'mızı o çerçevenin yerel aracıyla sararsınız. Her iki durumda da, tek bir HTTP API üzerinde ince bir katmandır ve bunu atlayabilir ve API'yi doğrudan çağırabilirsiniz.
Her kart, bir derin dalış açar: kurulum veya tarif, çalışan bir ajan örneği, webhook işleme ve yaygın tuzaklar. Bugün üç gerçek paket olarak gönderiliyor - blockchain0x-langchain ve blockchain0x-crewai PyPI'de, ve @blockchain0x/mcp npm'de. Diğer yedi, aynı SDK üzerinde kısa tariflerdir. İcat edilmiş paket yok.
On çerçeve. Üç paket, yedi tarif, bir API.
LangChain
PyPI paketiblockchain0x-langchain paketinden Python araç seti; TypeScript ajanları x402 istemcisini sarar
CrewAI
PyPI paketiblockchain0x-crewai'den Python araç seti, LangChain ile aynı fabrika şekli
AutoGen
SDK tarifiTarif: SDK'yı bir AutoGen işlev aracı içinde sarın
LlamaIndex
SDK tarifiTarif: istemciyi bir LlamaIndex FunctionTool içinde sarın
OpenAI Agents SDK
SDK tarifiTarif: istemciyi bir OpenAI Agents SDK işlev aracı içinde sarın
Pydantic AI
SDK tarifiTarif: istemciyi çağıran bir Pydantic AI aracı kaydedin
LangGraph
SDK tarifiTarif: x402 istemcisini çağıran bir LangGraph düğümü
Semantic Kernel
SDK tarifiTarif: SDK'yı saran bir KernelFunction; NuGet veya Java adaptörü yok
Agno
SDK tarifiTarif: Python istemcisini saran bir Agno Araç Seti
MCP servers
npm paketiHerhangi bir MCP istemcisi için @blockchain0x/mcp sunucusu aracılığıyla cüzdan araçları
Agent Skill
Agent SkillOne installable Agent Skill that teaches any AI agent the whole wallet integration surface; portable or via the Claude Code plugin marketplace
Her çerçevede tutarlı bir şekil.
- Paket için kurulum komutu veya paket yoksa izlenecek yol
- Çalıştırabileceğiniz kopyala-yapıştır kod, pseudocode değil
- '{framework} ajanıma ödemeleri nasıl eklerim' sorusuna kısa cevap
- AI arama motorları için HowTo/FAQ şemalı SSS girdileri
- Eşleşen uzun kuyruk açılış sayfasına bağlantı
- Fiyatlandırma sayfasına bağlantı
Her entegrasyon, aynı API'nin ince bir sarmalayıcısıdır.
Blockchain0x entegrasyonları 10 ayrı ürün değildir. Tek bir HTTP API'nin üzerinde 10 farklı ergonomik yüzeydir. API gerçeğin kaynağıdır; çerçeve sarmalayıcıları zaman kazanmanız için vardır.
Her sarmalayıcı, "çerçevenizin bir aracı nasıl tanımladığı" ile "API'mize bir HTTP çağrısı" arasında çeviri yapar. Bu, tüm işlevdir. Python adaptörleri create_blockchain0x_toolset(client)'i açar, bu da LangChain veya CrewAI'ye hazır bir araç seti verir. Gönderilmiş bir adaptörü olmayan bir çerçeve, createX402Client(...) (Node) veya blockchain0x istemcisini (Python) o çerçevenin yerel bir aracı içinde sarar. Her iki durumda da aynı API altında.
Bunun birkaç nedeni var. Öncelikle, karıştırabilir ve eşleştirebilirsiniz: bir LangChain üretim ajansı ve bir CrewAI deneysel ajansı, aynı Blockchain0x ajan cüzdanını çelişmeden hedefleyebilir. İkincisi, bizim aracılığımızla bir çerçeve seçimine kilitlenmezsiniz; çerçeveleri değiştirmek, cüzdanınıza, harcama politikalarınıza veya genel sayfanıza herhangi bir değişiklik gerektirmez. Üçüncüsü, yeni bir uç nokta veya yeni bir webhook olayı gönderdiğimizde, çerçeve sarmalayıcıları bunu bir sonraki sürümde açığa çıkarır; temel API sözleşmedir.
SDK'mız, sarmalayıcımız veya çerçeve entegrasyonumuz olmadan entegre olabilirsiniz.
Blockchain0x API'si, bearer-token kimlik doğrulaması ile HTTPS üzerinden düz JSON'dur. Herhangi bir dildeki herhangi bir HTTP istemcisi bunu çağırabilir. Resmi SDK'lar ve çerçeve sarmalayıcıları, kolaylık katmanlarıdır; ham API belgelenmiştir, stabildir ve ona karşı elle yazmanın makul olmasını sağlayacak kadar kasıtlı olarak küçüktür.
curl -X POST https://api.blockchain0x.com/v1/payments \ -H "Authorization: Bearer $BLOCKCHAIN0X_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "agentId": "<your-agent-id>", "to": "0xRecipientAddress", "amountWei": "100000", "metadata": { "reason": "Custom market analysis" } }'
SDK'yı atlamak mantıklı olduğunda
- Sunduğumuz bir dilde değilsiniz. Go, Rust, Elixir, Ruby, PHP, Java - bunların hepsi, standart HTTP kütüphaneleri ile API'mizi yerel olarak çağırabilir. Özel bir araç gerektirmez.
- Sınırdasınız. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - ek bir bağımlılığı birleştirmek istemeyeceğiniz ortamlar. Ham API burada değişiklik olmadan çalışır.
- Tam olarak telde ne olduğunu görmek istiyorsunuz. Hata ayıklama, güvenlik incelemesi veya protokolü öğrenmek için, ham HTTP şekli SDK kaynağını okumaktan daha nettir.
- Kendi HTTP katmanınız var, yeniden denemeler, günlükleme, telemetri ile. Kendi tekrar davranışına sahip başka bir SDK'yı getirmek mevcut altyapınızla çatışır. Ham API'yi sadece başka bir HTTP uç noktası olarak çağırmak temiz bir şekilde yerleştirilir.
docs.blockchain0x.com adresindeki tam API referansı OpenAPI spesifikasyonunu içermektedir, böylece OpenAPI kod üretim aracına sahip herhangi bir dilde kendi istemcinizi de oluşturabilirsiniz.
Her çerçevenin doğru araç olduğu zaman.
Henüz bir ajan çerçevesi seçmediyseniz, işte ticaret dengelerini nasıl gördüğümüz. Bunların hiçbiri yanlış seçimler değil; doğru olan, ajanın ne yaptığına ve kimin bakımını yaptığına bağlıdır.
| Çerçeve | En iyi ne zaman | Kaçının |
|---|---|---|
| LangChain | Mevcut LangChain codebase, karmaşık tool zincirleri, geniş ekosistem kullanımı | Minimum bağımlılıklar istiyorsunuz; LangChain çok şey getiriyor |
| LangGraph | Durum tutan çok adımlı iş akışları, dayanıklı yürütme, human-in-the-loop | Basit doğrusal zincirler; grafik yükü boşa gidiyor |
| CrewAI | Çoklu agent işbirliği kalıpları (araştırmacı + yazar + gözden geçirici) | Tek ajans döngüleri; CrewAI ekipler için tasarlandı |
| AutoGen | Çoklu agent konuşması, grup sohbeti kalıpları, Microsoft araçları | Üretim yüksek verim; AutoGen araştırma için optimize edilmiştir |
| LlamaIndex | RAG ağırlıklı ajanlar, çekirdek yetenek olarak belge Soru-Cevap | Saf araç kullanımı ajanları; LlamaIndex'in güçlü yönleri kullanılmıyor |
| OpenAI Agents SDK | Yalnızca OpenAI tabanlı stack'ler, en temiz tool kullanım API'sini istiyor | Çoklu sağlayıcı yığınları; OpenAI SDK, OpenAI merkezli |
| Pydantic AI | Tüm ajan giriş/çıkışlarında güçlü tipleme, Python-first | TypeScript öncelikli yığınlar; Python yerel tipleri değerdir |
| Semantic Kernel | Mevcut .NET / C# / Java codebase, kurumsal Microsoft ortamı | Sadece Python takımları; kullanılmayan MS entegrasyonu için ödeme yapıyorsunuz |
| Agno | Python-native, hafif, minimum soyutlama maliyeti ister | LangChain ekosisteminin üçüncü taraf entegrasyonlarına ihtiyacınız var |
| MCP middleware | Bir MCP server çalıştırıyorsunuz ve istemcilerin çağrı başına ödeme yapmasını istiyorsunuz | Bir MCP sunucusu çalıştırmıyorsunuz (bu bir sunucu tarafı modelidir) |
İki pratik tavsiye. Sıfırdan başlıyorsanız ve mümkün olan en küçük öğrenme eğrisini istiyorsanız, LangChain veya OpenAI Agents SDK en güvenli varsayılanlardır. Zaten bir çerçeveniz varsa, onun için entegrasyonumuz iyi çalışır; sadece Blockchain0x kullanmak için çerçeveleri değiştirmeyin.
Belirli senaryolar kendi sayfalarını alır.
Çerçeveye özgü entegrasyon sayfalarının ötesinde, daha dar sorularla ilgili uzun kuyruklu kılavuzlar yayımlıyoruz: "LangGraph çok adımlı iş akışına nasıl ödeme eklerim", "MCP sunucumun her araç için nasıl ücret almasını sağlarım", "USDC ödemesi arkasında Stripe benzeri bir API'yi nasıl kapatırım". Bunlar /lp/{slug} adresinde yer alır ve kasıtlı olarak ana navigasyonda yer almaz. Arama yoluyla bulunurlar; her biri ilgili entegrasyon sayfasına geri bağlanır.
Onları nerede bulabilirsiniz
Uzun kuyruklu kılavuzların ilk partisi, entegrasyon çerçevesi sayfalarıyla birlikte gönderilir. O zamana kadar, en somut senaryo özel içerik, docs.blockchain0x.com adresindeki "Kılavuzlar" altında yer alır. Her /lp/ sayfası, çalıştırabileceğiniz kodu ve ilgili ajansı Pro'ya yükseltmek için doğrudan bir CTA içerir.