OpenAI Agents SDK package எதுவும் இல்லை, மேலும் உங்களுக்கு அது தேவையுமில்லை. SDK ஒரு decorated function-ஐ மூலம் tool-ஆக மாற்றுகிறது, ஆகவே உண்மையான Python client-ஐ ஒரு function-இல் wrap செய்து உங்கள் -க்கு சேர்க்கலாம். Agent USDC அனுப்பவும், invoices-ஐ settle செய்யவும், wallets-ஐ read செய்யவும் முடியும் - single agents, handoffs, மற்றும் underlying Responses API முழுவதிலும். Payments Base-இல் settle ஆகும்.

Agents 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 என்பது உங்கள் ஏற்கனவே உள்ள OpenAI key (Agents SDK அதைப் பின்னணி Responses API-க்கு பயன்படுத்துகிறது). BLOCKCHAIN0X_API_KEY என்பது உங்கள் dashboard-இல் உள்ள sk_test_ testnet அல்லது sk_live_ mainnet key; client அதை environment-இலிருந்து வாசிக்கிறது. உங்கள் agent பணத்தையும் பெறுமானால், webhook handler-க்கு கூடுதலாக BLOCKCHAIN0X_WEBHOOK_SECRET தேவைப்படும்.

ஒரு கையொப்பம் செய்யப்பட்ட webhook உடன் உள்ளே வரும் கட்டணங்களை உறுதிப்படுத்தவும்.

உங்கள் எஜெண்ட் USDC ஐப் பெறுமானால், polling மூலம் அல்ல, webhook மூலம் உறுதிப்படுத்துங்கள். verify உதவியாளர் 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 ஐ பதிலளிக்கவும்.

முதல் ஒருங்கிணைப்பில் கவனிக்க வேண்டிய ஐந்து விஷயங்கள்.

இவை எங்கள் ஆதரவு மின்னஞ்சலிலிருந்து வருகின்றன. இவற்றைப் முன்கூட்டியே தெரிந்து கொண்டால் ஒவ்வொன்றும் ஒரு மணி நேரத்தைச் சேமிக்கிறது.