setPromptText | SignalWire

Set the agent’s system prompt as a raw text string. This is the simplest way to configure what the AI knows and how it behaves.

This sets the SWML ai.prompt field. See the SWML prompt reference for details on prompt behavior.

Mixing raw text prompts with POM-based prompt sections (promptAddSection()) in the same agent may produce unexpected results. Use one approach or the other for the main prompt. Contexts can still be used alongside either approach.

Parameters

text

stringRequired

The complete system prompt text. Supports multi-line strings.

Returns

AgentBase — Returns this for method chaining.

Example

1 import { AgentBase } from '@signalwire/sdk';
2 
3 const agent = new AgentBase({ name: 'support', route: '/support' });
4 agent.setPromptText(`
5 You are a customer support agent for Acme Corp.
6 You help customers with billing questions, order tracking, and returns.
7 Always be polite and professional.
8 `);
9 await agent.serve();

1	import { AgentBase } from '@signalwire/sdk';
2
3	const agent = new AgentBase({ name: 'support', route: '/support' });
4	agent.setPromptText(`
5	You are a customer support agent for Acme Corp.
6	You help customers with billing questions, order tracking, and returns.
7	Always be polite and professional.
8	`);
9	await agent.serve();