AI Entity Edit

# AI Entity Edit

## Introduction

**AI Entity Edit** is a powerful utility module for Drupal 11 that introduces a ChatGPT/Gemini-style conversational assistant interface for creating and editing content entities. Instead of filling out rigid, traditional forms, site administrators and content creators can interact with an AI agent that guides them step-by-step through the schema, generates placeholder content, handles drag-and-drop file uploads, and processes natural language editing commands.

Designed with a generalized architecture, it supports any `ContentEntityInterface` (including nodes, taxonomy terms, and custom entities) and features robust out-of-the-box support for nested **Paragraph reference fields** and multilingual interfaces (English and Hebrew).

---

## Features

* **Universal Entity Support:** Works seamlessly across content types, taxonomy vocabularies, and other Drupal content entities via dedicated AI assistant tabs (`/add/{bundle}/ai` and `/{entity}/ai`).
* **Conversational Wizard:** A modern, responsive chat interface with scrolling message history and a fixed input bar at the bottom.
* **Multilingual Proactive Greetings:** Automatically detects the current Drupal interface language (supporting English, Hebrew, and extensible to others) and greets the user proactively.
* **Smart Schema Inspection:** Dynamically inspects field types, labels, and required constraints to ensure all mandatory data is collected before saving.
* **Paragraph & File Drag-and-Drop:** Full support for nested paragraph components and a built-in drag-and-drop zone in the chat input for quick image and file uploads.
* **Natural Language Editing:** When editing existing entities, users can give conversational commands (e.g., *"change word X to Y"* or *"replace the featured image"*) without digging through form fields.
* **Configurable AI Models:** Centralized settings dashboard (`/admin/config/content/entity_ai`) to manage your Google Gemini API key, select your preferred model (e.g., `gemini-2.5-flash`, `gemini-2.5-pro`), and customize localized system prompts.

---

## Requirements

* Drupal 11
* Google Gemini API key (Free or Paid tier via Google AI Studio)
* Required core modules: `entity`, `field`, `file`, etc.

---

## Installation

1. Download or clone the module into your Drupal site's custom modules directory (`web/modules/custom/ai_entity_edit` or `web/sites/your-site/modules/custom/ai_entity_edit`).
2. Enable the module via the Extend page (`/admin/modules`) or using Drush:
```bash
drush en ai_entity_edit

```

---

## Configuration & Usage

1. Navigate to the configuration page at **Administration > Configuration > Content > AI Entity Settings** (`/admin/config/content/entity_ai`).
2. Enter your **Google Gemini API Key**, select your preferred **Gemini Model**, and customize the system prompts if desired. Save your configuration.
3. Go to any content creation or edit page (e.g., `/node/add/article` or an existing node).
4. Click on the **AI Assistant** local task tab to launch the chat interface, type `/start` (or follow the proactive prompt), and let the AI guide you through content creation!