Bỏ qua nội dung chính
TÍCH HỢP

Kết nối Blockchain0x vào hệ thống agent của bạn.

Mã thực cho mọi khung tác nhân phổ biến. Một gói đã được gửi nơi có, một công thức SDK ngắn nơi không có.

Chọn khung của bạn. Nơi chúng tôi gửi một gói bạn cài đặt nó; nếu không, bạn bọc SDK của chúng tôi trong công cụ gốc của khung đó. Dù sao thì nó cũng là một lớp mỏng trên một API HTTP, và bạn có thể bỏ qua nó và gọi API trực tiếp.

Mỗi thẻ mở ra một cái nhìn sâu sắc: cài đặt hoặc công thức, một ví dụ về tác nhân đang hoạt động, xử lý webhook và những cạm bẫy phổ biến. Ba gói được phát hành như các gói thực tế hôm nay - blockchain0x-langchain và blockchain0x-crewai trên PyPI, và @blockchain0x/mcp trên npm. Bảy gói còn lại là các công thức ngắn trên cùng một SDK. Không có gói nào được phát minh.

CÁC KHUNG ĐƯỢC HỖ TRỢ

Mười khung. Ba gói, bảy công thức, một API.

MỌI TÍCH HỢP ĐỀU BAO GỒM

Một hình dạng nhất quán trên mọi framework.

  • Lệnh cài đặt cho package, hoặc công thức khi không có package
  • Mã có thể copy-paste và chạy được, không phải pseudocode
  • Một câu trả lời ngắn cho 'làm sao để thêm thanh toán vào agent {framework} của tôi'
  • Mục FAQ với schema HowTo/FAQ cho công cụ tìm kiếm AI
  • Liên kết tới trang đích long-tail tương ứng
  • Liên kết tới trang giá
KIẾN TRÚC

Mỗi tích hợp là một lớp bọc mỏng trên cùng một API.

Các tích hợp Blockchain0x không phải là 10 sản phẩm riêng biệt. Chúng là 10 bề mặt công thái học khác nhau trên một API HTTP duy nhất. API là nguồn sự thật; các bộ bọc khung tồn tại để tiết kiệm thời gian cho bạn.

Sơ đồ kiến trúc SDK: các lớp bọc khung gọi một API HTTP Blockchain0x duy nhất

Mỗi bộ bọc chuyển đổi từ "cách mà khung của bạn định nghĩa một công cụ" thành "một cuộc gọi HTTP đến API của chúng tôi". Đó là toàn bộ công việc. Các bộ điều hợp Python công khai create_blockchain0x_toolset(client), cung cấp cho LangChain hoặc CrewAI một bộ công cụ đã được chuẩn bị sẵn. Một khung không có bộ điều hợp đã được phát hành sẽ bọc createX402Client(...) (Node) hoặc khách hàng blockchain0x (Python) trong một công cụ gốc của khung đó. Cùng một API bên dưới, theo cách nào cũng vậy.

Điều này quan trọng vì một vài lý do. Đầu tiên, bạn có thể kết hợp và chọn lựa: một đại lý sản xuất LangChain và một đại lý thử nghiệm CrewAI có thể nhắm đến cùng một ví đại lý Blockchain0x mà không có xung đột. Thứ hai, bạn không bị khóa vào lựa chọn khung làm việc thông qua chúng tôi; việc chuyển đổi khung không yêu cầu bất kỳ thay đổi nào đối với ví của bạn, chính sách chi tiêu của bạn, hoặc trang công khai của bạn. Thứ ba, khi chúng tôi phát hành một điểm cuối mới hoặc một sự kiện webhook mới, các lớp khung sẽ công khai nó trong bản phát hành tiếp theo của họ; API cơ bản là hợp đồng.

BỎ QUA SDK

Bạn có thể tích hợp mà không cần SDK, wrapper hoặc tích hợp khung của chúng tôi.

API Blockchain0x là JSON đơn giản qua HTTPS với xác thực bearer-token. Bất kỳ khách hàng HTTP nào trong bất kỳ ngôn ngữ nào cũng có thể gọi nó. Các SDK và bộ bọc chính thức là các lớp tiện lợi; API thô được tài liệu hóa, ổn định và cố ý đủ nhỏ để việc viết tay chống lại nó là hợp lý.

CURL - KHÔNG CÓ 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" }
  }'

