Using the Agent

Start from Work and describe the outcome you want in natural language. The agent works with you to understand the request, inspect the connected repository, plan the approach, and verify the result.

Behind the scenes, the agent reads your files, references your connectors, follows your rulesets, delegates to subagents, and executes your workflows to work the way your organization works.

How the agent interacts with you depends on your personal agent preferences. You can set your experience level and working style so the agent adapts to how you like to work.

The workspace layout

The workspace has separate tabs for Overview, Work, Architecture, Context, Compliance, and Settings when your role and enterprise features allow them. Work holds conversations and repository results. Architecture holds branch-aware diagrams. Context holds shared references. The legacy code editor remains available when enabled for your enterprise.

What you can do with it

  • Create new infrastructure from scratch using Terraform, OpenTofu, Pulumi, and other infrastructure as code languages
  • Bring existing cloud resources under IaC management by generating code that represents what's already running in your environment
  • Migrate between clouds or build multi-cloud ecosystems by translating infrastructure patterns across providers
  • Modernize on-prem systems by translating requirements from existing environments into cloud infrastructure as part of transformation activities
  • Audit and review existing infrastructure code for security, cost, and best practice improvements
  • Create reusable modules that embed your organization's standards and can be shared across workspaces
  • Generate documentation for your infrastructure, architecture decisions, and operational procedures
  • Create diagrams at different levels of detail, edit them directly, and synchronize the design with code through Architecture

Conversations

Each Work conversation keeps its messages, plans, branch, and results. The agent can read the connected repository and any Context you attach, subject to your permissions.

You can have multiple conversations in a workspace. Useful for working on different features or keeping focused threads.

Tips

  • Be specific. "Create a Terraform module for an S3 bucket with versioning and encryption" works better than "Make an S3 bucket"
  • Reference files. Mention repository files directly, or use @ to attach workspace Context
  • Iterate. Build on the agent's output step by step
  • Use workflows. For complex tasks, run a workflow to guide the agent through a structured process
  • Connect connectors. Add connectors to give the agent context from existing systems like Terraform Cloud or AWS, or let it take action in external platforms
  • Add Context. Give the agent project-specific requirements, architecture plans, design specs, and reference links
  • Add rulesets. Define standards and guidelines so the agent follows your organization's way of working
  • Start with context. Explain what you're working on and what you need