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.
Четыре измерения. Установите один раз. Применяется повсюду.
Лимит на период
allowance_wei - это общий объем USDC (base units), который agent может отправить за один window period_seconds. Period составляет день (86400), неделю (604800) или 30 days (2592000).
Лимит на транзакцию
per_tx_wei это максимальный размер одного исходящего платежа. Он предотвращает случайный вызов, который переместит больше, чем вы намеревались, независимо от периодического лимита.
Окно действительности
start_at и end_at привязаны, когда разрешение активно. За пределами окна оно не авторизует расходы, поэтому вы можете заранее запланировать бюджет или позволить ему истечь самостоятельно.
Отзыв
revoked_at фиксирует, когда разрешение было отключено с панели управления. Отзыв немедленно устанавливает лимит на ноль для любого платежа, оцененного после этого.
Ключ агента не может увеличить свой собственный лимит.
Вы создаете, изменяете и отзывает разрешения на расходы на панели управления. API предоставляет их только для чтения - нет конечной точки и нет метода SDK, который изменяет разрешение. В этом и заключается суть: если агент подвергся инъекции подсказки или застрял в цикле, он не может расширить свои собственные лимиты, потому что полномочия, которые он имеет, никогда не были предоставлены ему.
Когда платеж превышает активное разрешение, сервер отклоняет его, прежде чем что-либо коснется цепочки. Средства не перемещаются. Ваш агент обрабатывает это отклонение как любой другой неудавшийся вызов, и вы видите попытку на панели управления, чтобы вы могли расширить разрешение, если оно было законным.
Получите текущее разрешение для отображения или планирования вокруг него.
GET /v1/agents/{id}/spend-permissions возвращает актуальные значения. Используйте его, чтобы показать бюджет в вашем интерфейсе или чтобы позволить агенту проверить, сколько места осталось, прежде чем он попытается выполнить платеж.
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_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 равно null для разрешения без срока.
revoked_atNull, пока активно; временная метка после отзыва из панели управления. Отозванное разрешение ничего не авторизует.
День, неделя или 30 дней.
period_seconds принимает одно из трех значений. Лимит сбрасывается, когда период истекает; per_tx_wei применяется к каждому отдельному платежу независимо от периода.
864001 день
6048001 неделя
259200030 дней
Разрешение на расходы - это жесткий лимит, установленный один раз, применяемый повсюду - не рабочий процесс одобрения на каждую оплату и не подтверждение с участием человека. Если вам нужны одобрения или многофакторная подпись, это отдельный, более сложный шаблон; разрешение - это всегда включенный минимум под ним.