Skip to main content
Node type: ai_prompt · Version: 1 · Category: Data Send an instruction mid-workflow and wait for the model response. This node is not marked with the catalogue’s generic side-effect flag. That classification is not a guarantee that every configured operation is read-only; review the concrete action and its destination.

When to use this node

  • Classify, summarize, extract, or draft from mapped workflow data.
  • Turn unstructured text into a concise result before a human review step.

Example: Summarize a support email

Map the email body into a focused prompt and ask for a short draftable summary.
Example settings
This shows the important settings, not a complete exported node. Connection and profile IDs are illustrative; select the real resource in the inspector.
  1. Choose a connection whose provider and data policy are appropriate.
  2. Map only the context needed for the task.
  3. Review response before using it in communication or another side effect.

Configuration

The workflow pauses at this node until the selected provider responds, the request is cancelled, or the configured timeout is reached.
The credential remains in the host vault. The prompt, system instruction, and mapped context are sent to the selected provider.
AI nodes run on the desktop local runner and return the response text, provider-reported usage, and model ID.
Instructions are limited to 100000 characters and timeout is clamped to 1000–300000 milliseconds.

Workflow JSON

The editor stores this node with the following implemented default configuration:
Default node configuration
Values may be entered literally or mapped from an earlier compatible output when the inspector exposes a mapping control. See Variables and data mapping.

Inputs

Outputs

Execution behavior

  • The local runner waits for the provider and returns response text, provider-reported usage, and model ID.
  • Prompt, system instruction, and mapped context leave sndbox for the selected provider; the credential remains in the host vault.
  • The editor catalogue declares response (string), usage (object), model (string) for mapping. The execution inspector can contain additional evidence fields; inspect a real result before selecting nested paths from object or any outputs.

Common issues

  • Model output is untrusted data: validate structure and preserve human review for consequential actions.
  • Reduce prompt size or raise the timeout within limits when requests consistently time out.

Where it can run

  • Desktop local runner

Test and inspect

Use Test node in the editor to preview this step with the current configuration. A full run records resolved inputs, outputs, logs, duration, and any artifacts in the execution inspector. Side-effecting or destructive nodes can require an additional confirmation or approved workflow permission.