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

# Automation and AI

> Use workflows, scheduled scripts, templates, and AI-assisted tools to automate Altostrat SDX operations.

Altostrat SDX automation is built for network operations teams that need repeatable work without losing control. You can design visual workflows, run RouterOS scripts through the device job plane, store workflow secrets, and use AI-assisted surfaces to speed up diagnostics or script drafting.

The key idea is simple: use the lightest automation tool that still gives you the right safety, auditability, and operational visibility.

## Automation Surfaces

<CardGroup cols={3}>
  <Card title="Workflows" icon="workflow">
    Build node-based automations with triggers, actions, conditions, loops, workflow chaining, logs, runs, and authorizations.
  </Card>

  <Card title="Scheduled scripts" icon="terminal">
    Execute RouterOS scripts across sites through the SDX job model, with testing, scheduling, authorization, and per-site outcomes.
  </Card>

  <Card title="AI-assisted operations" icon="sparkles">
    Use AI to draft scripts, transform text in workflows, and accelerate operator tasks while keeping review and approval in your hands.
  </Card>
</CardGroup>

```mermaid theme={null}
flowchart LR
  Event["Event, schedule, API request, or operator action"] --> Workflow["Workflow"]
  Workflow --> Action["API, notification, tag, policy, WAN, script, or data action"]
  Action --> Logs["Runs and logs"]
  Script["Scheduled script"] --> DeviceJob["Device job plane"]
  DeviceJob --> Site["Managed site"]
  AI["AI assistance"] --> Workflow
  AI --> Script
```

## Choose The Right Tool

| Need                                           | Use                  | Why                                                                                                |
| ---------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------- |
| React to site, WAN, schedule, or API events    | Workflows            | The workflow engine gives you branching, variables, conditions, and logs.                          |
| Push RouterOS changes across one or more sites | Scheduled scripts    | Scripts run through the platform's asynchronous device job model and can be tested before rollout. |
| Transform payloads or create reports           | Workflows            | Data mapper, parser, text, PDF, notification, and integration nodes keep this work visible.        |
| Draft a RouterOS script faster                 | AI script generation | AI can create a starting point, but you still review and test before execution.                    |
| Store tokens, passwords, or signing material   | Workflow vault       | Vault secrets are not exposed again after creation and can be referenced by workflow nodes.        |

## Safety Model

Automation in SDX should stay observable:

* Give workflows clear names and descriptions.
* Keep destructive or network-changing actions behind deliberate authorizations.
* Test workflow nodes with representative context before activating the workflow.
* Use vault secrets instead of hardcoding credentials in node inputs.
* Use scheduled script test runs before multi-site execution.
* Review runs, logs, and per-site outcomes after every meaningful automation change.

## Start Here

<CardGroup cols={2}>
  <Card title="Build workflows" icon="workflow" href="./workflows/building-workflows" arrow="true">
    Learn the workflow canvas, node types, context, testing, and logs.
  </Card>

  <Card title="Review triggers" icon="play" href="./workflows/triggers-and-webhooks" arrow="true">
    Choose between manual, scheduled, API, lifecycle, health, and workflow triggers.
  </Card>

  <Card title="Use vault secrets" icon="key-round" href="./workflows/using-the-vault" arrow="true">
    Store and reference sensitive values safely.
  </Card>

  <Card title="Run scripts" icon="file-terminal" href="./script-management" arrow="true">
    Test, authorize, schedule, and monitor RouterOS scripts.
  </Card>
</CardGroup>
