Không có package riêng cho Agno, và bạn cũng không cần một package như vậy. Agno biến một phương thức thành một tool, vì vậy bạn bọc Python client thực sự trong một toolkit nhỏ và thêm nó vào của bạn. Agent có thể gửi USDC, thanh toán hóa đơn và đọc ví, trên mọi model của Agno (OpenAI, Anthropic, DeepSeek, Llama, Mistral). Thanh toán được chốt trên Base.

Cài đặt Agno và SDK cốt lõi. Hai khóa.

Không có gói blockchain0x Agno nào để thêm. Bạn cài đặt Agno (Python 3.10+, dòng 1.0+ sau khi đổi tên Phidata) và SDK cốt lõi blockchain0x thực tế, sau đó viết toolkit bên dưới. Nếu bạn vẫn đang sử dụng các import phi.*, hãy chạy pip install -U agno trước.

pip install agno blockchain0x

export OPENAI_API_KEY=sk-...
export BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet

OPENAI_API_KEY (hoặc khóa tương đương cho model được Agno hỗ trợ mà bạn dùng). BLOCKCHAIN0X_API_KEY là khóa sk_test_ testnet hoặc sk_live_ mainnet từ dashboard của bạn; client sẽ đọc khóa này từ biến môi trường. Nếu agent của bạn cũng nhận tiền, webhook handler còn cần thêm BLOCKCHAIN0X_WEBHOOK_SECRET.

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, arq) và phản hồi 200 ngay lập tức thay vì chặn trình xử lý.

Năm điều cụ thể về Agno cần chú ý.

Agno là một trong những khung đại lý dễ tích hợp nhất, nhưng nó có những điểm cần lưu ý riêng - đặc biệt là xung quanh việc đổi tên Phidata và việc render markdown.