Saltar al contenido principal

kobana inbox agent-runs

Comandos de kobana inbox agent-runs. Toda opción global (Opciones globales) vale aquí.

ComandoHTTPDescripción
agent-runs listGET /v1/agent-runsListar AgentRuns
agent-runs getGET /v1/agent-runs/{id}Obtener AgentRun

agent-runs list​

Listar AgentRuns

kobana inbox agent-runs list [OPCIONES]

GET /v1/agent-runs

Paginación keyset. Los filtros son query params tipados (campo=valor, campo[op]=valor); los filtros desconocidos, los campos no ordenables y los valores malformados se rechazan con 400 VALIDATION_ERROR.

Parámetros de consulta

NombreTipoObligatorioDescripción
limitintegerno
cursorstringnoCursor opaco devuelto en meta.next_cursor de la página anterior.
sort_bystringnoCampo por el que ordenar. Permitidos: created_at, updated_at, total_cost, status. Sin él, el orden es created_at descendente. Valores: created_at, updated_at, total_cost, status.
sort_orderstringnoasc (por defecto) o desc. Requiere sort_by. Valores: asc, desc.
statusstringnoIgualdad. También status[in]=a,b. Valores: running, success, failed.
agent_idstringnoIgualdad. También agent_id[in]=a,b.
email_idstringnoIgualdad. También email_id[in]=a,b.
inbox_idstringnoIgualdad. También inbox_id[in]=a,b.
llm_modelstringnoIgualdad. También llm_model[in]=a,b.
created_atstringnoIgualdad. También created_at[in]=a,b y created_at[gt|gte|lt|lte].
created_at[gte]stringno
created_at[lte]stringno
finished_atstringnoIgualdad. También finished_at[in]=a,b y finished_at[gt|gte|lt|lte].
finished_at[gte]stringno
finished_at[lte]stringno
total_costnumbernoIgualdad. También total_cost[in]=a,b y total_cost[gt|gte|lt|lte].
total_cost[gte]numberno
total_cost[lte]numberno

Encabezados

NombreTipoObligatorioDescripción
x-origin-shared-secretstringnoSecreto compartido entre CloudFront y el origin. Obligatorio en producción; se ignora en desarrollo a menos que se configure CF_ORIGIN_SHARED_SECRET.

Respuestas

HTTPDescripción
200Página de resultados.
400El cuerpo no superó la validación de Zod. error.details contiene formErrors/fieldErrors.
404Recurso no encontrado o excluido por soft-delete.

agent-runs get​

Obtener AgentRun

kobana inbox agent-runs get [ID] [OPCIONES]

GET /v1/agent-runs/{id}

Argumentos de la ruta: id

Encabezados

NombreTipoObligatorioDescripción
x-origin-shared-secretstringnoSecreto compartido entre CloudFront y el origin. Obligatorio en producción; se ignora en desarrollo a menos que se configure CF_ORIGIN_SHARED_SECRET.

Respuestas

HTTPDescripción
200Éxito.
404Recurso no encontrado o excluido por soft-delete.