# Migliora con l'IA

> L'icona Migliora con l'IA dei campi di testo lungo dell'app. L'IA rivede ciò che hai scritto, mantiene la lingua e la formattazione e mostra il prima e il dopo; il campo cambia solo se usi il nuovo testo, e il testo non viene conservato. In tutti i piani.

I campi di testo lungo dell'app hanno l'icona **Migliora con l'IA** (le stelline). Chiede a un'IA di rivedere ciò che hai scritto: corregge, rende più chiaro e, se lo chiedi, cambia il tono o la lunghezza. Vedi il testo prima e dopo e decidi se usarlo.

Funziona in **tutti i piani**, senza costi aggiuntivi, per chiunque possa scrivere nel campo: membro, moderatore, finanza, amministratore e proprietario.

## Dove compare

| Campo | Dove si trova l'icona |
|---|---|
| **Editor di testo formattato** (la barra con grassetto, elenchi e link): post, eventi, corsi e lezioni, call for papers e proposte, campagne automatiche, sondaggi, download, annunci, feedback | All'estremità destra della barra dell'editor, con l'etichetta **Migliora** |
| **Campi di testo lungo senza formattazione**: descrizione di prodotto, di piano, di spazio e di sezione, messaggio del riconoscimento, ticket di assistenza, post breve, didascalia della galleria e altri | Nell'angolo in basso a destra del campo |

I campi brevi, come titolo e nome, non hanno l'icona. Con il campo vuoto, l'icona è disattivata e il suggerimento dice *"Scrivi qualcosa nel campo per migliorarlo con l'IA"*.

## Come usarla

1. Scrivi il testo nel campo e fai clic su **Migliora con l'IA**. La finestra mostra il tuo testo in **Prima**.
2. Se vuoi, scrivi un'**Istruzione (facoltativa)**: *più breve*, *più formale*, *tono più leggero* (fino a 500 caratteri).
3. Fai clic su **Migliora**. Il suggerimento compare in **Dopo**, accanto all'originale (sul telefono, sotto).
4. Fai clic su **Usa questo testo** per sostituire il contenuto del campo, oppure su **Scarta** per lasciarlo com'era. **Migliora di nuovo** chiede un'altra versione, con la stessa istruzione o con un'altra.

In quel momento non si salva nulla: il nuovo testo va nel campo, e il post, l'evento o il prodotto cambia solo quando salvi il modulo, come sempre.

## Cosa fa l'IA e cosa no

- Mantiene la **lingua** del testo e la **formattazione** (grassetto, elenchi, link).
- È istruita a non aggiungere fatti, date, prezzi o nomi che non erano nel testo. Controlla il suggerimento prima di usarlo.
- Non scrive da zero a partire da un tema, non traduce e non crea immagini.
- Quando non c'è nulla da migliorare, la finestra dice *"L'IA non ha trovato nulla da migliorare in questo testo."*

## Il tuo testo

Il testo e l'istruzione vanno a un fornitore di IA solo per generare il suggerimento, e Memberfy **non conserva** né l'uno né l'altra. Resta registrato solo che la funzione è stata usata: chi, in quale community, in quale tipo di campo e quando, mai il contenuto. Vedi [Termini d'uso › Dati personali](/conceitos/termos-de-uso#dati-personali).

## Limiti e messaggi

| Messaggio | Perché | Cosa fare |
|---|---|---|
| *"Il testo supera il limite di 20.000 caratteri. Accorcialo e riprova."* | Ogni richiesta accetta fino a 20.000 caratteri | Migliora il testo a parti |
| *"Il testo suggerito supera il limite di … caratteri di questo campo."* | Il campo ha un limite inferiore al suggerimento | Chiedi un testo più breve nell'istruzione e fai clic su **Migliora di nuovo** |
| *"Troppe richieste in poco tempo. Attendi un momento e riprova."* | Una pausa contro gli abusi, per molte richieste di fila dalla stessa persona; il messaggio indica il limite | Il pulsante mostra *"Riprova tra … s"*; attendi il conto alla rovescia e riprova |
| *"Impossibile migliorare ora. Il tuo testo è rimasto com'era."* | L'IA non ha risposto in tempo | Riprova tra qualche istante |
| *"La community ha raggiunto il limite mensile di utilizzi dell'IA per i testi del suo piano. Scrivi senza IA per ora o parla con chi gestisce la community."* | La quota **Utilizzi di IA al mese** del piano è finita; torna il mese successivo. Vedi [Piano ed estensioni](/configuracoes/plano#le-quote-del-piano) | Scrivi senza IA o parla con chi gestisce la community |

## Con l'assistente (MCP)

Non c'è uno strumento per questo: l'assistente scrive e riscrive già il testo nella conversazione prima di creare il post, l'evento o il corso.

## Nell'API

`POST /api/ai/improve-text`, con l'`X-CommunityId`, per qualsiasi ruolo della community: `text` (fino a 20.000 caratteri), `fieldKind` (`post`, `event`, `product`, `course`, `lesson`, `call`, `proposal`, `campaign`, `feedback`, `recognition`, `classified`, `download`, `survey` o `other`), `format` (`html`, `markdown` o `plain`; la risposta arriva nello stesso) e `instruction` facoltativa (fino a 500). Testo vuoto o oltre il limite: `400`; troppe richieste di fila: `429`, con `Retry-After`; l'IA non ha risposto: `503`. Vedi [Riferimento API](/api/referencia).

## Correlati

- [Termini d'uso](/conceitos/termos-de-uso)
- [Contenuti](/espacos/conteudo)
- [Ruoli e permessi](/conceitos/papeis-e-permissoes)