start_span
Begin a tracing span to monitor and log an operation. Returns a span ID to close with end_span when the work completes.
Instructions
Open a new tracing span. Returns the span_id to pass to end_span().
Args:
name: Human-readable span label (e.g. 'stage_1_bootstrap', 'tool:search_library').
kind: Span type — 'internal' | 'tool' | 'agent' | 'llm'. Default: 'internal'.
session_id: Session identifier (from session_bootstrap). Optional.
run_id: FK to agent_runs.run_id. Optional.
parent_id: Parent span_id for nested spans. Optional.
tags: JSON string of extra key/value metadata. Optional.
Returns the span_id string — pass it to end_span() when the work is done.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| kind | No | internal | |
| session_id | No | ||
| run_id | No | ||
| parent_id | No | ||
| tags | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |