Infrastructure Designer Agent

Overview

Blueprint Design is a capability of Praxis, the Facets AI assistant, that helps you design and manage infrastructure blueprints through natural conversation. When you ask Praxis about resources, projects, or infrastructure configuration, it automatically helps you architect complete systems using Facets' declarative resource definitions.

Key Benefits

Accelerated Infrastructure Design: Design complete applications through conversation in minutes
Intelligent Dependency Management: Automatically resolves resource dependencies and validates schemas
Zero Manual YAML/JSON Editing: Praxis handles all resource configuration using Raptor CLI
Schema-Driven Safety: All resources validated against Facets schemas before deployment

How to Access and Use

Simply ask Praxis to help with infrastructure:

"Create a web application with database and cache"
"Add a new service to my project"
"Show me resources in my project"

Praxis automatically loads the blueprint design capabilities and guides you through the process.

How Blueprint Design Works

Praxis uses Raptor CLI (a kubectl-style CLI for Facets) to manage all infrastructure operations. When you describe what you need, Praxis:

Understands your requirements through conversation
Fetches resource schemas to ensure correct structure
Creates properly configured resource definitions
Validates dependencies and references
Applies changes using Raptor commands
Triggers deployments and monitors progress

All operations are performed using Raptor CLI commands behind the scenes - you just have natural conversations with Praxis.

Capabilities

Resource Management: Create, update, and delete infrastructure resources (databases, compute, networking, storage) across cloud providers.

Dependency Resolution: Automatically identifies required dependencies and validates connections between resources.

Schema Validation: Ensures all configurations match Facets schemas before deployment - prevents errors.

Environment-Specific Configuration: Manages environment-specific settings (dev vs production) through overrides.

Deployment Management: Triggers releases, monitors progress, and provides real-time deployment feedback.

Example Use Cases

Building a Three-Tier Application

You: "I need a web service connected to PostgreSQL and Redis"

Praxis: Checks schemas, creates database resources first, then creates the service with proper connections, applies everything, and triggers deployment.

Environment-Specific Scaling

You: "Increase replicas to 10 in production"

Praxis: Applies production-specific override, shows pending changes, and deploys after your confirmation.

Safety and Security

Schema-First Approach: Praxis always validates against Facets schemas - never guesses resource structure.

Dependency Validation: Checks all required dependencies exist before creating resources.

Plan Before Apply: Supports dry-run mode to preview changes before deployment.

User-Scoped Access: All operations respect your Facets RBAC permissions.

Troubleshooting

Praxis can't find my project: Ask Praxis to "list all projects" to see available options.

Resource creation fails: Praxis validates schemas automatically. If errors occur, Praxis explains what needs to be fixed.

Can't reference another resource: Ask Praxis to "show available outputs" for the resource you want to reference.

Deployment failed: Praxis can fetch logs and provide root cause analysis. Share the error with Praxis for investigation.

FAQ

Is this a separate agent from Praxis? No, blueprint design is a built-in capability of Praxis that activates when you discuss infrastructure.

Do I need to learn Raptor CLI? No. Praxis handles all Raptor commands for you. You just describe what you need in plain English.

Can I see what commands Praxis runs? Yes, Praxis shows the operations it performs. You can also use Raptor CLI directly if you prefer.

What if I make a mistake? Ask Praxis to revert the change. It can restore previous configurations.

Does this work across multiple clouds? Yes, Facets supports AWS, GCP, and Azure. Praxis works with all supported cloud providers.