Step

A Step represents a single phase within a Context. Each step has its own prompt text, completion criteria, available functions, and navigation rules. The AI advances through steps automatically when criteria are met.

You create steps by calling addStep() on a Context object. All setter methods return this for fluent method chaining.

Properties

name

stringRequired

Step name. Must be unique within the parent context.

Methods

addBullets

Add a POM section with bullet points to the step.

addGatherQuestion

Add a question to this step’s gather info configuration.

addSection

Add a POM section to the step.

clearSections

Remove all POM sections and direct text from this step.

setEnd

Set whether the conversation should end after this step completes.

setFunctions

Set which SWAIG functions are available during this step.

setHistory

Control how much prior conversation the model sees at this step.

setGatherInfo

Enable structured info gathering for this step.

setResetConsolidate

Set whether to consolidate conversation history on context switch.

setResetFullReset

Set whether to fully reset conversation history on context switch.

setResetSystemPrompt

Set a new system prompt for context switching from this step.

setResetUserPrompt

Set a user message to inject when this step triggers a context switch.

setSkipToNextStep

Automatically advance to the next step without evaluating criteria.

setSkipUserTurn

Skip waiting for user input when entering this step.

setStepCriteria

Define when this step is considered complete.

setText

Set the step’s prompt text directly.

setValidContexts

Set which contexts the agent can navigate to from this step.

setValidSteps

Set which steps the agent can navigate to from this step.

Example

import { ContextBuilder } from '@signalwire/sdk';
const builder = new ContextBuilder();
const ctx = builder.addContext('default');
const step = ctx.addStep('collect_info');
// Structured prompt with POM sections
step.addSection('Task', 'Collect the caller\'s account information.');
step.addBullets('Required Information', [
  'Full legal name',
  'Account number (10 digits)',
  'Reason for calling',
]);
// Completion criteria
step.setStepCriteria(
  'Complete when all three pieces of information have been collected and confirmed with the caller.'
);
// Only allow relevant functions
step.setFunctions(['lookup_account', 'verify_identity']);
// Navigation
step.setValidSteps(['process_request', 'escalate']);