# Запустить агента из сценария

> Требуемое право: text.

`POST https://api.kvantora.ai/v1/agent-runs`

Требуемое право: text. Только изнутри запущенного сценария Kvantora Flow: нужны заголовки X-Kvantora-Automation-Run и Idempotency-Key. Запуск асинхронный; результат читайте по resultUrl. Повтор с тем же Idempotency-Key и тем же телом возвращает тот же запуск (200), другое тело с тем же ключом — 409 idempotency_mismatch. Предел стоимости max_cost_microrub обязателен.

## Параметры

- `Idempotency-Key` (header, обязательный): Один стабильный ключ на логический запуск агента.
- `X-Kvantora-Automation-Run` (header, обязательный): Идентификатор текущего запуска сценария. Без действующего запуска и ключа этого проекта — 403 automation_execution_required.

## Пример запроса

```bash
curl --request POST \
  --url "https://api.kvantora.ai/v1/agent-runs" \
  --header "Authorization: Bearer $KVANTORA_API_KEY" \
  --header "Idempotency-Key: $REQUEST_ID" \
  --header "X-Kvantora-Automation-Run: $AUTOMATION_RUN_ID" \
  --header "Content-Type: application/json" \
  --data '{
  "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "content": "Привет",
  "max_cost_microrub": 0
}'
```

## Ответы

- 200: Повтор уже принятого запуска
- 202: Запуск принят
- default: Ошибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.