***

title: Agent Architect
position: 0
deprecated: false
hidden: false
metadata:
title: ''
description: ''
robots: index
next:
description: ''
---------------

Agent Architect is an AI-powered coding assistant built directly into Agent Studio. It acts as a copilot that helps you design, build, and iterate on plugins without leaving the platform. Rather than switching between documentation, external tools, and the editor, you can interact with Agent Architect in a conversational sidebar panel to accelerate your development workflow.

<Callout intent="info">
  Agent Architect is embedded in Agent Studio and currently operates as a **read-and-advise** copilot. It cannot directly update or modify a plugin on your behalf — all changes are authored by you.
</Callout>

# How It Works

Agent Architect lives as a **resizable sidebar panel** within Agent Studio. You can expand, collapse, and resize the panel at any time to balance screen real estate between the main editor and the assistant.

<video src="https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/10e4d6a863abb97e8efa51a29ea3691da49aaf5d5c9be90c6ec3148a4205a261/docs/assets/video/agent-architect/opening-aa.mp4" autoPlay loop playsInline muted controls />

**Key interaction patterns:**

* **Open the panel** from the sidebar to start a session.
* **Ask questions** about how to build or configure your plugin.
* **Resize the panel** by dragging the edge to give yourself more or less room.
* **Collapse and reopen** the panel at any time — your conversation context is preserved so you can reclaim screen real estate when you need it.

<video src="https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/5cff6e77e1cb46c27c64c0e91e39a867e64efd4382199f1423e8dc109b6b01ba/docs/assets/video/agent-architect/panel-resize.mp4" autoPlay loop playsInline muted controls />

# Reasoning Modes

Agent Architect offers three reasoning modes that trade off between response quality and speed. You can select the appropriate mode depending on the complexity of your task.

| Mode       | Model                      | Best For                                                                                 |
| :--------- | :------------------------- | :--------------------------------------------------------------------------------------- |
| **High**   | GPT Gemini 3.1 Pro Preview | Complex architectural decisions, multi-step plugin design, and detailed troubleshooting  |
| **Medium** | Gemini 3 Flash             | General plugin building, configuration questions, and moderate-complexity tasks          |
| **Low**    | Gemini 2.5 Flashlight      | Quick lookups, simple syntax questions, and lightweight tasks where speed is prioritized |

<Callout intent="tip">
  Start with **Medium** for most tasks. Switch to **High** when you need deeper reasoning for complex plugin architectures, and use **Low** for fast, simple queries.
</Callout>

# Capabilities

Agent Architect can assist with the full range of plugin development tasks within Agent Studio.

## What Agent Architect Can Do

| Capability                      | Description                                                                                                  |
| :------------------------------ | :----------------------------------------------------------------------------------------------------------- |
| **Plugin Design Guidance**      | Get recommendations on plugin architecture, including how to structure conversational processes and actions. |
| **Configuration Assistance**    | Receive help writing and debugging DSL rules, data mapper configurations, and compound action patterns.      |
| **Slot & Resolver Strategy**    | Plan slot definitions, resolver strategies, and input argument mappings for your conversational flows.       |
| **Troubleshooting & Debugging** | Diagnose common errors, review logs, and get suggestions for fixing broken configurations.                   |
| **Best Practices & Cookbooks**  | Ask for recommendations based on established patterns from the Moveworks cookbook library.                   |
| **Code & Script Assistance**    | Get help writing Python scripts, HTTP action configurations, and compound action logic.                      |

<video src="https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/d201ef789981315a6f4b73b33fa5d6a52fd3f27c43178494e61b1429ac9cef32/docs/assets/video/agent-architect/talk-to-aa.mp4" autoPlay loop playsInline muted controls />

## Current Limitations

<Callout intent="warning">
  Agent Architect is currently a **copilot experience** — it advises and generates suggestions, but it **cannot directly modify your plugins**. You will always apply changes yourself in the Agent Studio editor.
</Callout>

* **Cannot update plugins directly.** Agent Architect provides guidance and code snippets, but all edits must be made manually by the developer.
* **Session-based context.** The assistant's understanding is scoped to your current conversation. For complex multi-session work, you may need to re-establish context.

# Getting Started

1. Open **Agent Studio** and navigate to any plugin you're working on.
2. Click the **Agent Architect** icon in the sidebar to open the panel.
3. Type your question or describe what you're trying to build.
4. Use the reasoning mode selector to choose **High**, **Medium**, or **Low** based on your task complexity.
5. Apply the suggestions from Agent Architect directly in your plugin editor.

{/* TODO: Add video showing the full getting started flow */}

<Callout intent="info">
  Agent Architect is available to all commercial Agent Studio users. No additional configuration or setup is required. It is not available in GovCloud at this time.
</Callout>