Skip to main content

Agent-driven workflows

The nullplatform agent makes it easy to automate tasks across your infrastructure. It listens for events from the platform and runs workflows inside your environment, securely and without the need for extra tooling.

Here are some of the most common ways teams use the agent to simplify automation and keep things running smoothly.

Run agent-backed scopes​

Scopes are pipelines you define in your repo. When triggered, the agent picks them up and runs them inside your infrastructure.

  • Write scopes in YAML and version them alongside your code
  • Use tags to control where each scope runs (like env:prod or team:secops)
  • Trigger them manually, from service events, or through notification channels
  • See logs and output directly in the nullplatform UI

👉 Check out our agent-backed scopes docs

Extend service behavior​

You can use the agent to react to service updates or lifecycle changes with extra tasks.

  • Run smoke tests or post-deploy checks after a service is updated
  • Clean up automatically when something fails
  • Add custom scripts using notification channels

👉 Check out our services docs

Stream telemetry and execution data​

While tasks run, the agent collects useful runtime data and can report it back to the platform.

  • Capture logs and metrics
  • Send live updates to the nullplatform UI
  • Push results to dashboards or external tools through the API

👉 Check out our telemetry docs

Automate event-based workflows​

The agent can help you respond to platform activity without setting up brittle scripts.

  • Run tasks when deployments finish, scopes complete, or configs change
  • Target actions using tags and filters
  • Chain steps together to build more complete workflows

✅ Event > Agent > Script or Scope
Notification channels help connect platform events to your infrastructure.