Pular para o conteúdo principal

kobana inbox agent-runs

Comandos de kobana inbox agent-runs. Toda opção global (Opções globais) vale aqui.

ComandoHTTPDescrição
agent-runs listGET /v1/agent-runsListar agent runs
agent-runs getGET /v1/agent-runs/{id}Obter agent run

agent-runs list​

Listar agent runs

kobana inbox agent-runs list [OPÇÕES]

GET /v1/agent-runs

Paginação keyset. Filtros são query params tipados (campo=valor, campo[op]=valor); filtros desconhecidos, campos não ordenáveis e valores malformados são rejeitados com 400 VALIDATION_ERROR.

Parâmetros de consulta

NomeTipoObrigatórioDescrição
limitintegernão
cursorstringnãoCursor opaco retornado em meta.next_cursor da página anterior.
sort_bystringnãoCampo de ordenação. Permitidos: created_at, updated_at, total_cost, status. Sem ele, a ordem é created_at decrescente. Valores: created_at, updated_at, total_cost, status.
sort_orderstringnãoasc (padrão) ou desc. Exige sort_by. Valores: asc, desc.
statusstringnãoIgualdade. Também status[in]=a,b. Valores: running, success, failed.
agent_idstringnãoIgualdade. Também agent_id[in]=a,b.
email_idstringnãoIgualdade. Também email_id[in]=a,b.
inbox_idstringnãoIgualdade. Também inbox_id[in]=a,b.
llm_modelstringnãoIgualdade. Também llm_model[in]=a,b.
created_atstringnãoIgualdade. Também created_at[in]=a,b e created_at[gt|gte|lt|lte].
created_at[gte]stringnão
created_at[lte]stringnão
finished_atstringnãoIgualdade. Também finished_at[in]=a,b e finished_at[gt|gte|lt|lte].
finished_at[gte]stringnão
finished_at[lte]stringnão
total_costnumbernãoIgualdade. Também total_cost[in]=a,b e total_cost[gt|gte|lt|lte].
total_cost[gte]numbernão
total_cost[lte]numbernão

Cabeçalhos

NomeTipoObrigatórioDescrição
x-origin-shared-secretstringnãoSegredo compartilhado entre o CloudFront e a origem. Obrigatório em produção; ignorado em desenvolvimento a menos que CF_ORIGIN_SHARED_SECRET esteja definido.

Respostas

HTTPDescrição
200Página de resultados.
400O corpo falhou na validação Zod. error.details carrega formErrors/fieldErrors.
404Recurso não encontrado ou filtrado por soft-delete.

agent-runs get​

Obter agent run

kobana inbox agent-runs get [ID] [OPÇÕES]

GET /v1/agent-runs/{id}

Argumentos do caminho: id

Cabeçalhos

NomeTipoObrigatórioDescrição
x-origin-shared-secretstringnãoSegredo compartilhado entre o CloudFront e a origem. Obrigatório em produção; ignorado em desenvolvimento a menos que CF_ORIGIN_SHARED_SECRET esteja definido.

Respostas

HTTPDescrição
200Sucesso.
404Recurso não encontrado ou filtrado por soft-delete.