Get started

Deploy your first agent

Run a blueprint as a live hosted agent
View as Markdown

Deploying takes a blueprint from the registry and runs it as a live agent on Astro AI. The agent gets a web endpoint and optional integrations (Slack, etc.) based on the adapter you choose.

Requires a blueprint in your account. See Your first blueprint to push one.

1

Deploy a blueprint

$ast blueprint deploy <name>

<name> is the blueprint name (as shown in ast blueprint list). By default the agent is accessible through a web interface with authentication enabled.

Give the deployment a custom display name:

$ast blueprint deploy my-agent --name "My Production Agent"
2

Supply required variables

Most agents require API keys or credentials at deploy time. Pass them inline:

$ast blueprint deploy my-agent --var ANTHROPIC_API_KEY=@ANTHROPIC_API_KEY

The @SECRET_NAME syntax references a value from your account vault. You can also pass a literal value:

$ast blueprint deploy my-agent --var REGION=us-east-1

Or load from a file:

$ast blueprint deploy my-agent --vars-file .env.prod

Use --dry-run to validate inputs without deploying:

$ast blueprint deploy my-agent --var ANTHROPIC_API_KEY=@ANTHROPIC_API_KEY --dry-run
3

View your deployed agents

$ast agent list

Shows all agents in the active account with their status and deployment ID. When the deployment finishes, your agent’s status shows running. Open its web endpoint in a browser to confirm it responds.

Adapters

An adapter controls how your agent is exposed to the world. Each adapter adds an interface (a web endpoint, a Slack bot, or both). You choose adapters at deploy time with --adapter; the default is web with authentication.

AdapterDescription
webWeb interface with OIDC authentication (default)
insecure-webWeb interface with no authentication; use only in trusted environments
slackSlack bot integration

web and insecure-web are mutually exclusive. slack can be combined with either.

insecure-web disables authentication, so anyone with the endpoint URL can access your agent. Use it only in trusted environments.

Frontend agents

Agents that declare agent.interfaces.frontend: true in their spec serve their own web UI. Deploy them the same way:

$ast blueprint deploy my-frontend-agent

The deployed agent receives a dedicated hostname and is immediately accessible in a browser. The --adapter flag has no effect for frontend agents.

Next steps