আপনার এজেন্ট আপনি যা সেট করেছেন তার বেশি ব্যয় করতে পারে না।
ড্যাশবোর্ডে প্রতিটি এজেন্টের জন্য একটি ভাতা এবং একটি প্রতি লেনদেনের সীমা সেট করুন। ব্যাকএন্ড এটি প্রতিটি আউটবাউন্ড পেমেন্টে কার্যকর করে - এজেন্টের কোড এটি বাইপাস করতে পারে না।
স্বায়ত্তশাসিত এজেন্টগুলি ভুল করে। তারা পুনরায় চেষ্টা করে। তারা লুপ করে। তারা প্রম্পট-ইনজেক্ট হয়। তারা মাঝে মাঝে এমন অর্থ খরচ করার চেষ্টা করে যা আপনি অনুমোদন করেননি।
একটি Blockchain0x খরচ অনুমতি ড্যাশবোর্ডে মালিক দ্বারা সেট করা হয় এবং ব্যাকএন্ড দ্বারা কার্যকর করা হয়, এজেন্টের কোড দ্বারা নয়। প্রতিটি আউটবাউন্ড পেমেন্ট সক্রিয় অনুমতির বিরুদ্ধে পরীক্ষা করা হয় API এটি গ্রহণ করার আগে, তাই এজেন্ট তার যুক্তি চেষ্টা করলেও সীমা অতিক্রম করতে পারে না। আপনার কোড API এর মাধ্যমে অনুমতিটি পড়তে পারে এটি প্রদর্শন করতে বা এর চারপাশে পরিকল্পনা করতে, কিন্তু এটি বাড়াতে পারে না।
চারটি মাত্রা। একবার সেট করুন। সর্বত্র প্রয়োগ করা হয়।
একটি সময়ের জন্য বরাদ্দ
allowance_wei হল মোট USDC (বেস ইউনিট) যা এজেন্ট একটি period_seconds উইন্ডোর মধ্যে পাঠাতে পারে। সময়কাল হল এক দিন (86400), এক সপ্তাহ (604800), বা 30 দিন (2592000)।
প্রতি-লেনদেনের সীমা
per_tx_wei হল সর্বাধিক একক আউটবাউন্ড পেমেন্ট যা অনুমোদিত। এটি একটি ভুল কলকে আপনার উদ্দেশ্যের চেয়ে বেশি স্থানান্তর করতে বাধা দেয়, সময়সীমা অনুমতির স্বাধীন।
বৈধতা উইন্ডো
start_at এবং end_at যখন অনুমতি সক্রিয় থাকে তখন বেঁধে থাকে। জানালার বাইরে এটি ব্যয় অনুমোদন করে না, তাই আপনি একটি বাজেট প্রি-স্টেজ করতে পারেন বা একটি স্বয়ংক্রিয়ভাবে মেয়াদ শেষ হতে দিতে পারেন।
অবসান
revoked_at রেকর্ড করে যখন একটি অনুমতি ড্যাশবোর্ড থেকে বন্ধ করা হয়। এটি যে কোনো পেমেন্টের জন্য অনুমতি তাত্ক্ষণিকভাবে শূন্যে নিয়ে যায় যা এর পরে মূল্যায়ন করা হয়।
এজেন্টের কী তার নিজস্ব সীমা বাড়াতে পারে না।
আপনি ড্যাশবোর্ডে ব্যয় অনুমতি তৈরি, পরিবর্তন এবং বাতিল করেন। API সেগুলি পড়ার জন্য উন্মুক্ত করে - কোন এন্ডপয়েন্ট এবং কোন SDK পদ্ধতি নেই যা অনুমতিকে পরিবর্তন করে। এটি পুরো বিষয়: যদি এজেন্টটি প্রম্পট-ইনজেক্টেড বা একটি লুপে আটকে থাকে, তবে এটি তার নিজস্ব বরাদ্দ বাড়াতে পারে না, কারণ এটি ধারণ করে এমন ক্রেডেনশিয়ালটি কখনও সেই ক্ষমতা দেওয়া হয়নি।
যখন একটি পেমেন্ট সক্রিয় অনুমতি অতিক্রম করবে, ব্যাকএন্ডটি এটি প্রত্যাখ্যান করে আগে কিছু চেইনে স্পর্শ করে। কোন তহবিল স্থানান্তরিত হয় না। আপনার এজেন্ট সেই প্রত্যাখ্যানটি অন্য কোন ব্যর্থ কলের মতো পরিচালনা করে, এবং আপনি ড্যাশবোর্ডে প্রচেষ্টাটি দেখতে পান যাতে আপনি যদি এটি বৈধ হয় তবে অনুমতি বাড়াতে পারেন।
এটি প্রদর্শন বা এর চারপাশে পরিকল্পনা করার জন্য বর্তমান অনুমতি আনুন।
GET /v1/agents/{id}/spend-permissions লাইভ মান ফেরত দেয়। এটি আপনার UI তে একটি বাজেট দেখাতে ব্যবহার করুন, অথবা এজেন্টকে পরীক্ষা করতে দিন কতটা জায়গা বাকি আছে আগে এটি একটি পেমেন্ট করার চেষ্টা করে।
curl https://api.blockchain0x.com/v1/agents/agt_123/spend-permissions \
-H "Authorization: Bearer $BLOCKCHAIN0X_API_KEY"{
"allowance_wei": "5000000",
"per_tx_wei": "1000000",
"period_seconds": 86400,
"start_at": "2026-05-15T00:00:00Z",
"end_at": null,
"revoked_at": null
}allowance_weiTotal spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.
per_tx_weiLargest single payment allowed, in base units. "1000000" is 1 USDC. A payment over this is rejected even if the period allowance has room.
period_secondsযে উইন্ডোতে অনুমতি প্রযোজ্য: 86400 (দিন), 604800 (সপ্তাহ), অথবা 2592000 (30 দিন)।
start_at / end_atযখন অনুমতি সক্রিয় থাকে। end_at একটি খোলামেলা অনুমতির জন্য শূন্য।
revoked_atসক্রিয় থাকা অবস্থায় শূন্য; ড্যাশবোর্ড থেকে বাতিল হওয়ার পরে একটি টাইমস্ট্যাম্প। একটি বাতিল অনুমতি কিছুই অনুমোদন করে না।
দিন, সপ্তাহ, বা 30 দিন।
period_seconds তিনটি মানের মধ্যে একটি নেয়। সময়সীমা ঘূর্ণন করলে অনুমতি পুনরায় সেট হয়; per_tx_wei প্রতিটি একক পেমেন্টে প্রযোজ্য, সময়সীমা নির্বিশেষে।
864001 দিন
6048001 সপ্তাহ
259200030 দিন
একটি খরচ অনুমতি একটি কঠোর সীমা, একবার সেট করা হয়, সর্বত্র কার্যকর হয় - এটি একটি প্রতি-পেমেন্ট অনুমোদন কাজপ্রবাহ নয় এবং এটি একটি মানব-লুপ নিশ্চিতকরণ নয়। যদি আপনার অনুমোদনের প্রয়োজন হয় বা বহু-স্বাক্ষর হয়, তবে এটি একটি আলাদা, ভারী প্যাটার্ন; অনুমতি সর্বদা চালু মেঝে।