AI - Chat Message

Type identifier: ai:llm:chatMessage Category: AI Operations

Description

The AI - Chat Message node enables conversations with large language models (LLMs) from multiple providers including OpenAI, Anthropic, Google AI, and Groq. It supports dynamic message templates with variable interpolation, streaming responses, extended thinking, and AI actions (tool use).

For exact supported model identifiers and provider-specific capability differences, use AI - Model Reference.

Input Handles

Handle	Type	Description
`trigger`	control	Triggers the LLM request.
`model`	string	(Dynamic mode) Runtime model name input.
`<variable>`	varies	Dynamic handles for each defined variable.

Output Handles

Handle	Type	Description
`response`	`string` or `Content`	The AI-generated response text.
`stream`	async iterable	(Streaming mode) Real-time response stream.
`thinking`	`string`	(Extended thinking) The AI's thinking process.
`<actionId>`	control	Handles for each defined action.
`done`	control	Triggered when the response is complete.

Configuration Options

Model Selection

Option	Type	Default	Description
Model	enum or dynamic string handle	`claude-sonnet-5`	The LLM model to use, literal or runtime input.

When Model is set to dynamic, the node exposes a model input handle and resolves the model name at runtime.

If the runtime model string is not in the supported model list, the node fails with a clear configuration error.

Available models are listed by provider (OpenAI, Anthropic, Google AI, and Groq) in AI - Model Reference — Chat Message Models. Deprecated model names and their replacements are in AI - Model Reference — Deprecated Models and Fallbacks.

Model Parameters

Parameter	Type	Description
Temperature	`number`	Randomness in responses (0-2).
Top K	`number`	Limit token selection to top K candidates.
Top P	`number`	Nucleus sampling probability.
Max Tokens	`number`	Maximum response length.
Stop Sequences	`string[]`	Sequences that stop generation.

Note: Sampling parameters (Temperature, Top K, Top P) are not configurable for adaptive-thinking Claude models (claude-fable-5-1, claude-fable-5, claude-opus-5-5, claude-opus-5, claude-sonnet-5, claude-opus-4-8, claude-opus-4-7) and OpenAI non-chat/reasoning models (gpt-6-astra, gpt-6-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.4-nano, gpt-5.1, gpt-5-2025-08-07, gpt-5-mini-2025-08-07, gpt-5-nano-2025-08-07).

Response Options

Option	Type	Default	Description
Parse to Content	`boolean`	`false`	Parse Markdown response as Content.
Stream Response	`boolean`	`false`	Enable streaming response mode.

Extended Thinking

For supported models:

Option	Type	Description
Enabled	`boolean`	Enable extended thinking mode.
Tokens Budget	`number`	Maximum tokens for thinking.

Adaptive thinking models such as claude-fable-5-1, claude-fable-5, claude-opus-5-5, claude-opus-5, claude-sonnet-5, claude-opus-4-8, and claude-opus-4-7 do not use the Tokens Budget option. Other supported Anthropic models use the configured Tokens Budget.

Auto-Continue

Option	Type	Description
Max Turns	`number`	Maximum conversation turns for auto-continuation.

Variables

Array of variables that can be used in message templates. Each variable creates a dynamic input handle.

Message Templates

Array of message templates defining the conversation:

Field	Type	Description
Type	`"system"` \| `"user"` \| `"assistant"`	Message role.
Message Template	`string` or `Content`	Template with variable placeholders.
Cached	`boolean`	Enable prompt caching (Anthropic).

Repeating messages support:

Iterate over array variables
Create dynamic message sequences

Actions (Tool Use)

Field	Type	Description
Name	`string`	Action name for the AI to call.
Description	`string`	Description of what the action does.
Input Schema	schema	Expected input structure.
Force Use	`boolean`	Force the AI to use this action.
Continue With Result	`boolean`	Auto-continue after action result.

Behaviour

Resolves all variable values from input handles
Constructs messages from templates with interpolated variables
Sends request to selected LLM provider
Processes response (streaming or complete)
If actions are defined and invoked:
- Triggers corresponding action handle
- Waits for action result
- Optionally continues conversation with result
Returns final response and triggers done