Khi bỏ qua SDK là hợp lý

  • Bạn đang ở trong một ngôn ngữ mà chúng tôi không cung cấp. Go, Rust, Elixir, Ruby, PHP, Java - tất cả những ngôn ngữ này có thể gọi API của chúng tôi một cách tự nhiên với các thư viện HTTP tiêu chuẩn của chúng. Không cần công cụ đặc biệt.
  • Bạn đang ở trên rìa. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - các môi trường mà bạn không muốn gộp thêm một phụ thuộc nào. API thô hoạt động ở đó mà không cần thay đổi.
  • Bạn muốn xem chính xác những gì đang truyền tải. Để gỡ lỗi, xem xét bảo mật hoặc học giao thức, hình dạng HTTP thô rõ ràng hơn so với việc đọc mã nguồn SDK.
  • Bạn có lớp HTTP riêng của mình với các lần thử lại, ghi nhật ký, giám sát. Việc đưa vào một SDK khác với hành vi thử lại của riêng nó sẽ gây khó khăn cho cơ sở hạ tầng hiện tại của bạn. Gọi API thô như một điểm cuối HTTP khác sẽ tích hợp một cách sạch sẽ.

Tài liệu tham khảo API đầy đủ tại docs.blockchain0x.com bao gồm thông số kỹ thuật OpenAPI, vì vậy bạn cũng có thể tạo khách hàng của riêng mình bằng bất kỳ ngôn ngữ nào có công cụ sinh mã OpenAPI.

CHỌN MỘT KHUNG

Khi mỗi framework là công cụ đúng.

Nếu bạn chưa chọn một khung agent nào, đây là cách chúng tôi thấy các đánh đổi. Không có lựa chọn nào trong số này là sai; lựa chọn đúng phụ thuộc vào việc agent của bạn làm gì và ai duy trì nó.

KhungTốt nhất khiTránh khi
LangChainCodebase LangChain hiện có, các chuỗi tool phức tạp, sử dụng rộng trong hệ sinh tháiBạn muốn các phụ thuộc tối thiểu; LangChain kéo vào rất nhiều
LangGraphWorkflow nhiều bước có trạng thái, thực thi bền vững, human-in-the-loopChuỗi tuyến tính đơn giản; chi phí đồ thị bị lãng phí
CrewAIMẫu cộng tác nhiều agent (researcher + writer + reviewer)Vòng lặp đơn tác nhân; CrewAI được xây dựng cho các nhóm
AutoGenHội thoại nhiều agent, mẫu group chat, công cụ MicrosoftSản xuất có thông lượng cao; AutoGen tối ưu hóa cho nghiên cứu
LlamaIndexAgent thiên về RAG, Q+A tài liệu là năng lực cốt lõiCác đại lý chỉ sử dụng công cụ; sức mạnh của LlamaIndex không được sử dụng
OpenAI Agents SDKCác stack chỉ dùng OpenAI, muốn API dùng tool gọn nhấtNhiều nhà cung cấp; OpenAI SDK là trung tâm OpenAI
Pydantic AIKiểu dữ liệu chặt chẽ trên toàn bộ input/output của agent, ưu tiên PythonCác ngăn xếp đầu tiên là TypeScript; kiểu gốc Python là giá trị
Semantic KernelCodebase .NET / C# / Java hiện có, doanh nghiệp dùng hệ sinh thái MicrosoftNhóm chỉ sử dụng Python; bạn đang trả tiền cho tích hợp MS không sử dụng
AgnoThuần Python, nhẹ, muốn tối thiểu hóa chi phí trừu tượng hóaBạn cần các tích hợp bên thứ ba của hệ sinh thái LangChain
MCP middlewareBạn đang vận hành một MCP server và muốn khách hàng trả tiền theo mỗi lần gọiBạn không chạy một máy chủ MCP (đó là một mẫu phía máy chủ)

Hai lời khuyên thực tế. Nếu bạn bắt đầu từ con số không và muốn có đường cong học tập nhỏ nhất có thể, LangChain hoặc OpenAI Agents SDK là những lựa chọn an toàn nhất. Nếu bạn đã có một khung làm việc, tích hợp của chúng tôi cho nó hoạt động tốt; đừng chuyển đổi khung chỉ để sử dụng Blockchain0x.

HƯỚNG DẪN SÂU HƠN

Các kịch bản cụ thể có trang riêng của chúng.

Ngoài các trang tích hợp cụ thể cho từng khung, chúng tôi xuất bản các hướng dẫn dài về các câu hỏi hẹp hơn: "làm thế nào để tôi thêm thanh toán vào một quy trình làm việc đa bước LangGraph", "làm thế nào để tôi cho phép máy chủ MCP của mình thu phí theo công cụ", "làm thế nào để tôi đặt một API giống như Stripe phía sau thanh toán USDC". Những cái này nằm tại /lp/{slug} và cố ý không có trong điều hướng chính. Chúng được tìm thấy qua tìm kiếm; mỗi cái liên kết trở lại trang tích hợp liên quan.

Nơi tìm chúng

