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.
Mười khung. Ba gói, bảy công thức, một API.
LangChain
Gói PyPIBộ công cụ Python từ gói blockchain0x-langchain; các tác nhân TypeScript bọc khách hàng x402
CrewAI
Gói PyPIBộ công cụ Python từ blockchain0x-crewai, cùng hình dạng nhà máy như LangChain
AutoGen
Công thức SDKCông thức: bọc SDK trong một công cụ hàm AutoGen
LlamaIndex
Công thức SDKCông thức: bọc khách hàng trong một FunctionTool LlamaIndex
OpenAI Agents SDK
Công thức SDKCông thức: bọc khách hàng trong một công cụ hàm OpenAI Agents SDK
Pydantic AI
Công thức SDKCông thức: đăng ký một công cụ Pydantic AI gọi khách hàng
LangGraph
Công thức SDKCông thức: một nút LangGraph gọi khách hàng x402
Semantic Kernel
Công thức SDKCông thức: một KernelFunction bọc SDK; không có bộ chuyển đổi NuGet hoặc Java
Agno
Công thức SDKCông thức: một Bộ công cụ Agno bọc khách hàng Python
MCP servers
gói npmCông cụ ví cho bất kỳ khách hàng MCP nào thông qua máy chủ @blockchain0x/mcp
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
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á
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.
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ạ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 -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.
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ó.
| Khung | Tốt nhất khi | Tránh khi |
|---|---|---|
| LangChain | Codebase LangChain hiện có, các chuỗi tool phức tạp, sử dụng rộng trong hệ sinh thái | Bạn muốn các phụ thuộc tối thiểu; LangChain kéo vào rất nhiều |
| LangGraph | Workflow nhiều bước có trạng thái, thực thi bền vững, human-in-the-loop | Chuỗi tuyến tính đơn giản; chi phí đồ thị bị lãng phí |
| CrewAI | Mẫ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 |
| AutoGen | Hội thoại nhiều agent, mẫu group chat, công cụ Microsoft | Sản xuất có thông lượng cao; AutoGen tối ưu hóa cho nghiên cứu |
| LlamaIndex | Agent thiên về RAG, Q+A tài liệu là năng lực cốt lõi | Cá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 SDK | Các stack chỉ dùng OpenAI, muốn API dùng tool gọn nhất | Nhiều nhà cung cấp; OpenAI SDK là trung tâm OpenAI |
| Pydantic AI | Kiểu dữ liệu chặt chẽ trên toàn bộ input/output của agent, ưu tiên Python | Các ngăn xếp đầu tiên là TypeScript; kiểu gốc Python là giá trị |
| Semantic Kernel | Codebase .NET / C# / Java hiện có, doanh nghiệp dùng hệ sinh thái Microsoft | Nhóm chỉ sử dụng Python; bạn đang trả tiền cho tích hợp MS không sử dụng |
| Agno | Thuần Python, nhẹ, muốn tối thiểu hóa chi phí trừu tượng hóa | Bạn cần các tích hợp bên thứ ba của hệ sinh thái LangChain |
| MCP middleware | Bạ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ọi | Bạ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.
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.