O bloco Logs dá aos agentes acesso programático ao histórico de execuções de workflows no workspace atual. Ele consulta os mesmos dados de runs exibidos na página Logs e pode obter o detalhe completo de execução de qualquer run individual.
Com o Logs, você pode:
- Consultar histórico de runs: Filtrar runs por workflow, pasta, status, tipo de trigger, intervalo de datas, custo e duração, com ordenação e busca por texto livre
- Obter detalhes de um run: Recuperar status, trigger, timing, custo e output final de um run específico pelo run ID
- Inspecionar traces de execução: Obter os trace spans completos de um run para ver como ele executou passo a passo
No Zoen, o bloco Logs permite que seus agentes busquem e filtrem o histórico de execuções com os mesmos filtros da página Logs e, em seguida, aprofundem em um run específico para recuperar status, custo, duração, output final e trace spans completos. Assim, agentes podem monitorar outros workflows, auditar execuções passadas e obter detalhes de execução de forma programática como parte de um workflow maior.
Usage Instructions
Query workflow run logs in the current workspace with the same filters as the Logs page, returning matching run IDs. Fetch full details for a single run, including its trace spans.
Actions
logs_query_runs
Query workflow run logs in the current workspace with the full Logs-page filter set. Returns matching run IDs.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
workflowIds | string | No | Comma-separated workflow IDs to filter by |
folderIds | string | No | Comma-separated folder IDs to filter by (descendants included) |
level | string | No | Comma-separated statuses: 'info', 'error', 'running', 'pending', 'cancelled'. Omit for all. |
triggers | string | No | Comma-separated trigger types (api, webhook, schedule, manual, chat, mcp, workflow, sim, …) |
startDate | string | No | ISO 8601 timestamp; only runs at or after this time |
endDate | string | No | ISO 8601 timestamp; only runs at or before this time |
search | string | No | Free-text search across log fields |
costOperator | string | No | Cost comparison operator: '=', '>', '<', '>=', '<=', '!=' |
costValue | number | No | Cost threshold in credits, compared using costOperator |
durationOperator | string | No | Duration comparison operator: '=', '>', '<', '>=', '<=', '!=' |
durationValue | number | No | Duration threshold in milliseconds, compared using durationOperator |
limit | number | No | Max run IDs to return (default 100, max 200) |
sortBy | string | No | Sort field: 'date' (default), 'duration', 'cost', 'status' |
sortOrder | string | No | Sort order: 'desc' (default) or 'asc' |
Output
| Parameter | Type | Description |
|---|---|---|
runIds | array | IDs of the runs matching the filters |
logs_get_run_details
Fetch details for a single workflow run by its run ID, including the full trace spans.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
runId | string | Yes | The run ID to fetch details for |
Output
| Parameter | Type | Description |
|---|---|---|
runId | string | The run ID |
workflowId | string | Workflow ID this run belongs to |
workflowName | string | Workflow name |
status | string | Run status |
trigger | string | How the run was triggered |
startedAt | string | Run start time (ISO 8601) |
durationMs | number | Run duration in milliseconds |
cost | number | Run cost in credits |
traceSpans | array | Full trace spans for the run |
finalOutput | json | Final output of the run |