Skip to main content
Pulumi logo Pulumi logo
  1. Docs
  2. Infrastructure AI
  3. Pulumi Agents
  4. Review proposed changes
  5. Run previews

Run previews

    Ask an agent to run a Pulumi preview to see how its code changes would affect a stack. The preview runs the program and reports planned resource changes without applying them.

    Before you begin

    The agent needs the same program, configuration, and credentials that a preview requires from your terminal or CI workflow:

    1. Connect the repository containing the program. For a local CLI or editor session, open the project directory instead.
    2. Supply the program’s configuration through stack configuration or an imported Pulumi ESC environment.
    3. Configure credentials for the program’s cloud providers, such as AWS, Azure, or Google Cloud.

    If you use ESC, associate the environment with the stack and grant the agent access to open it. An agent your team creates uses its assigned Pulumi Cloud role; Neo uses your permissions by default. See Permissions and approvals for access requirements.

    Run a preview

    1. In the task where the agent prepared the code change, ask it to run a preview. Specify the stack if the task involves more than one.
    2. If the task’s approval mode requires confirmation, approve the preview request.
    3. Open the preview output in the task.

    Follow Review proposed changes to assess the resource changes, policy results, and failed checks.

    Troubleshooting

    Missing or invalid credentials

    Use the preview error to identify the provider or configuration value that failed. If the credentials come from ESC:

    1. Check that the environment supplies the credentials the program requires.
    2. Open the stack details page and confirm that the environment is associated with the stack.
    3. Check that the agent can open the environment and that the credentials allow the required cloud operations.
    4. Correct the configuration or access, then ask the agent to run the preview again.

      The infrastructure platform for humans and agents.