പ്രധാന ഉള്ളടക്കത്തിലേക്ക് കടക്കുക
ചെലവിടൽ നിയന്ത്രണങ്ങൾ

Define limits before delegating payment access.

Review how payment limits are evaluated and which paths are covered by enforcement. Set an allowance per period and a per-transaction cap on each agent in the dashboard.

ഡാഷ്ബോർഡ് കാഴ്ച: ഓരോ ഏജന്റിനും ചെലവു അനുമതികൾ - അനുവദനം, ഓരോ ഇടപാടിന്റെ ക്യാപ്, കാലാവധി

സ്വതന്ത്ര ഏജന്റുകൾ തെറ്റുകൾ ചെയ്യുന്നു. അവർ വീണ്ടും ശ്രമിക്കുന്നു. അവർ ലൂപ്പ് ചെയ്യുന്നു. അവർ പ്രോംപ്റ്റ്-ഇൻജക്ട് ചെയ്യപ്പെടുന്നു. അവർ ചിലപ്പോൾ നിങ്ങൾ അനുവദിച്ചിട്ടില്ലാത്ത പണം ചെലവഴിക്കാൻ ശ്രമിക്കുന്നു.

An AgentCredia spend permission is owner-set in the dashboard and enforced by the backend, not by the agent's code. Every outbound payment is checked against the active permission before the API accepts it, so a payment above the limit is rejected even if the agent's logic tries to send it. Your code can read the permission over the API to display it or plan around it, but it cannot raise it.

ഒരു SPEND PERMISSION-ൽ എന്തുണ്ട്

നാല് അളവുകൾ. ഒരിക്കൽ സജ്ജീകരിക്കുക. എല്ലായിടത്തും നടപ്പാക്കുന്നു.

ഒരു കാലയളവിൽ അനുവദനം

allowance_wei ഏജന്റ് ഒരു period_seconds വിൻഡോയിൽ അയക്കാവുന്ന മൊത്തം USDC (ബേസ് യൂണിറ്റ്) ആണ്. കാലാവധി ഒരു ദിവസം (86400), ഒരു ആഴ്ച (604800), അല്ലെങ്കിൽ 30 ദിവസം (2592000) ആണ്.

ഇടപാടിന്റെ പരിമിത

per_tx_wei ഏറ്റവും വലിയ ഏക ഔട്ട്‌ബൗണ്ട് പേയ്മെന്റ് അനുവദനീയമാണ്. ഇത് ഒരു തെറ്റായ വിളി നിങ്ങൾ ഉദ്ദേശിച്ചേക്കാൾ കൂടുതൽ നീങ്ങുന്നത് തടയുന്നു, കാലാവധി അനുവദനീയതയ്ക്ക് സ്വതന്ത്രമായി.

സാധുത വിൻഡോ

permission സജീവമായിരിക്കുന്ന സമയം start_at ഉം end_at ഉം നിർവ്വചിക്കുന്നു. ആ വിൻഡോയ്ക്ക് പുറത്തു അത് spending authorize ചെയ്യില്ല, അതിനാൽ നിങ്ങൾക്ക് budget മുൻകൂട്ടി സജ്ജമാക്കാനോ സ്വയം കാലഹരണപ്പെടാനോ വിടാനോ കഴിയും.

അവകാശം റദ്ദാക്കൽ

dashboard-ിൽ നിന്ന് ഒരു permission ഓഫ് ചെയ്ത സമയമാണ് revoked_at രേഖപ്പെടുത്തുന്നത്. റിവോക്ക് ചെയ്തതിനു ശേഷം വിലയിരുത്തുന്ന ഏതൊരു പേയ്‌മെന്റിനും allowance ഉടൻ zero ആവും.

ഡാഷ്ബോർഡ്-മാനേജഡ്, API വഴി വായന മാത്രം

ഏജന്റിന്റെ കീ അതിന്റെ സ്വന്തം പരിധി ഉയർത്താൻ കഴിയില്ല.

നിങ്ങൾ ഡാഷ്ബോർഡിൽ ചെലവു അനുമതികൾ സൃഷ്ടിക്കുന്നു, മാറ്റുന്നു, പിൻവലിക്കുന്നു. API അവയെ വായന മാത്രം തുറക്കുന്നു - ഒരു അനുമതിയെ മാറ്റുന്ന എന്റ്പോയിന്റ് അല്ലെങ്കിൽ SDK രീതിയില്ല. അതാണ് മുഴുവൻ പോയിന്റ്: ഏജന്റ് പ്രോംപ്റ്റ്-ഇൻജക്ട് ചെയ്താൽ അല്ലെങ്കിൽ ഒരു ലൂപ്പിൽ കുടുങ്ങിയാൽ, അത് തന്റെ സ്വന്തം അനുവദനീയതയെ വ്യാപിപ്പിക്കാൻ കഴിയില്ല, കാരണം അത് കൈവശം വച്ച ക്രെഡൻഷ്യൽ ആ അധികാരം നൽകപ്പെട്ടിട്ടില്ല.

