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

POST/v1/agent-runs

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

Авторизация

Authorizationstringобязательный

Ключ API в заголовке Authorization: Bearer <ключ>. Ключ создаётся в кабинете, подробнее — в разделе Аутентификация.

Заголовки

Idempotency-Keystringобязательныйдлина 1–128

Один стабильный ключ на логический запуск агента.

X-Kvantora-Automation-Runstringобязательныйшаблон ^[A-Za-z0-9_-]{1,128}$

Идентификатор текущего запуска сценария. Без действующего запуска и ключа этого проекта — 403 automation_execution_required.

Тело запроса

application/json · обязательное

agent_idstringобязательныйuuid

ID опубликованного агента из GET /v1/agents.

contentstringобязательныйдлина 1–32000

Задание агенту; пробелы по краям обрезаются.

max_cost_microrubintegerобязательный0 … 9007199254740991

Предел стоимости запуска в микрорублях.

Ответы

200Повтор уже принятого запуска

application/json

runIdstringобязательныйuuid

statestringобязательный

Значения: "QUEUED" "RUNNING" "WAITING_FOR_TOOL" "WAITING_FOR_APPROVAL" "WAITING_FOR_SUBAGENT" "PAUSED" "RETRY_SCHEDULED" "NEEDS_RECONCILIATION" "SUCCEEDED" "FAILED" "CANCELLED" "TIMED_OUT"

donefalseобязательный

resultUrlstringобязательный

Относительный адрес для чтения результата.

replayboolean

conversationIdstringuuid

202Запуск принят

application/json

runIdstringобязательныйuuid

statestringобязательный

donefalseобязательный

resultUrlstringобязательный

Относительный адрес для чтения результата.

replayboolean

conversationIdstringuuid

ОшибкаОшибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.

application/json

errorobjectобязательный

Вложенные поля

codestringобязательный

messagestringобязательный

request_idstring

typestring

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 }'

import os import requests response = requests.post( "https://api.kvantora.ai/v1/agent-runs", headers={ "Authorization": f"Bearer {os.environ['KVANTORA_API_KEY']}", "Idempotency-Key": os.environ["REQUEST_ID"], "X-Kvantora-Automation-Run": os.environ["AUTOMATION_RUN_ID"], }, json={ "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "content": "Привет", "max_cost_microrub": 0, }, timeout=120, ) print(response.json())

const response = await fetch('https://api.kvantora.ai/v1/agent-runs', { method: 'POST', headers: { Authorization: `Bearer ${process.env.KVANTORA_API_KEY}`, 'Idempotency-Key': process.env.REQUEST_ID, 'X-Kvantora-Automation-Run': process.env.AUTOMATION_RUN_ID, 'Content-Type': 'application/json', }, body: JSON.stringify({ "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "content": "Привет", "max_cost_microrub": 0 }), }); console.log(await response.json());