Agno கட்டண ஒருங்கிணைப்பு.
Agno தொகுப்பு இல்லை, மற்றும் நீங்கள் ஒன்றை தேவைப்படவில்லை. உண்மையான blockchain0x கிளையைக் ஒரு சிறிய Toolkit இல் சுற்றி வைத்து உங்கள் முகவர் Base இல் USDC ஐ நகர்த்த முடியும் - குறைந்த அளவிலான அப்ஸ்ட்ராக்ஷன், Agno வழி.
Agno-specific package எதுவும் இல்லை, மேலும் உங்களுக்கு அது தேவையுமில்லை. Agno ஒரு method-ஐ tool-ஆக மாற்றுகிறது, ஆகவே உண்மையான Python client-ஐ ஒரு சிறிய toolkit-இல் wrap செய்து உங்கள் -க்கு சேர்க்கலாம். Agent USDC அனுப்பவும், invoices-ஐ settle செய்யவும், wallets-ஐ read செய்யவும் முடியும், எல்லா Agno model-களிலும் (OpenAI, Anthropic, DeepSeek, Llama, Mistral). Payments Base-இல் settle ஆகும்.
எளிதான Python கட்டமைப்பு. எந்த அப்ஸ்ட்ராக்ஷன் வரி இல்லை.
Agno (முந்தைய Phidata) என்பது நீங்கள் குறைந்த அளவிலான விழாக்களை விரும்பும் போது நீங்கள் அணுகும் ஏஜென்ட் கட்டமைப்பு. கிராஃப் கட்டுப்படுத்தி இல்லை, குழு இல்லை, வேலைப்பாடு இல்லை - Agent, Tools மற்றும் run() முறை மட்டுமே. கருவிகள் Python அழைப்புகள். கட்டமைப்பு LLMகளை கருவி ஆதரவுடன் அழைக்க, நினைவகத்தை நிர்வகிக்க மற்றும் ஸ்ட்ரீமிங் வெளியீட்டை உருவாக்க தேவையான அளவுக்கு scaffolding ஐச் சேர்க்கிறது, பிறகு உங்கள் வழியில் இருந்து வெளியேறுகிறது.
செய்முறை ஒரே தத்துவத்தை பின்பற்றுகிறது. நீங்கள் உண்மையான கிளையனை அழைக்கும் ஒரு முறையை பதிவு செய்யும் ஒரு சிறிய Toolkit துணை வகையை எழுதுகிறீர்கள் - இது மற்ற அனைத்து Agno கருவிகளால் போலவே தோன்றுகிறது மற்றும் செயல்படுகிறது. உருவாக்கத்திற்குப் பிறகு எந்த சிறப்பு அமைப்பும் இல்லை, இணைக்க ஒரு வரைபடம் இல்லை, கண்காணிக்க எந்த இணைப்புப் பதிப்பு இல்லை. எளிமை என்பது நோக்கம்: நீங்கள் வரைபடங்களை விரும்பினால், நீங்கள் LangGraph இல் இருக்க வேண்டும்.
Agno மற்றும் மைய SDK ஐ நிறுவவும். இரண்டு விசைகள்.
சேர்க்க blockchain0x Agno தொகுப்பு இல்லை. நீங்கள் Agno ஐ (Python 3.10+, Phidata மறுபெயரிடத்திற்குப் பிறகு 1.0+ வரி) மற்றும் உண்மையான blockchain0x மைய SDK ஐ நிறுவுகிறீர்கள், பிறகு கீழே உள்ள கருவிகளை எழுதுகிறீர்கள். நீங்கள் இன்னும் phi.* இறக்குமதிகளில் இருந்தால், முதலில் pip install -U agno ஐ இயக்கவும்.
pip install agno blockchain0xexport OPENAI_API_KEY=sk-... export BLOCKCHAIN0X_API_KEY=sk_test_... # sk_test_ = Base Sepolia, sk_live_ = Base mainnet
OPENAI_API_KEY (அல்லது நீங்கள் பயன்படுத்தும் எந்த Agno-supported model-னின் சமமான key). BLOCKCHAIN0X_API_KEY என்பது உங்கள் dashboard-இல் உள்ள sk_test_ testnet அல்லது sk_live_ mainnet key; client அதை environment-இலிருந்து வாசிக்கிறது. உங்கள் agent பணத்தையும் பெறுமானால், webhook handler-க்கு கூடுதலாக BLOCKCHAIN0X_WEBHOOK_SECRET தேவைப்படும்.
ஒரு Toolkit, செலுத்தும், ஒரு முகவருக்கு வழங்கப்படுகிறது.
கீழே முழு ஒருங்கிணைப்பு உள்ளது. WalletTools என்பது send_usdc ஐ பதிவு செய்யும் Toolkit துணை வகை, இது உண்மையான blockchain0x கிளையினை அழைக்கிறது. அதை முகவருக்கு சேர்க்கவும், run() அழைப்பு கருவி அழைப்பை ஒழுங்குபடுத்துகிறது. Agno முறையின் கையொப்பம் மற்றும் ஆவணத்தைப் படிக்கிறது, வடிவமைப்பை உருவாக்குகிறது.
from agno.agent import Agent from agno.models.openai import OpenAIChat from agno.tools import Toolkit from blockchain0x import Client blockchain0x = Client() # reads BLOCKCHAIN0X_API_KEY from the environment # Wrap the real client in an Agno Toolkit. No dedicated package needed. class WalletTools(Toolkit): def __init__(self): super().__init__(name="wallet_tools") self.register(self.send_usdc) def send_usdc(self, agent_id: str, to: str, amount_wei: str) -> str: """Send a USDC payment from an agent wallet. amount_wei is USDC base units (6 decimals), so "10000" is 0.01 USDC. """ return str( blockchain0x.payments.create(body={"agentId": agent_id, "to": to, "amountWei": amount_wei}) ) agent = Agent( model=OpenAIChat(id="gpt-4o"), tools=[WalletTools()], instructions=["You pay vendor invoices in USDC within owner-set limits."], ) result = agent.run("Pay 0.01 USDC from agent agt_123 to 0xVendor for the dataset.") print(result.content)
When agent.run() executes, the model decides to pay, calls send_usdc, the SDK submits the transfer, and you get a transaction hash back. amount_wei is base units, so 0.01 USDC is "10000". A sk_test_ key keeps it on Base Sepolia until you switch to sk_live_. Register more methods on the toolkit - read a wallet, settle an invoice - the same way.
ஒரு கையொப்பம் செய்யப்பட்ட 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 ஐ பதிலளிக்கவும்.
நீங்கள் சுற்றி வைக்கும் கிளையன் திறந்தது. அதைப் படிக்கவும்.
Clone செய்ய Agno starter package இல்லை - மேலே உள்ள recipe-தான் integration. blockchain0x SDKs GitHub-இல் open source ஆக உள்ளன; இந்த recipe Python SDK (blockchain0x-python)-ஐ wrap செய்கிறது, முழு method surface docs-இல் உள்ளது. toolkit methods-க்கு reference ஆக அதை வாசிக்கவும்.
github.com/tosh-labs/blockchain0x-pythonமுழு SDK method surface மற்றும் scopes ஆகியவை the docs இல் ஆவணப்படுத்தப்பட்டுள்ளன. Base Sepolia-வில் sk_test_ key-யுடன் தொடங்கி, பின்னர் toolkit நீங்கள் எதிர்பார்த்ததைச் செய்ததும் sk_live_ க்கு மாற்றவும்.
காண வேண்டிய ஐந்து Agno-சிறப்பு விஷயங்கள்.
Agno இணைக்க மிகவும் சுத்தமான ஏஜென்ட் கட்டமைப்புகளில் ஒன்றாகும், ஆனால் இது தனது சொந்த சிக்கல்களை கொண்டுள்ளது - குறிப்பாக Phidata மறுபெயரிடுதல் மற்றும் மார்க்டவுன் உருவாக்கம்.
Agno தொகுப்பு இல்லை - நீங்கள் SDK ஐ Toolkit இல் சுற்றி வைத்திருக்கிறீர்கள்
Blockchain0x LangChain மற்றும் CrewAI க்கான அடாப்டர்களை மற்றும் MCP சேவையகத்தை அனுப்புகிறது; தனிப்பட்ட Agno தொகுப்பு இல்லை. மேலே உள்ள செய்முறை பாதை: உண்மையான blockchain0x கிளையண்டை அழைக்கும் முறையை பதிவு செய்யும் Toolkit துணை வகை. Agno முறையின் கையொப்பம் மற்றும் ஆவணத்தை வாசித்து கருவியின் வடிவமைப்பை உருவாக்குகிறது, எனவே ஆவணத்தை சரியானதாக வைத்திருக்கவும்.
Phidata to Agno இடமாற்ற குழப்பம்
Agno 2024 இல் Phidata இல் இருந்து பெயரிடப்பட்டது. phi.agent அல்லது phi.tools இல் இருந்து இறக்குமதி செய்யும் பழைய குறியீட்டு அடிப்படைகள் இன்னும் ஒத்திகை ஷிமின் மூலம் வேலை செய்கின்றன, ஆனால் agno.* இறக்குமதிகள் தற்போதையவை. செய்முறை முழுவதும் agno.* ஐப் பயன்படுத்துகிறது; உங்கள் குறியீடு இன்னும் phi.* இறக்குமதியில் இருந்தால், pip install -U agno ஐ இயக்கவும் மற்றும் Toolkit ஐச் சேர்க்கும் முன் இறக்குமதி பாதைகளை மாற்றவும்.
தொகைகள் USDC அடிப்படைக் அலகுகள், உரையாக
payments.create takes amountWei: a string of USDC base units (6 decimals), so 0.01 USDC is "10000" and 5 USDC is "5000000". Type the method argument as str. It also does not retry by default and can answer 503 until the chain adapter is wired for your network - return a clear message rather than letting the agent loop.
சேமிப்பு vs அசிங்க் இயக்கம்
Agno agent.run() (sync) மற்றும் agent.arun() (async) ஐ ஆதரிக்கிறது. ஒவ்வொரு முகவருக்கும் ஒரு முறை தேர்ந்தெடுக்கவும் - agent.run() ஐ அழைக்கவும் மற்றும் முடிவை எதிர்பார்க்க முயற்சிக்கவும், நீங்கள் ஒரு சரிசெய்யும் இடத்தில் ஒரு சரம் எதிர்பார்த்தீர்கள். Toolkit இல் உள்ள blockchain0x அழைப்பு ஒத்திசைவு ஆக உள்ளது; நீங்கள் async பாதையில் இருக்கிறீர்கள் மற்றும் உண்மையான அளவுகளை நகர்த்துகிறீர்கள் என்றால், அதை asyncio.to_thread உடன் சுற்றி வைக்கவும், எனவே நிகழ்வு சுற்று பதிலளிக்கக்கூடியதாக இருக்கும்.
மூல உடலுக்கு எதிராக வெப்கோக்களை சரிபார்க்கவும்
உங்கள் எஜெண்ட் USDC ஐப் பெறுமானால், polling மூலம் அல்ல, webhook மூலம் உறுதிப்படுத்துங்கள். RAW கோரிக்கையின் பைட்டுகளின் மீது கையொப்பத்தைச் சரிபார்க்கவும் (await request.body()), request.json() மறுபடியும் வரிசைப்படுத்தாதீர்கள், ஏனெனில் HMAC சரியான பைட்டுகளை மூடுகிறது. இது 300-வினாடி மறுபடியான ஜன்னலுடன் HMAC-SHA256 ஆகும். கீழே உள்ள கையாளி முழுமையாக உள்ளது.