ഒരു പേയ്മെന്റ് സജീവമായ അനുമതിയെ അതിക്രമിക്കുമ്പോൾ, ബാക്ക്‌എൻഡ് അത് നിരസിക്കുന്നു, ഒന്നും ശൃംഖലയെ സ്പർശിക്കുന്നതിന് മുമ്പ്. ഫണ്ടുകൾ നീങ്ങുന്നില്ല. നിങ്ങളുടെ ഏജന്റ് ആ നിരസനത്തെ മറ്റൊരു പരാജയപ്പെട്ട വിളിക്കൊപ്പം കൈകാര്യം ചെയ്യുന്നു, നിങ്ങൾ ഡാഷ്ബോർഡിൽ ശ്രമം കാണുന്നു, അതിനാൽ അത് നിയമാനുസൃതമായിരുന്നെങ്കിൽ നിങ്ങൾ അനുമതി വ്യാപിപ്പിക്കാൻ കഴിയും.

API വഴിയാണ് അത് വായിക്കുക

അത് പ്രദർശിപ്പിക്കാൻ അല്ലെങ്കിൽ അതിനെ ചുറ്റിപ്പറ്റി പദ്ധതിയിടാൻ നിലവിലെ അനുമതി നേടുക.

GET /v1/agents/{id}/spend-permissions ജീവൻ മൂല്യങ്ങൾ തിരികെ നൽകുന്നു. നിങ്ങളുടെ UIയിൽ ഒരു ബജറ്റ് കാണിക്കാൻ ഇത് ഉപയോഗിക്കുക, അല്ലെങ്കിൽ ഏജന്റിന് ഒരു പണമിടപാട് ശ്രമിക്കുന്നതിന് മുമ്പ് എത്ര ഇടം ശേഷിക്കുന്നുവെന്ന് പരിശോധിക്കാൻ അനുവദിക്കുക.

READ (CURL)
curl https://api.agentcredia.com/v1/agents/agt_123/spend-permissions \
  -H "Authorization: Bearer $AGENTCREDIA_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_wei

Total spend allowed per period, in USDC base units (6 decimals). "5000000" is 5 USDC.

per_tx_wei

Largest 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 കാലാവധിയെക്കുറിച്ചുള്ള ഓരോ ഏക പേയ്മെന്റിനും ബാധകമാണ്.

86400

1 ദിവസം

604800

1 ആഴ്ച

2592000

30 ദിവസം

ഒരു ചെലവിടൽ അനുമതി ഒരു കഠിന പരിധിയാണ്, ഒരിക്കൽ ക്രമീകരിച്ചിരിക്കുന്നു, എല്ലായിടത്തും നടപ്പിലാക്കുന്നു - ഒരു പണമടച്ച അംഗീകാരം പ്രവാഹമല്ല, മനുഷ്യൻ-ലൂപ്പിൽ സ്ഥിരീകരണം അല്ല. നിങ്ങൾക്ക് അംഗീകാരം അല്ലെങ്കിൽ ബഹുചിഹ്നം ആവശ്യമുണ്ടെങ്കിൽ, അത് ഒരു വ്യത്യസ്ത, ഭാരമുള്ള മാതൃകയാണ്; അനുമതി എല്ലായിടത്തും പ്രവർത്തിക്കുന്ന നിലയാണ്.

അവലംബമായി ചോദിച്ച

ഓപ്പറേറ്റർമാർ ചോദിക്കുന്ന അഞ്ച് ചെലവു അനുമതി ചോദ്യങ്ങൾ.

ഞാൻ API വഴി ചെലവു അനുമതി ക്രമീകരിക്കുകയോ മാറ്റുകയോ ചെയ്യാമോ?

ഇല്ല. ചെലവുകൾക്കുള്ള അനുമതികൾ API-ൽ വായന മാത്രം ആണ്. നിങ്ങൾ അവയെ AgentCredia ഡാഷ്ബോർഡിൽ സൃഷ്ടിക്കുകയും, മാറ്റുകയും, റിവോക്ക് ചെയ്യുകയും ചെയ്യുന്നു, GET /v1/agents/{id}/spend-permissions നിങ്ങളുടെ കോഡിന് നിലവിലെ മൂല്യങ്ങൾ വായിക്കാൻ അനുവദിക്കുന്നു. ഇത് ഉദ്ദേശ്യമാണ്: ഏജന്റിന്റെ സ്വന്തം API കീ അതിന്റെ സ്വന്തം പരിധികൾ ലഘൂകരിക്കാനാവില്ല, ഏജന്റ് ഒരിക്കലും പ്രോംപ്റ്റ്-ഇൻജക്ട് ചെയ്യപ്പെടുകയോ ലൂപ്പുകൾ ഉണ്ടാക്കുകയോ ചെയ്താൽ നിങ്ങൾക്ക് വേണ്ടത് ആ സ്വഭാവമാണ്. ഒരു അനുവദനം ഉയർത്താൻ നിങ്ങൾക്ക് ഡാഷ്ബോർഡ് ആവശ്യമുണ്ട്.

