Let's use the AI Agent to diagnose and fix a common issue — a setup stage showing an error in the Status Panel. This walkthrough shows how the agent can inspect your environment and resolve problems for you.

Open the Agent¶

Click the wand button in the top-left toolbar of the GF+ sidebar. The agent opens as a new editor tab.

Select Support Mode¶

At the top of the chat, click the Support chip to toggle it on. This teaches the agent how to diagnose and fix GDSFactory+ extension issues.

Ask for a Diagnosis¶

Click the Diagnose quick action, or type something like:

I see an error in my status panel, can you check what's wrong?

The agent will use its tools to inspect your environment. You'll see tool indicators as it works — for example, "Checking extension status..." and "Reading server logs...".

Review the Findings¶

The agent reports what it found in plain language. For example, it might tell you:

The Python Environment stage is failing because the virtual environment at .venv doesn't exist yet. I can create it and install the project dependencies for you.

Next Steps¶

Now that you've seen how the agent works, try asking it other things:

• "Check my logs" — to review recent server activity
• "Help me get started" — to learn what you can do with GDSFactory+
• "Set up a sample project" — to download a working project to explore

Continue to Build a Component with the Agent, or see the full AI Agent reference.