Lô đầu tiên của các hướng dẫn dài được gửi cùng với các trang khung tích hợp. Cho đến lúc đó, nội dung cụ thể cho kịch bản cụ thể nhất sống trong tài liệu tại docs.blockchain0x.com dưới "Hướng dẫn". Mỗi trang /lp/ bao gồm mã hoạt động mà bạn có thể chạy và một CTA trực tiếp để nâng cấp tác nhân liên quan lên Pro.

CÂU HỎI THƯỜNG GẶP

Năm câu hỏi về tích hợp đáng để trả lời.

Nếu SDK là tùy chọn, tại sao nó lại tồn tại?

Ba lý do. Thứ nhất, công thái học: SDK tự động tạo các khóa idempotency, loại mỗi yêu cầu và phản hồi, và gói xác minh chữ ký webhook để bạn không phải viết mã đó. Thứ hai, bảo vệ trôi dạt: khi chúng tôi thêm một điểm cuối hoặc thay đổi một trường, phiên bản SDK tiếp theo sẽ công khai nó; người dùng HTTP thô cần đọc nhật ký thay đổi. Thứ ba, thiết bị: SDK tự động phát ra các nhật ký có cấu trúc và số liệu theo định dạng tương thích với các ngăn xếp quan sát phổ biến. Không cái nào trong số này là thiết yếu, nhưng chúng tiết kiệm từ 30-90 phút thời gian tích hợp. Nếu bạn muốn xem hình dạng thô của API, hãy bỏ qua SDK và sử dụng curl hoặc bất kỳ khách hàng HTTP nào.

Tôi đang sử dụng một framework bạn không liệt kê. Tôi vẫn có thể tích hợp không?

Có. Mọi tích hợp đều nằm trên cùng một REST API nhỏ: agents, payments, payment-requests, transactions, webhooks, cùng spend permissions chỉ-đọc. Xác thực là bearer token, webhooks được ký bằng HMAC-SHA256. Nếu bạn dùng được HTTP, bạn có thể tích hợp từ bất kỳ framework nào, kể cả những framework chưa có wrapper đi kèm - bạn chỉ cần bọc SDK của chúng tôi trong tool riêng của framework đó. Các trang framework tồn tại để tiện dùng, không phải để làm rào cản. Muốn có adapter chính thức cho framework của bạn? Hãy cho chúng tôi biết qua tài liệu, và chúng tôi sẽ cân nhắc theo nhu cầu.

Một tác nhân có thể được phục vụ bởi nhiều tích hợp khung cùng một lúc không?

Có. Một đại lý duy nhất có một địa chỉ ví, một bộ khóa API, một chính sách chi tiêu và một trang công khai. Các phần khác nhau trong ngăn xếp của bạn có thể gọi API của chúng tôi thông qua các tích hợp khung khác nhau: một đại lý LangChain trong sản xuất, một thí nghiệm CrewAI, một middleware máy chủ MCP, tất cả đều thanh toán cho cùng một đại lý hoặc tất cả đều tính phí qua cùng một đại lý. Ranh giới khung nằm ở phía bạn; chúng tôi chỉ thấy các yêu cầu API đã xác thực và các đăng ký webhook.

Các tích hợp framework có tốn thêm không?

Không. Các bộ điều hợp được gửi đi - blockchain0x-langchain và blockchain0x-crewai trên PyPI, và máy chủ @blockchain0x/mcp trên npm - là miễn phí, và các SDK cũng vậy. Đối với mọi khung khác, không có gói bổ sung nào để mua: bạn bọc SDK của mình trong vài dòng. Chi phí của bạn là đăng ký theo tác nhân cộng với phí giao dịch mà bạn sẽ trả theo cách này. Cài đặt gói LangChain có giá tương đương với việc gọi API bằng curl. Gói này tiết kiệm thời gian, nó không giới hạn tính năng.

Bạn cập nhật tích hợp nhanh như thế nào khi các framework phát hành các thay đổi lớn?

Đối với các bộ điều hợp đã được phát hành (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp), chúng tôi theo dõi các khung mà mọi người thực sự sử dụng và cập nhật khi một phiên bản chính được phát hành; chúng tôi đang ở giai đoạn đầu và chưa hứa hẹn SLA cố định. Các phiên bản nhỏ thường không cần thay đổi vì các bộ điều hợp bao bọc các giao diện ổn định. Các khung dựa trên công thức hầu như không di chuyển ở đây: chúng gọi trực tiếp SDK, vì vậy một sự nâng cấp khung hiếm khi chạm vào bề mặt của chúng tôi. Nếu một thay đổi phá vỡ làm cho một bộ điều hợp không an toàn, chúng tôi sẽ ghi chú điều đó trên trang /integrations/ tương ứng trước khi rút lại hỗ trợ.

Kết nối nó, bắt đầu nhận tiền.

Miễn phí để bắt đầu. Năm phút để có yêu cầu thanh toán đầu tiên của bạn.