Craft an agent-backed scope

This section walks you through everything you need to define and register your own agent-backed scope. You'll write a specification, define lifecycle actions, and make the scope available to developers in your organization.

💡 If you're just looking to use a prebuilt scope (like one for scheduled tasks), head over to our how-to guides instead.

What you’ll do here

By the end of this section, you’ll know how to:

• Define your scope specification
• Implement lifecycle and custom actions
• Register your scope so developers can use it in the platform

Each of these steps maps to a dedicated guide:

• Scope specification Learn how to define your scope’s structure, including its parameters, visibility, and allowed asset types.

• Lifecycle action specifications
  Set up the create, update, and custom actions that bring your scope’s lifecycle to life.

• Register your scope
  Enable your scope for use in specific accounts or namespaces using the CLI or API.

Prerequisites

Before starting, make sure you’ve read the Overview and key concepts page. You should be familiar with:

• What agent-backed scopes are
• How they differ from services
• What specifications and actions do

If you're already comfortable with those, you're good to go.

What’s next?

Start by defining your scope specification