OpenAI Agents SDK కోసం ప్రత్యేక package లేదు, మీకు అది అవసరమూ లేదు. SDK తో decorated function ను tool గా మారుస్తుంది, కాబట్టి మీరు నిజమైన Python client ను ఒక function లో wrap చేసి, దాన్ని మీ లో చేర్చుతారు. Agent USDC పంపగలదు, invoices settle చేయగలదు, wallets చదవగలదు - single agents, handoffs, మరియు underlying Responses API అంతటా. Payments Base పై settle అవుతాయి.

ఏజెంట్స్ SDK మరియు కోర్ SDKని ఇన్‌స్టాల్ చేయండి. రెండు కీలు.

చేర్చడానికి blockchain0x Agents SDK ప్యాకేజీ లేదు. మీరు OpenAI Agents SDKని (openai-agents ప్యాకేజీ, Python 3.10+) మరియు నిజమైన blockchain0x కోర్ SDKని ఇన్‌స్టాల్ చేస్తారు, తరువాత క్రింద ఫంక్షన్‌ను రాస్తారు. అది మొత్తం ఆధారిత జాబితా.

pip install openai-agents blockchain0x

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

OPENAI_API_KEY మీ existing OpenAI key (Agents SDK underlying Responses API కోసం దాన్ని use చేస్తుంది). BLOCKCHAIN0X_API_KEY అనేది మీ dashboard నుంచి వచ్చిన sk_test_ testnet లేదా sk_live_ mainnet key; client దాన్ని environment నుండి reads చేస్తుంది. మీ agent కు money కూడా వస్తే, webhook handler కు అదనంగా BLOCKCHAIN0X_WEBHOOK_SECRET అవసరం.

సంతకం చేసిన వెబ్‌హుక్‌తో ఇన్‌బౌండ్ చెల్లింపులను నిర్ధారించండి.

మీ ఏజెంట్ కూడా USDCని అందుకుంటే, దాన్ని పోలింగ్ చేయకుండా వెబ్‌హుక్‌తో ధృవీకరించండి. ధృవీకరించు సహాయకుడు Node SDKలో షిప్పింగ్ చేస్తుంది; ఒక Python సేవలో మీరు డాక్యుమెంటెడ్ HMACకు వ్యతిరేకంగా చేతితో ధృవీకరించాలి, ఇది సహాయకుడు చేసే అన్ని విషయాలు. కింద ఉన్న FastAPI ఉదాహరణ; అదే కోడ్ ఏ అసంక్రోనస్ Python ఫ్రేమ్‌వర్క్‌లో పనిచేస్తుంది.

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}

అల్గోరిథం t.rawBody అనే స్ట్రింగ్‌పై HMAC-SHA256, స్థిర-సమయాన్ని పోల్చడం, మరియు 300-సెకన్ల రీప్లే విండో. సంతకం కవర్ చేసే బైట్స్‌ను మార్చడం వల్ల await request.body() ద్వారా కచ్చితమైన శరీరాన్ని చదవండి, ఎప్పుడూ request.json() మళ్లీ సీరియలైజ్ చేయకండి. పంపిన ఈవెంట్లు payment.received, payment.sent, wallet.deployed, మరియు webhook.test. భారీ ఫాలో-అప్ పనికి, ఒక ఉద్యోగాన్ని ఎన్‌క్యూ చేయండి (Celery, arq) మరియు హ్యాండ్లర్‌ను బ్లాక్ చేయకుండా వెంటనే 200 కి స్పందించండి.

మొదటి సమీకరణలో గమనించాల్సిన ఐదు విషయాలు.

ఇవి మా మద్దతు ఇన్బాక్స్ నుండి వస్తాయి. ముందుగా వాటిని తెలుసుకోవడం ప్రతి ఒక్కటికి ఒక గంటను సేవ్ చేస్తుంది.