Состояние запуска агента

GET/v1/agent-runs/{runId}

Требуемое право: text. Только изнутри запущенного сценария Kvantora Flow: нужен заголовок X-Kvantora-Automation-Run. Запуск виден только ключу, который его создал.

Авторизация

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

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

Заголовки

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

Idempotency-Keystringдлина 1–128

Если указан, запуск ищется только среди созданных с этим ключом.

Параметры пути

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

Ответы

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"

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

true для SUCCEEDED, FAILED, CANCELLED и TIMED_OUT.

operationKeystring

outputany

Результат агента; только при done:true.

errorCodestring | null

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

application/json

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

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

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

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

request_idstring

typestring

import os import requests response = requests.get( "https://api.kvantora.ai/v1/agent-runs/<runId>", headers={ "Authorization": f"Bearer {os.environ['KVANTORA_API_KEY']}", "X-Kvantora-Automation-Run": os.environ["AUTOMATION_RUN_ID"], }, timeout=120, ) print(response.json())

const response = await fetch('https://api.kvantora.ai/v1/agent-runs/<runId>', { method: 'GET', headers: { Authorization: `Bearer ${process.env.KVANTORA_API_KEY}`, 'X-Kvantora-Automation-Run': process.env.AUTOMATION_RUN_ID, }, }); console.log(await response.json());