invoke_agent span and acts as the root of the
trace for that turn: it is always started under ROOT_CONTEXT so it
never accidentally inherits a parent from another OTel-instrumented
library.
Created by weave.startTurn() (or conversation.startTurn()) and
terminated with end(). Only one Turn may be active in an async chain.
Children (LLM, Tool, SubAgent) attach via the startLLM, startTool,
startSubagent methods.
Examples
Extends
SpanBase
Accessors
agentName
Get Signature
get agentName(): string
Returns
string
model
Get Signature
get model(): string
Returns
string
Methods
addEvent()
addEvent(Add a named event to the span. Useful for marking non-span moments such as context compaction, tool-loop detection, or guardrail trips. Warns and no-ops aftername,attributes?,startTime?):this
end(). Mirrors OTel Span.addEvent.
Parameters
string
required
Attributes
TimeInput
Returns
this
Example
Inherited from
SpanBase.addEvent
end()
end(Read current field values (to reflect mutations made viaopts?):void
record()
since start) and close the span. Idempotent. Pass error to mark
it as failed; pass endTime to backdate the close.
Parameters
object
Returns
void
record()
record(Bulk-set any subset of the mutable fields. Replaces (does not merge). Useful for assigning everything at once after a provider call returns.opts):this
Parameters
object
required
Returns
this
setAttribute()
setAttribute(key,value):this
Parameters
string
required
AttributeValue
required
Returns
this
setAttributes()
setAttributes(Set multiple attributes on the span at once. Warns and no-ops afterattributes):this
end(). Mirrors OTel Span.setAttributes (and the Python SDK’s
set_attributes).
Parameters
Attributes
required
Returns
this
Example
Inherited from
SpanBase.setAttributes
startLLM()
startLLM(Start a child LLM span under this Turn.opts):LLM
Parameters
Returns
LLM
startSubagent()
startSubagent(Start a child SubAgent span under this Turn.opts):SubAgent
Parameters
SubAgentInit
required
See
SubAgentInit.Returns
SubAgent
startTool()
startTool(Start a child Tool span under this Turn.opts):Tool
Parameters
Returns
Tool