ഒരു പേയ്മെന്റ് അനുമതിയെ അതിക്രമിക്കുമ്പോൾ എന്താണ് സംഭവിക്കുന്നത്?

ബാക്ക്‌എൻഡ് ഏതെങ്കിലും കാര്യങ്ങൾ ചെയിനിനെ സ്പർശിക്കുന്നതിന് മുമ്പ് അത് നിരസിക്കുന്നു - ഫണ്ടുകൾ നീങ്ങുന്നില്ല. നിർബന്ധിതം ബാക്ക്‌എൻഡിൽ ജീവിക്കുന്നു, നിങ്ങളുടെ ഏജന്റിന്റെ കോഡിൽ അല്ല, അതിനാൽ ഏജന്റ് അതിനെ ചുറ്റി പോകാൻ കഴിയില്ല, അതിന്റെ തർക്കം ശ്രമിച്ചാലും. GET മാർഗം ഉപയോഗിച്ച് അനുമതി വായിക്കുക, നിങ്ങളുടെ ഏജന്റിന് എത്ര സ്ഥലമാണ് ബാക്കി എന്ന് കാണിക്കുക, payments.create-ൽ നിന്ന് നിരസിക്കൽ കൈകാര്യം ചെയ്യുക, നിങ്ങൾ മറ്റ് പരാജയപ്പെട്ട വിളികളെ കൈകാര്യം ചെയ്യുന്ന രീതിയിലാണ്.

തുകകൾ ഡോളറുകളിലേക്കു പകരം വെയിൽ എങ്ങനെ ആണ്?

Consistency with the rest of the API: every amount is a base-unit string. USDC has 6 decimals, so allowance_wei "5000000" is 5 USDC and per_tx_wei "1000000" is 1 USDC. Strings, not floats - large integers lose precision as JSON numbers, and a base-unit string is unambiguous across languages.

ചെലവു അനുമതികൾ വരവേൽപ്പു പണമടച്ചുകൾ പരിമിതപ്പെടുത്തുമോ?

ഇല്ല. ഒരു അനുമതി വാലറ്റിൽ നിന്ന് പണം പുറപ്പെടുന്നതിനെ മാത്രം നിയന്ത്രിക്കുന്നു. Incoming USDC അതിൽ നിന്ന് തടയപ്പെടുന്നില്ല - ആരും നിങ്ങളുടെ ഏജന്റിന് എപ്പോഴും പണമടയ്ക്കാൻ കഴിയും. അനുമതിയെ പുറത്ത് ചെലവാക്കുന്ന ഒരു ദിശാ വാൽവായി കരുതുക; Incoming സെറ്റിൽമെന്റ് payment.received വെബ് ഹുക്ക് വഴി വേർതിരിച്ചാണ് സ്ഥിരീകരിക്കുന്നത്.

എന്തെങ്കിലും തെറ്റായതായി തോന്നുമ്പോൾ ഞാൻ ചെലവഴിക്കൽ എങ്ങനെ വേഗത്തിൽ പിൻവലിക്കും?

ഡാഷ്ബോർഡിൽ അനുമതി റദ്ദാക്കുക - ഇത് revoked_at സജ്ജീകരിക്കുന്നു, തുടർന്ന് വിലയിരുത്തിയ ഏതെങ്കിലും പേയ്മെന്റിന് അനുവദനീയത zero-ലേക്ക് കൊണ്ടുപോകുന്നു. കൂടുതൽ കഠിനമായ നിർത്തലാക്കാൻ, ഏജന്റിന്റെ API കീ (apiKeys.rotate / apiKeys.revoke) മാറ്റുകയോ റദ്ദാക്കുകയോ ചെയ്യാം, ഇത് ക്രെഡൻഷ്യലിനെ മുഴുവൻ മുടക്കുന്നു. ഇരുവരും ഉടൻ സംഭവിക്കുന്നു; അനുമതി റദ്ദാക്കൽ ശസ്ത്രക്രിയയാണെന്ന്, കീ റദ്ദാക്കൽ കിൽ സ്വിച്ച് ആണ്.

അപ്രതീക്ഷിതങ്ങളല്ല, പരിധികളോടെ ചെലവിടുക.

ഡാഷ്ബോർഡിൽ ഒരു അനുവദനീയതയും ഒരു ഇടപാടിൽ ക്യാപ് സജ്ജീകരിക്കുക. ബാക്ക്‌എൻഡ് ശേഷിയുള്ളതും.