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 custom 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 the how-to guides for custom scopes

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

Stream telemetry and execution data​

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

  • Capture logs, exit codes, and structured output
  • Send live updates to the nullplatform UI
  • Push results to dashboards or external tools through the API

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.

Enforce compliance​

The agent can also help enforce policies and automate review steps.

  • Require approvals for tasks like production access
  • Run guardrails automatically when specific actions are triggered
  • Keep everything local, while still showing results in the UI