ContextQMD
Back to Medusa

{metadata.title}

www/apps/cloud/app/deployments/fix-with-ai/page.mdx

2.20.12.6 KB
Original Source

import { getOsShortcut, Kbd } from "docs-ui"

export const metadata = { title: Fix Deployment and Build Issues with AI, }

{metadata.title}

In this guide, you'll learn how to use the "Fix with AI" feature on Cloud to troubleshoot and resolve issues in your deployments and builds.

What is "Fix with AI"?

When your build or deployment fails on Cloud, you'll often need to look through the logs to identify the issue and find a solution. This can be time-consuming and may require searching through documentation or forums for similar issues to find a solution.

With the "Fix with AI" feature, you can leverage the Cloud Assistant to understand why your build or deployment failed and get suggestions on how to fix it. The AI agent analyzes the logs of your failed build or deployment, identifies the root cause of the issue, and provides you with actionable steps to resolve it.

How to Investigate Build or Deployment Issues with AI

When your build or deployment fails, you can go to the deployment's details page to access the "Fix with AI" feature:

<Note title="Tip">

You can also navigate to a project's deployments from the command palette. Press <Kbd>{getOsShortcut()}</Kbd> + <Kbd>K</Kbd>, select Deployments, then choose a project.

</Note>
  1. If you're in a different organization, switch to the organization.
  2. Click Projects in the sidebar and select the project that contains the environment you want to view.
  3. Click Deployments in the sidebar under the project.
  4. Click on the failed deployment to open its details page.
  5. Click on the Fix with AI button at the top right of the "Activity" section.

This opens the Cloud Assistant panel with the agent's analysis of the issue and suggestions on how to fix it. You can chat with the AI agent to ask follow-up questions or get more details about the issue and the suggested solutions.

Each build has its own chat. So, if you click Fix with AI again for the same build, the assistant reopens the chat you already had about it instead of starting over.

The AI agent will use its knowledge on your project and its expertise in Medusa to provide you with the best possible solutions to fix your build or deployment issues. You can then follow the suggested steps to resolve the issue and get your deployment up and running again.

If the agent suggests code changes, click Get instructions for local agent under its message to generate a summary that you can copy into a local coding agent, such as Claude Code or Cursor.