Salta al contenuto principale
INTEGRAZIONI

Collega Blockchain0x al tuo stack agente.

Codice reale per ogni popolare framework per agenti. Un pacchetto spedito dove esiste, una breve ricetta SDK dove non esiste.

Scegli il tuo framework. Dove spediamo un pacchetto lo installi; altrimenti avvolgi il nostro SDK nello strumento nativo di quel framework. In entrambi i casi è uno strato sottile su una singola API HTTP, e puoi saltarlo e chiamare l'API direttamente.

Ogni scheda apre un approfondimento: l'installazione o la ricetta, un esempio di agente funzionante, gestione dei webhook e insidie comuni. Tre vengono spediti come pacchetti reali oggi - blockchain0x-langchain e blockchain0x-crewai su PyPI, e @blockchain0x/mcp su npm. Gli altri sette sono ricette brevi sullo stesso SDK. Nessun pacchetto inventato.

COSA INCLUDE OGNI INTEGRAZIONE

Una forma coerente in ogni framework.

  • Il comando di installazione del package, o la procedura quando non esiste un package
  • Codice da copiare e incollare che puoi eseguire, non pseudocodice
  • Una breve risposta a 'come aggiungo i pagamenti al mio agent {framework}'
  • Voci FAQ con schema HowTo/FAQ per i motori di ricerca AI
  • Un link alla landing page long-tail corrispondente
  • Un link alla pagina dei prezzi
ARCHITETTURA

Ogni integrazione è un sottile wrapper sopra la stessa API.

Le integrazioni Blockchain0x non sono 10 prodotti separati. Sono 10 diverse superfici ergonomiche su un'unica API HTTP. L'API è la fonte di verità; i wrapper del framework esistono per farti risparmiare tempo.

Diagramma dell'architettura SDK: wrapper del framework che chiamano una singola API HTTP Blockchain0x

Ogni wrapper traduce da "il modo in cui il tuo framework definisce uno strumento" in "una chiamata HTTP alla nostra API". Questo è il lavoro intero. Gli adattatori Python espongono create_blockchain0x_toolset(client), che fornisce a LangChain o CrewAI un set di strumenti già pronti. Un framework senza un adattatore spedito avvolge createX402Client(...) (Node) o il client blockchain0x (Python) in uno strumento nativo di quel framework. Stessa API sotto, in entrambi i casi.

Questo è importante per alcuni motivi. Prima di tutto, puoi mescolare e abbinare: un agente di produzione LangChain e un agente sperimentale CrewAI possono entrambi mirare allo stesso wallet agente Blockchain0x senza conflitti. In secondo luogo, non sei bloccato in una scelta di framework attraverso di noi; cambiare framework non richiede alcuna modifica al tuo wallet, alle tue politiche di spesa o alla tua pagina pubblica. Infine, quando rilasciamo un nuovo endpoint o un nuovo evento webhook, i wrapper del framework lo espongono nel loro prossimo rilascio; l'API sottostante è il contratto.

SALTA L'SDK

Puoi integrare senza il nostro SDK, il nostro wrapper o la nostra integrazione del framework.

L'API Blockchain0x è JSON semplice su HTTPS con autenticazione bearer-token. Qualsiasi client HTTP in qualsiasi linguaggio può chiamarlo. Gli SDK ufficiali e i wrapper del framework sono strati di convenienza; l'API grezza è documentata, stabile e intenzionalmente abbastanza piccola da rendere ragionevole la scrittura a mano.

CURL - NESSUN SDK
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" }
  }'

Quando ha senso saltare l'SDK

  • Sei in una lingua che non distribuiamo. Go, Rust, Elixir, Ruby, PHP, Java - tutti questi possono chiamare la nostra API nativamente con le loro librerie HTTP standard. Non è necessario alcun strumento speciale.
  • Sei al limite. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - ambienti in cui preferiresti non includere una dipendenza extra. L'API grezza funziona lì senza modifiche.
  • Vuoi vedere esattamente cosa c'è sul filo. Per il debug, la revisione della sicurezza o l'apprendimento del protocollo, la forma HTTP grezza è più chiara della lettura del codice sorgente dell'SDK.
  • Hai il tuo livello HTTP con ripetizioni, registrazione, telemetria. Portare un altro SDK con il proprio comportamento di ripetizione combatte la tua infrastruttura esistente. Chiamare l'API raw come un altro endpoint HTTP si integra facilmente.

Il riferimento completo all'API su docs.blockchain0x.com include la specifica OpenAPI, quindi puoi anche generare il tuo client in qualsiasi linguaggio che abbia uno strumento di generazione di codice OpenAPI.

SCELTA DI UN FRAMEWORK

Quando ogni framework è lo strumento giusto.

Se non hai ancora scelto un framework per agenti, ecco come vediamo i compromessi. Nessuna di queste è una scelta sbagliata; quella giusta dipende da cosa fa il tuo agente e chi lo mantiene.

FrameworkMigliore quandoEvita quando
LangChainCodebase LangChain esistente, catene di tool complesse, uso diffuso nell'ecosistemaVuoi dipendenze minime; LangChain ne richiede molte
LangGraphWorkflow multi-step stateful, esecuzione durabile, human-in-the-loopCatene lineari semplici; l'overhead del grafo è sprecato
CrewAIPattern di collaborazione multi-agente (researcher + writer + reviewer)Loop di agenti singoli; CrewAI è costruito per squadre
AutoGenConversazione multi-agente, pattern di gruppo chat, strumenti MicrosoftProduzione ad alta capacità; AutoGen ottimizza per la ricerca
LlamaIndexAgenti con forte uso di RAG, Q+A su documenti come funzionalità coreAgenti di solo utilizzo di strumenti; i punti di forza di LlamaIndex rimangono inutilizzati
OpenAI Agents SDKStack solo OpenAI, vogliono la API di utilizzo tool più pulitaStack multi-fornitore; OpenAI SDK è OpenAI-centrico
Pydantic AITipizzazione forte su tutti gli input/output degli agenti, Python-firstStack incentrati su TypeScript; la tipizzazione nativa di Python è il valore
Semantic KernelCodebase .NET / C# / Java esistente, azienda enterprise orientata a MicrosoftTeam solo Python; stai pagando per un'integrazione MS non utilizzata
AgnoPython-native, leggero, con overhead di astrazione minimoHai bisogno delle integrazioni di terze parti dell'ecosistema LangChain
MCP middlewareStai eseguendo un server MCP e vuoi che i client paghino per chiamataNon stai eseguendo un server MCP (è un modello lato server)

