# Melhorar com IA

> O ícone Melhorar com IA dos campos de texto longo do app. A IA revisa o que você escreveu, mantém o idioma e a formatação e mostra o antes e o depois; o campo só muda se você usar o texto novo, e o texto não fica guardado. Em todos os planos.

Nos campos de texto longo do app há o ícone **Melhorar com IA** (as estrelinhas). Ele pede a uma IA que revise o que você escreveu: corrige, deixa mais claro e, se você pedir, muda o tom ou o tamanho. Você vê o texto de antes e o de depois e decide se usa.

Funciona em **todos os planos**, sem custo a mais, para qualquer pessoa que pode escrever no campo: membro, moderador, financeiro, administrador e proprietário.

## Onde aparece

| Campo | Onde fica o ícone |
|---|---|
| **Editor de texto formatado** (a barra com negrito, listas e links): posts, eventos, cursos e aulas, chamada de trabalhos e propostas, campanhas automáticas, pesquisas, downloads, classificados, feedbacks | Na ponta direita da barra do editor, com o rótulo **Melhorar** |
| **Campos de texto longo sem formatação**: descrição de produto, de plano, de espaço e de seção, mensagem do reconhecimento, chamado de suporte, post curto, legenda da galeria, entre outros | No canto inferior direito do campo |

Campos curtos, como título e nome, não têm o ícone. Com o campo vazio, o ícone fica desligado e a dica diz *"Escreva algo no campo para melhorar com IA"*.

## Como usar

1. Escreva o texto no campo e clique em **Melhorar com IA**. A janela mostra o seu texto em **Antes**.
2. Se quiser, escreva uma **Instrução (opcional)**: *mais curto*, *mais formal*, *tom mais leve* (até 500 caracteres).
3. Clique em **Melhorar**. A sugestão aparece em **Depois**, ao lado do original (no celular, embaixo).
4. Clique em **Usar este texto** para trocar o conteúdo do campo, ou em **Descartar** para deixar como estava. **Melhorar de novo** pede outra versão, com a mesma instrução ou com outra.

Nada é salvo nessa hora: o texto novo vai para o campo, e o post, o evento ou o produto só muda quando você salvar o formulário, como sempre.

## O que a IA faz e o que não faz

- Mantém o **idioma** do texto e a **formatação** (negrito, listas, links).
- É orientada a não acrescentar fatos, datas, preços ou nomes que não estavam no texto. Confira a sugestão antes de usar.
- Não escreve do zero a partir de um tema, não traduz e não cria imagem.
- Quando não há o que melhorar, a janela diz *"A IA não encontrou o que melhorar neste texto."*

## O seu texto

O texto e a instrução vão a um provedor de IA só para gerar a sugestão, e a Memberfy **não guarda** nenhum dos dois. Fica registrado apenas que o recurso foi usado: quem, em qual comunidade, em que tipo de campo e quando, nunca o conteúdo. Ver [Termos de uso › Dados pessoais](/conceitos/termos-de-uso#dados-pessoais).

## Limites e mensagens

| Mensagem | Por quê | O que fazer |
|---|---|---|
| *"O texto passa do limite de 20.000 caracteres. Encurte e tente de novo."* | Cada pedido aceita até 20.000 caracteres | Melhore o texto em partes |
| *"O texto sugerido passa do limite de … caracteres deste campo."* | O campo tem um limite menor que a sugestão | Peça um texto mais curto na instrução e clique em **Melhorar de novo** |
| *"Muitos pedidos em pouco tempo. Espere um pouco e tente de novo."* | Uma pausa contra abuso, para muitos pedidos seguidos da mesma pessoa; a mensagem diz o limite | O botão mostra *"Tente em … s"*; espere a contagem e tente de novo |
| *"Não foi possível melhorar agora. Seu texto continua como estava."* | A IA não respondeu a tempo | Tente de novo em instantes |
| *"A comunidade chegou ao limite mensal de usos de IA para texto do plano. Escreva sem a IA por enquanto ou fale com quem administra a comunidade."* | A cota **Usos de IA por mês** do plano acabou; volta no mês seguinte. Ver [Plano e extensões](/configuracoes/plano#as-cotas-do-plano) | Escreva sem a IA ou fale com quem administra a comunidade |

## Pelo assistente (MCP)

Não há ferramenta para isso: o assistente já escreve e reescreve o texto na conversa antes de criar o post, o evento ou o curso.

## Na API

`POST /api/ai/improve-text`, com o `X-CommunityId`, para qualquer papel da comunidade: `text` (até 20.000 caracteres), `fieldKind` (`post`, `event`, `product`, `course`, `lesson`, `call`, `proposal`, `campaign`, `feedback`, `recognition`, `classified`, `download`, `survey` ou `other`), `format` (`html`, `markdown` ou `plain`; a resposta vem no mesmo) e `instruction` opcional (até 500). Texto vazio ou acima do limite: `400`; muitos pedidos seguidos: `429`, com `Retry-After`; a IA não respondeu: `503`. Ver [Referência da API](/api/referencia).

## Relacionados

- [Termos de uso](/conceitos/termos-de-uso)
- [Conteúdo](/espacos/conteudo)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)