ДокументацияСправочник APIБаза знаний

# ActionIntent

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

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

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

Зачем нужен ActionIntent

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

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

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

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

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

AI agent

-> ActionIntent

-> control check

-> allow / review / hold / block

-> wallet / executor

AI-агент готовит намерение. Control layer проверяет это намерение. Wallet, bot, Mini App или executor остаются владельцами подписи, custody и исполнения.

Что может входить в 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"

}

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

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

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

Transaction описывает то, что будет отправлено в execution layer или blockchain.

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

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

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

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

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

| Control check | решение до исполнения | control layer |

| Transaction | техническое исполнение | wallet / executor |

| Signature | подтверждение действия | wallet / custody layer |

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

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

Где находится control layer

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

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

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

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

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

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

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

Что остается за wallet / executor

Wallet, bot, Mini App или executor по-прежнему отвечают за:

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

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

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

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

Control layer проверяет намерение.

Wallet или executor исполняет действие, если это допустимо.

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

Связанные материалы