AI

Spacelift provides a way to harvest the power of AI to summarize failed runs. By clicking Explain in the runs history page, Saturnhead will use an advanced LLM to digest the logs of your failed runs and provide useful insights into what went wrong.

Tip

Looking for interactive AI assistance? Infra Assistant provides an AI-powered chat interface that can answer infrastructure questions, debug issues, and manage resources through conversation.

Enabling Saturnhead features

Info

This feature is only available to Enterprise plan customers. Please check out our pricing page for more information.

Saturnhead Assist must be enabled by an admin user in Settings > Spacelift Intelligence. When enabling Spacelift Intelligence for the first time, you will be asked to accept the Terms of Use. Once Saturnhead Assist is turned on, all users with read access to runs can ask for assistance on failed runs.

Admins can also select the LLM model used by Saturnhead Assist. The available options are AWS Bedrock (Anthropic) and Google Gemini.

AI-empowered run summaries

After enabling the feature, the users with read access to the runs will be able to summarize failed executions.

Info

This feature is only supported on stacks using OpenTofu or Terraform.

The results of a summary change per case due to the LLM being non-deterministic, but they generally provide the following information:

• Human-readable summary of the logs.
• Detailed information on what went wrong.
• Code snippet suggestions to help solve the issue.

There are 2 types of summary: Summarize and Explain.

• Summarize uses the output logs of the current phase to generate a human-readable summary. They're faster to execute and provide guidance on what went wrong in a specific step.

• By clicking Explain, Saturnhead will use the logs of the "Initialize", "Plan", and "Apply" phases combined to generate a global summary. This is ideal for catching issues that span across multiple phases. This summary is slower to run, but it is very helpful when dealing with more complex issues.

Once Saturnhead has analyzed the results of the run, it will display a message with the cause of the issue and potential fix solutions for the problem.