> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moda.app/llms.txt
> Use this file to discover all available pages before exploring further.

# How the AI Agent Works

> Understand how Moda's AI agent designs for you — its capabilities, process, and limitations.

When you create a design in Moda, an AI agent handles the entire design process. Here's how it works.

## The design process

The agent follows a multi-stage process:

<Steps>
  <Step title="Research" icon="magnifying-glass">
    If needed, the agent searches the web, analyzes uploaded files (PPTX, PDF, DOCX, XLSX/CSV, images), reads your brand kit, or scrapes a website URL for content and style reference.
  </Step>

  <Step title="Planning" icon="list-check">
    The agent outlines the structure of the design — what slides or sections to create, what content goes where.
  </Step>

  <Step title="Building" icon="hammer">
    The agent creates elements on the canvas: text, shapes, images, layouts, charts, and more.
  </Step>

  <Step title="Refinement" icon="wand-magic-sparkles">
    The agent reviews and adjusts the design, fixing alignment, styling, and visual consistency.
  </Step>
</Steps>

You can watch this happen in real time. The agent's thinking and progress are shown in the chat panel alongside the canvas.

## What the agent can do

The agent has access to a wide range of tools:

* **Create and edit design elements**: Text, shapes, images, icons, charts, tables, and more
* **Generate images**: Create AI-generated images and backgrounds using FAL AI
* **Search the web**: Research topics, find reference material, and gather content
* **Scrape websites**: Extract content and visual style from URLs
* **Read uploaded files**: Process PPTX, PDF, DOCX, XLSX/CSV, text files, and Google Slides
* **Apply brand kits**: Use your brand colors, fonts, logo, and visual style
* **Search for icons**: Find and insert icons that match your design
* **Generate QR codes**: Create QR codes for URLs
* **Fetch company logos**: Look up and insert logos for named companies

## Execution modes

Moda's agent can run in two modes:

* **Interactive (WebSocket)**: The default mode when you're working in the browser. The agent runs tools in your browser session, so you see changes in real time.
* **Headless (Job system)**: Used for API-triggered designs and background tasks. The agent runs on the server with a headless browser for operations like export.

## Iterating on designs

After the initial generation, you can continue chatting with the agent to refine the design:

* Ask it to change colors, fonts, or layout
* Request additional slides or sections
* Ask it to swap images or update text
* Give it feedback on what to improve

The agent maintains context from the conversation, so it understands what you've already discussed.