ActionIntent

ActionIntent - это нормализованное описание действия с активами до его исполнения.

Если ИИ-агент хочет отправить TON, USDT, USDC, сделать перевод, подготовить swap или выполнить другое действие с value-moving эффектом, raw-команды агента недостаточно. До исполнения системе нужно понять, что именно агент собирается сделать, с каким активом, на какую сумму, для кого, в каком контексте и по каким правилам это действие должно быть проверено.

ActionIntent решает эту задачу. Он превращает намерение агента в структурированный объект, который можно проверить до того, как кошелёк, бот, Mini App или компонент исполнения подпишет и выполнит действие.

Зачем нужен ActionIntent

ИИ-агент может формулировать действие по-разному:

отправь 25 USDT этому пользователю;
оплати инвойс;
сделай swap;
пополни баланс;
переведи средства на treasury wallet;
верни пользователю депозит.

Для человека эти команды могут выглядеть понятными. Для системы контроля они слишком размыты.

Перед исполнением нужно отделить:

что агент хочет сделать;
какой актив участвует в действии;
какая сумма или лимит используется;
кто инициатор;
кто получатель;
где будет исполнение;
какой business context стоит за действием;
какие политики должны применяться;
нужно ли действие разрешить, отправить на проверку, приостановить или заблокировать.

ActionIntent делает это описание явным.

Простая схема

AI agent

-> ActionIntent

-> контроль до исполнения

-> allow / review / hold / block

-> кошелёк / компонент исполнения

ИИ-агент готовит намерение. Слой контроля проверяет это намерение. Кошелёк, бот, Mini App или компонент исполнения остаются владельцами подписи, хранения активов и исполнения.

Что может входить в ActionIntent

Минимальный ActionIntent может включать:

{

"action_type": "transfer",

"asset": "USDT",

"network": "TON",

"amount": "25.00",

"recipient": "wallet_or_user_id",

"initiator": "ai_agent_id",

"context": "refund",

"execution_surface": "telegram_bot"

}

В более зрелой схеме могут добавляться:

лимиты;
user segment;
merchant или project id;
invoice id;
reason code;
device или session context;
policy hints;
historical signals;
risk signals;
expected execution window;
human approval metadata.

Важно, что ActionIntent не обязан быть transaction object. Это не подпись, не blockchain transaction и не платежная инструкция в юридическом смысле. Это слой описания намерения до исполнения.

Чем ActionIntent отличается от transaction

Transaction описывает то, что будет отправлено в слой исполнения или блокчейн.

ActionIntent описывает то, что агент хочет сделать до исполнения.

Разница важна:

| Слой | Что описывает | Кто владеет |

| --- | --- | --- |

| ActionIntent | намерение действия | AI agent / orchestration layer |

| Контрольная проверка | решение до исполнения | слой контроля |

| Transaction | техническое исполнение | кошелёк / компонент исполнения |

| Signature | подтверждение действия | кошелёк / слой хранения активов |

| Settlement | финальное движение средств | network / payment rail |

Такой разрез помогает не смешивать контроль и исполнение.

Где находится слой контроля

Слой контроля находится между намерением агента и фактическим исполнением.

Он не обязан хранить средства, подписывать транзакции, быть кошельком или процессингом. Его задача - принять ActionIntent, проверить его по правилам и вернуть решение:

allow - действие можно продолжить;
review - требуется проверка человеком или заранее заданным процессом;
hold - действие нужно временно приостановить;
block - действие нельзя исполнять.

После этого кошелёк или компонент исполнения решает, как технически применить результат.

Почему это важно для TON и Telegram

В Telegram-native сценариях ИИ-агент может быть близко к пользователю: в чате, Mini App, bot flow или wallet interface.

Это удобно, но создает новый класс вопросов:

кто проверяет действие до отправки средств;
как отличить обычный перевод от подозрительного;
как задать лимиты для агента;
как показать audit trail;
как остановить действие до подписи;
как не превращать ИИ-агента в бесконтрольный слой исполнения.

ActionIntent дает общий язык для таких сценариев. Он позволяет описывать действия с TON, USDT, USDC и другими активами до того, как начинается execution-heavy часть.

Что остаётся за кошельком / компонентом исполнения

Кошелёк, бот, Mini App или компонент исполнения по-прежнему отвечают за:

хранение активов;
подпись;
хранение ключей;
формирование transaction payload;
отправку транзакции;
работу с blockchain или payment rail;
пользовательский интерфейс подтверждения;
техническое исполнение.

Слой контроля не должен подменять эти части. Он проверяет намерение до исполнения и возвращает решение.

Граница ответственности

ActionIntent полезен именно потому, что задает границу между AI orchestration, control и execution.

AI agent формирует намерение.

Слой контроля проверяет намерение.

Кошелёк или компонент исполнения исполняет действие, если это допустимо.

Такой подход особенно важен для agentic wallets, Telegram-native AI payment actions и других систем, где AI может инициировать value-moving действия, но не должен становиться бесконтрольным исполнителем.