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

# AI Architect

> Generate and extend project data models from natural language prompts, with a preview step before you apply anything to your project.

## Overview

The AI Architect is a design-time agent that turns natural language descriptions into project data models. Describe the business entities you need, with their attributes, types, and relationships, and the AI Architect proposes a data model you can preview in the data model builder and apply to your project. Follow-up messages refine or extend the proposed model instead of starting over, so you can build up a model iteratively.

<Info>
  **Available starting with FlowX.AI 5.9.2.** The AI Architect is not available in 5.9.0 or 5.9.1 — it requires the 5.9.2 platform and AI Platform components.
</Info>

***

## Key capabilities

<CardGroup cols={2}>
  <Card title="Generate a data model from text" icon="keyboard">
    Describes-to-model: interprets a natural language description of your business domain and proposes entities, attributes, and types for your project data model.
  </Card>

  <Card title="Extend an existing model" icon="diagram-next">
    Follow-up messages continue the same conversation and extend or adjust the proposed model: add entities, rename attributes, or change types without regenerating from scratch.
  </Card>

  <Card title="Preview before applying" icon="eye">
    The proposed model renders as a preview in the data model builder graph, so you can inspect entities and attributes before anything is written to the project.
  </Card>

  <Card title="Apply to your project" icon="check">
    Applying the preview creates the entities and attributes in your project data model in one operation. {/* TODO: Verify with MT team — behavior when applied attributes collide with existing ones (protectExisting flag on the bulk create-update DTO). */}
  </Card>
</CardGroup>

***

## How to use

<Steps>
  <Step title="Open the data model builder">
    In your project, open the **Data Model** section.
  </Step>

  <Step title="Generate with AI">
    Select **Generate with AI** and describe the data model you need — the entities, their attributes, and how they relate. {/* TODO: Add screenshot — data model builder with the Generate with AI entry point. */}
  </Step>

  <Step title="Review the preview">
    The proposed model appears as a preview in the data model graph. Inspect the entities and attributes before accepting anything.
  </Step>

  <Step title="Refine with follow-ups">
    Send follow-up messages to extend or adjust the proposal. The agent continues the same thread instead of generating a new model.
  </Step>

  <Step title="Apply the model">
    When the preview matches what you need, apply it. The entities and attributes are created in your project data model. {/* TODO: Add screenshot — preview state with the apply action. */}
  </Step>
</Steps>

***

## Best practices

<Card icon="square-check" color="green" horizontal="true">
  **Describe entities and their relationships:**
  Name the business objects you need and how they relate. For example, "`a Customer with name, email, and date of birth, and a list of Accounts, each with an IBAN and a balance`".
</Card>

<Card icon="square-check" color="green" horizontal="true">
  **Refine instead of regenerating:**
  Use follow-up messages to add or adjust entities in the proposed model. The agent extends the existing proposal, which keeps the preview consistent.
</Card>

<Card icon="ban" color="red" horizontal="true">
  **Don't apply without reviewing the preview:**
  The preview exists so you can check attribute names and types against your conventions before they are created in the project.
</Card>

***

## Related resources

<CardGroup cols={2}>
  <Card title="AI Designer" icon="robot" href="./ai-designer">
    Generate UI layouts that map to your data model
  </Card>

  <Card title="AI Developer" icon="code" href="./ai-developer">
    Generate business rules and integration logic
  </Card>

  <Card title="Agent Builder" icon="hammer" href="../agent-builder/overview">
    Overview of AI agents and the Agent Builder
  </Card>
</CardGroup>