Không có package riêng cho AutoGen, và bạn cũng không cần một package như vậy. AutoGen đã biến một hàm có kiểu thuần túy thành một tool, vì vậy bạn bọc Python client thực sự trong một hàm, đưa nó cho một qua , và agent có thể gửi USDC, thanh toán hóa đơn và đọc ví trên Base. Chỉ cần đặt và bắt đầu.

Cài đặt AutoGen và SDK cốt lõi. Một biến môi trường.

Không có gói AutoGen chuyên dụng nào để thêm. Bạn cài đặt AutoGen (Python 3.10+) và SDK cốt lõi blockchain0x thực tế, sau đó viết hàm bên dưới. Đó là toàn bộ danh sách phụ thuộc.

pip install autogen-agentchat "autogen-ext[openai]" blockchain0x

export BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet

BLOCKCHAIN0X_API_KEY là một khóa sk_test_ testnet hoặc sk_live_ mainnet từ dashboard của bạn; client đọc nó từ môi trường. Nếu agent của bạn cũng nhận tiền, webhook handler còn cần BLOCKCHAIN0X_WEBHOOK_SECRET, giá trị này dashboard chỉ trả về một lần khi bạn tạo hoặc xoay vòng một webhook.

Xác nhận các khoản thanh toán đến với một webhook đã ký.

Nếu tác nhân của bạn cũng nhận USDC, hãy xác nhận điều đó với webhook thay vì polling. Trợ giúp xác minh có trong Node SDK; trong một dịch vụ Python, bạn xác minh bằng tay theo HMAC đã được tài liệu hóa, đó là tất cả những gì trợ giúp làm. Ví dụ FastAPI bên dưới; cùng một mã hoạt động trong bất kỳ khung Python bất đồng bộ nào.

import hmac, hashlib, os, time
from fastapi import FastAPI, Request, HTTPException

app = FastAPI()
SECRET = os.environ["BLOCKCHAIN0X_WEBHOOK_SECRET"].encode()

@app.post("/webhooks/payment")
async def receive(request: Request):
    raw = await request.body()  # RAW bytes - do not parse first
    sig = request.headers.get("X-Blockchain0x-Signature", "")
    ts = request.headers.get("X-Blockchain0x-Timestamp", "")
    parts = dict(p.split("=", 1) for p in sig.split(",") if "=" in p)
    t, v1 = parts.get("t", ts), parts.get("v1", sig)
    want = hmac.new(SECRET, t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(want, v1) or abs(time.time() - int(t)) > 300:
        raise HTTPException(status_code=401)
    if request.headers.get("X-Blockchain0x-Event-Type") == "payment.received":
        await trigger_followup()  # USDC landed - run the next step
    return {"ok": True}

Thuật toán là HMAC-SHA256 trên chuỗi t.rawBody, so sánh thời gian không đổi và cửa sổ phát lại 300 giây. Đọc nội dung thô qua await request.body(), không bao giờ request.json() được tái tuần tự hóa, vì điều đó thay đổi các byte mà chữ ký bao phủ. Các sự kiện đã được gửi là payment.received, payment.sent, wallet.deployed và webhook.test. Đối với công việc theo dõi nặng, hãy xếp hàng một công việc (Celery, RQ, arq) và phản hồi 200 ngay lập tức thay vì chặn trình xử lý.

Năm cạm bẫy trong trò chuyện nhóm và bất đồng bộ cần tránh.

Thiết kế đa đại lý + bất đồng bộ của AutoGen mở khóa các mô hình mạnh mẽ nhưng cũng giới thiệu những cạm bẫy riêng. Những điều này đến từ hộp thư hỗ trợ của chúng tôi.