> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Разовые команды и профили

> Интерактивный SSH, фиксированные команды агента и ad hoc shell: права, предпросмотр, вывод и остановка.

В Telepúrte несколько способов выполнить команду. Выбирайте по задаче и нужной модели доступа: интерактивный терминал, повторяемый плейбук, разрешённый профиль агента или разовый shell.

| Способ | Подходит для | Особенности |
| - | - | - |
| Web SSH / SSH-клиент | Интерактивная диагностика | Терминал, системная учётка, запись сессии |
| Скриптовый плейбук | Повторяемая работа и расписание | Версия скрипта, входные файлы, окружение |
| Фиксированный профиль агента | Узкая заранее разрешённая команда | Точные бинарник, аргументы и срок |
| Ad hoc агента | Разовая произвольная shell-команда | Нужны специальное разрешение и профиль `adhoc` |
| SSH-команда через MCP | Неинтерактивный вызов через бастион | Права OAuth и существующий SSH-доступ |

## Фиксированный профиль

Администратор ноды задаёт профиль локально у агента. Пример фрагмента конфигурации отдельного Telepúrte Agent:

```json theme={null}
{
  "command_profiles": [
    {
      "id": "status",
      "executable": "/usr/bin/uptime",
      "args": [],
      "timeout_seconds": 5
    }
  ]
}
```

Это дополнение существующего файла, не замена всей конфигурации. После изменения проверьте конфигурацию, перезапустите агент и дождитесь обновления его состояния в панели.

Оператор выбирает профиль, но не подставляет произвольные аргументы. На всех целях массового запуска профиль с этим ID должен иметь одинаковые бинарник, аргументы и срок. Исполняемый файл должен существовать и не быть доступным на запись посторонним.

Профиль интерпретатора или универсальной обёртки фактически расширяет возможности гораздо сильнее, чем профиль `uptime`. Не используйте такое разрешение в роли «только состояние».

## Права и запуск

Для оператора требуется разрешение на конкретный профиль и ноду; обычный SSH-грант и право на типизированную операцию не заменяют его. Локальная политика агента также обязательна.

Контракт управляемых команд доступен через API `/api/v1/commands`: сначала `previews`, затем `runs` с ID предпросмотра. Предпросмотр показывает точный профиль, параметры, цели и партии. Он не выполняет команду. Массовый запуск поддерживает канарейку, размер партии и порог ошибок.

Если профиль, политика или права изменились, сформируйте новый предпросмотр. Сохраните ID запуска и проверяйте результаты каждой цели, а не повторяйте запрос с новым ID при непонятном сетевом сбое.

## Произвольный shell агента

Для ad hoc режима на ноде явно разрешают профиль `adhoc` с `/bin/sh` и пустыми аргументами. Он выполняет переданный текст через shell; сам факт появления профиля не выдаёт право пользователю.

Этот режим не интерактивный: stdin закрыт, рабочий каталог начинается с `/`, окружение и текущий каталог не сохраняются между запусками. Срок профиля ограничен 30 секундами, текст команды — 1 МиБ. Для долгой повторяемой работы используйте [скриптовый плейбук](https://docs.axottle.com/ru/telepurte/scripts.md), для интерактивной — терминал.

## Вывод и неопределённый результат

Агент сохраняет до 4096 байт совокупного stdout/stderr. В результате есть код завершения, контрольная сумма и признак обрезки. Если вывод обрезан, остальная часть не появится при повторном чтении того же результата.

Потеря подтверждения изменяющего запуска даёт `execution_uncertain`; автоматического повтора команды нет. Проверьте фактическое состояние ноды. Чтение сохранённого вывода не выполняет команду повторно и фиксируется в аудите.

## Запрет и остановка

Администратор может запретить профиль на одной ноде или во всей установке. Запрет действует поверх разрешений, в том числе при выдаче ожидающего задания агенту. Уже выданная команда может закончиться.

Остановка запуска прекращает будущую выдачу; она не равна отправке `Ctrl-C` уже работающему процессу. Запрет профиля не фильтрует команды внутри интерактивного SSH и не блокирует автоматически другие способы выполнения.

## Проверка

Начните с читающего профиля `status` на одной ноде. Проверьте точный профиль в предпросмотре, код завершения, вывод и аудит. Для нескольких нод сравните определения профиля и их политики до запуска.

## Откат

Отзовите грант, удалите ненужный профиль из локальной политики или установите запрет, затем дождитесь обновления состояния агента. Изменения, выполненные командой, возвращаются отдельно; отключение профиля их не отменяет.

Расширенные параметры, обозначенные как API, могут отсутствовать в текущей форме интерфейса.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.