> ## 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.

# Generative AI

> Use AI-assisted features in Altostrat SDX for workflow text transforms, script drafting, diagnostics, and operational support.

Altostrat SDX includes AI-assisted surfaces that help operators move faster. AI can draft RouterOS scripts, transform text in workflows, support diagnostics, and help turn operational intent into a first version of an action.

AI assistance does not replace operator review. Treat generated output as a draft that must be checked against the site, policy, and change window.

## Where AI Appears

<CardGroup cols={3}>
  <Card title="Script drafting" icon="file-terminal">
    Describe a RouterOS task and use AI to create a starting script for review and testing.
  </Card>

  <Card title="Workflow text transform" icon="brain-circuit">
    Use the **AI Text Transform** node to rewrite, summarize, or structure text inside a workflow.
  </Card>

  <Card title="Operational assistance" icon="sparkles">
    Use AI-assisted product surfaces to speed up investigation, explanation, and repetitive operator work.
  </Card>
</CardGroup>

## Good Uses

* Draft a RouterOS script from a precise change request.
* Summarize a fault or run payload before sending a notification.
* Convert raw JSON or log text into a human-readable incident summary.
* Generate first-pass documentation for an internal procedure.
* Explain a planned workflow before you activate it.

## Risky Uses

Avoid using AI output directly when the action can:

* Remove management access.
* Change routing, WAN priority, firewall policy, or VPN reachability.
* Delete configuration or data.
* Touch many sites at once.
* Grant access to users or external systems.

Use scheduled script testing, workflow node testing, and human approval for these cases.

## Prompting Guidance

Give the AI enough operational context:

* The site or device role.
* The RouterOS version or feature constraint, if relevant.
* The exact desired state.
* What must not change.
* How you want the result formatted.

For example, ask for a script that adds a specific firewall rule only if it does not already exist, and state that management access must not be changed.

## Review Checklist

Before using AI-generated output:

<Checklist>
  * Confirm every command or field matches your intent.
  * Remove secrets from prompts and outputs.
  * Test against a representative non-critical site.
  * Check whether the change is idempotent.
  * Use workflow or scheduled script logs to confirm the result.
</Checklist>

## Related Pages

<CardGroup cols={2}>
  <Card title="Script management" icon="terminal" href="./script-management" arrow="true">
    Test and authorize RouterOS scripts before rollout.
  </Card>

  <Card title="Workflow node reference" icon="boxes" href="./workflows/node-reference" arrow="true">
    Review the AI Text Transform node and other workflow actions.
  </Card>
</CardGroup>