> ## Documentation Index
> Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Text Transform

> Format text and data using AI prompts.

Actions do the actual work in a workflow: API calls, transformations, notifications, flow control, and integrations. Use this action when your workflow needs to perform an operation, call an external service, or transform data for downstream nodes.

## When To Use

* Summarize raw incident notes into a concise status update.
* Normalize free-form user input into structured categories.

## Configuration Checklist

1. Provide a clear prompt and structured input data.
2. Constrain output format if downstream nodes depend on it.
3. Validate output using condition or validate action.
4. Store normalized text/object output for subsequent steps.

## Inputs

* Required `node.data` metadata: `uiId`, `componentId`, and `operation` (for actions that define an operation).
* Action-specific configuration fields from the node editor.
* Upstream context values from triggers or previous nodes (for example `trigger.*` or prior action outputs).

## Outputs

* Adds action result data to the workflow context for downstream nodes.
* May produce external side effects (API updates, notifications, scripts, SSH commands, etc.).
* Can emit structured values consumed by conditions or subsequent actions.

## Failure Modes

* Missing required configuration or invalid parameter values.
* Missing/invalid context variable references from upstream nodes.
* External dependency failures (HTTP errors, auth failures, timeouts, rate limits).
* Payload validation/parsing errors during request or response handling.

## Best Practices

* Use deterministic prompt instructions when the output feeds strict parsers.