HandoffWorkflowBuilder Class

The prefix for function calls that trigger handoffs to other agents; the full name is then {FunctionPrefix}<agent_id>, where <agent_id> is the ID of the target agent to hand off to.

Optional workflow description; applied to the inner WorkflowBuilder at Build().

Gets or sets additional instructions to provide to an agent that has handoffs about how and when to perform them.

Optional workflow name; applied to the inner WorkflowBuilder at Build().

Memoized output designations. null means the user has not made any explicit designation, and the orchestration-specific defaults will be applied at Build() time. A non-null (possibly empty) map means the user took control and only these designations will be replayed onto the inner WorkflowBuilder. An entry's value is the set of tags requested for the agent — an empty set encodes a terminal-only designation.

Adds the specified agents as participants in the handoff workflow without defining handoff relationships for them.

Applies the optional Name and Description to builder. Subclasses should call this from their Build() implementation.

Applies the user's memoized output designations to builder, or invokes applyDefaults if the user made no explicit designation.

Builds a Workflow composed of agents that operate via handoffs, with the next agent to process messages selected by the current agent.

Sets a value indicating whether aggregated agent response events should be emitted during execution.

Sets a value indicating whether agent streaming update events should be emitted during execution. If null, the value will be taken from the TurnToken

Configures the workflow so that subsequent user turns route directly back to the specialist agent that handled the previous turn, rather than always routing through the initial (coordinator) agent.

Enables autonomous mode for the handoff workflow.

Sets the description for the workflow.

Adds a handoff relationship from a source agent to a target agent with a custom handoff reason.

Sets instructions to provide to each agent that has handoffs about how and when to perform them.

Adds handoff relationships from a source agent to one or more target agents.

Adds handoff relationships from one or more sources agent to a target agent.

Designates the given agents as sources of intermediate workflow output. See WithOutputFrom(IEnumerable<AIAgent>) for the defaults-suppression semantics.

Sets the human-readable name for the workflow.

Designates the given agents as sources of terminal workflow output. Calling any output-designation method (this or WithIntermediateOutputFrom(IEnumerable<AIAgent>)) suppresses the orchestration-specific defaults: only the user-specified designations reach the inner WorkflowBuilder.

Sets a synchronous termination condition for the handoff workflow.

Sets an asynchronous termination condition for the handoff workflow.

Sets the behavior for filtering FunctionCallContent and Tool contents from ChatMessages flowing through the handoff workflow. Defaults to HandoffOnly.