Due consigli pratici. Se stai partendo da zero e vuoi la curva di apprendimento più piccola possibile, LangChain o OpenAI Agents SDK sono le scelte più sicure. Se hai già un framework, la nostra integrazione funziona bene; non cambiare framework solo per utilizzare Blockchain0x.

GUIDE APPROFONDITE

Scenari specifici hanno la loro pagina.

Oltre alle pagine di integrazione specifiche del framework, pubblichiamo guide a lungo termine su domande più specifiche: "come posso aggiungere pagamenti a un flusso di lavoro multi-step di LangGraph", "come posso far pagare il mio server MCP per strumento", "come posso proteggere un'API simile a Stripe dietro il pagamento in USDC". Queste si trovano su /lp/{slug} e non sono intenzionalmente nella navigazione principale. Vengono trovate tramite ricerca; ciascuna rimanda alla pagina di integrazione pertinente.

Dove trovarli

Il primo lotto di guide long-tail viene spedito insieme alle pagine del framework di integrazione. Fino ad allora, il contenuto specifico per scenari più concreto si trova nella documentazione su docs.blockchain0x.com sotto "Guide". Ogni pagina /lp/ include codice funzionante che puoi eseguire e una CTA diretta per aggiornare l'agente pertinente a Pro.

DOMANDE FREQUENTI

Cinque domande di integrazione a cui vale la pena rispondere.

Se l'SDK è facoltativo, perché esiste?

Tre ragioni. Prima, ergonomia: l'SDK genera automaticamente chiavi di idempotenza, tipizza ogni richiesta e risposta e raggruppa la verifica della firma del webhook in modo che tu non debba scrivere quel codice tu stesso. Secondo, protezione da drift: quando aggiungiamo un endpoint o cambiamo un campo, la prossima versione dell'SDK lo espone; gli utenti HTTP raw devono leggere il changelog. Terzo, strumentazione: l'SDK emette automaticamente log e metriche strutturate in un formato compatibile con stack di osservabilità comuni. Nessuna di queste è essenziale, ma risparmia 30-90 minuti di tempo di integrazione. Se preferisci vedere la forma grezza dell'API, salta l'SDK e usa curl o qualsiasi client HTTP.

Sto utilizzando un framework che non elencate. Posso comunque integrare?

Sì. Ogni integrazione si basa sulla stessa piccola API REST: agenti, pagamenti, richieste di pagamento, transazioni, webhook, oltre a permessi di spesa in sola lettura. L'autenticazione è un token bearer, i webhook sono firmati con HMAC-SHA256. Se puoi parlare HTTP, puoi integrare da qualsiasi framework, inclusi quelli senza wrapper forniti - devi solo avvolgere il nostro SDK nello strumento del framework. Le pagine del framework esistono per comodità, non per limitare l'accesso. Vuoi un adattatore ufficiale per il tuo framework? Facci sapere tramite la documentazione e lo valuteremo in base alla domanda.

Un agente può essere servito da più integrazioni di framework contemporaneamente?

Sì. Un singolo agente ha un indirizzo di portafoglio, un set di chiavi API, una politica di spesa e una pagina pubblica. Diverse parti del tuo stack possono chiamare la nostra API attraverso diverse integrazioni di framework: un agente LangChain in produzione, un esperimento CrewAI, un middleware del server MCP, tutti pagando lo stesso agente o tutti addebitando tramite lo stesso agente. Il confine del framework è dalla tua parte; vediamo solo richieste API autenticate e iscrizioni a webhook.

Le integrazioni del framework costano extra?

No. Gli adattatori spediti - blockchain0x-langchain e blockchain0x-crewai su PyPI, e il server @blockchain0x/mcp su npm - sono gratuiti, e lo sono anche gli SDK. Per ogni altro framework non c'è un pacchetto extra da acquistare: avvolgi tu stesso l'SDK in poche righe. Il tuo costo è l'abbonamento per agente più le commissioni di transazione che pagheresti comunque. Installare il pacchetto LangChain costa quanto chiamare l'API con curl. Il pacchetto fa risparmiare tempo, non blocca le funzionalità.

Quanto velocemente aggiornate le integrazioni quando i framework introducono modifiche significative?

Per gli adattatori spediti (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp) monitoriamo i framework che le persone utilizzano effettivamente e aggiorniamo quando una versione principale viene rilasciata; siamo all'inizio e non promettiamo ancora un SLA fisso. Le versioni minori di solito non necessitano di modifiche perché gli adattatori avvolgono interfacce stabili. I framework basati su ricette si muovono a malapena qui: chiamano direttamente l'SDK, quindi un aggiornamento del framework tocca raramente la nostra superficie. Se un cambiamento che rompe rende un adattatore non sicuro, lo annotiamo sulla pagina /integrations/ corrispondente prima di ritirare il supporto.

Collegalo, inizia a ricevere pagamenti.

Gratuito per iniziare. Cinque minuti per la tua prima richiesta di pagamento.