Add supported payment workflows to CrewAI.

AgentCredia ஒரு உண்மையான Python package-ஐ, , வழங்குகிறது. அதை install செய்து, ஐ set செய்து, ஐ call செய்து, tools-ஐ ஒரு dedicated treasurer agent-க்கு கொடுங்கள். அந்த agent USDC அனுப்பலாம், on-chain proof உடன் invoice-ஐ settle செய்யலாம், மற்றும் wallets-ஐ படிக்கலாம், ஆனால் crew-இல் உள்ள work agents-க்கு wallet access எதுவும் இருக்காது. USDC Base-ல் settle ஆகும்.

ஒரு பிப் நிறுவல். ஒரு சுற்றுப்புற மாறி.

தொகுப்பு Python 3.10 அல்லது புதியதாக இருக்க வேண்டும் மற்றும் கவிதை அல்லது pip உடன் வேலை செய்கிறது. இது அடிப்படை agentcredia SDK மற்றும் crewai ஐ சார்ந்ததாகக் கொண்டுள்ளது; மேலும் எதுவும் சேர்க்க வேண்டாம்.

pip install agentcredia-crewai

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

AGENTCREDIA_API_KEY என்பது உங்கள் AgentCredia dashboard-இல் உள்ள sk_test_ testnet அல்லது sk_live_ mainnet key ஆகும், மேலும் adapter-க்கு தேவைப்படும் ஒரே மாறி அதுவே - அது key-ஐ backend-க்கு அனுப்புகிறது மற்றும் தனியாக எந்த secret-ஐயும் வைத்திருக்காது. கீழே உள்ள webhook handler-க்கு நீங்கள் AGENTCREDIA_WEBHOOK_SECRET-ஐயும் அமைக்க வேண்டும், webhook-ஐ create அல்லது rotate செய்யும் போது dashboard அதை ஒருமுறை வழங்கும்.

ஒரு பணம் இறங்கும் போது அடுத்த குழுவை செயல்படுத்துதல்.

USDC உங்கள் முகவரிக்கு நிலைநிறுத்தும் போது, AgentCredia உங்கள் வெப்கோக் URL க்கு ஒரு கையொப்பமிடப்பட்ட நிகழ்வை POST செய்கிறது. சரிபார்க்கும் உதவியாளர் Node SDK இல் அனுப்பப்படுகிறது; ஒரு Python சேவை ஆவணப்படுத்தப்பட்ட HMAC க்கு எதிராக கைமுறையாக சரிபார்க்கிறது, இது உதவியாளர் எதுவும் செய்கிறது. கீழே உள்ள Flask எடுத்துக்காட்டு; அதே குறியீடு FastAPI அல்லது எந்த Python வலை கட்டமைப்பிலும் வேலை செய்கிறது.

import hmac, hashlib, os, time
from flask import Flask, request, abort

app = Flask(__name__)
SECRET = os.environ["AGENTCREDIA_WEBHOOK_SECRET"].encode()

@app.post("/webhooks/payment")
def receive():
    raw = request.get_data()  # RAW bytes - do not parse first
    sig = request.headers.get("X-AgentCredia-Signature", "")
    ts = request.headers.get("X-AgentCredia-Timestamp", "")
    # Header is "t=<unix>,v1=<hex>"; some proxies send bare hex + the ts header.
    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:
        abort(401)
    if request.headers.get("X-AgentCredia-Event-Type") == "payment.received":
        run_followup_for(request.get_json())  # USDC landed - do the work
    return "ok", 200

இது உண்மையான அல்காரிதம்: HMAC-SHA256 t.rawBody என்ற சரத்திற்கேற்ப, ஒரு நிலையான நேர ஒப்பீடு, மற்றும் 300-செகண்ட் மீண்டும் விளையாட்டு ஜன்னல். கச்சா உடலைப் படிக்கவும் (request.get_data()), request.get_json() மறுபடியும்-சீரமைக்காதீர்கள், ஏனெனில் அது கையொப்பம் மூடுகிற பைட்டுகளை மாற்றுகிறது. கட்டமைப்பு: கைப்பற்றலுக்கு ஒரு வேலை (Celery, RQ, Redis பட்டியல்) enqueue செய்யவும், இது CrewAI ஐ உண்மையாக இயக்குகிறது. கைப்பற்றலில் crew.kickoff() ஐ அழைப்பது சில நிமிடங்கள் எடுக்கலாம் மற்றும் HTTP கோரிக்கையை நேரம் முடிக்கலாம்.

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

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