# Melhorar com IA

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

Nos campos de texto longo da app há o ícone **Melhorar com IA** (as estrelinhas). Pede a uma IA que reveja o que escreveu: corrige, torna mais claro e, se pedir, muda o tom ou o tamanho. Vê o texto de antes e o de depois e decide se o usa.

Funciona em **todos os planos**, sem custo adicional, 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 ligações): posts, eventos, cursos e aulas, chamada de trabalhos e propostas, campanhas automáticas, inquéritos, 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 secção, mensagem do reconhecimento, pedido de suporte, post curto, legenda da galeria, entre outros | No canto inferior direito do campo |

Os 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 telemóvel, por baixo).
4. Clique em **Usar este texto** para substituir o conteúdo do campo, ou em **Descartar** para deixar como estava. **Melhorar novamente** pede outra versão, com a mesma instrução ou com outra.

Nada é guardado nesse momento: o texto novo vai para o campo, e o post, o evento ou o produto só muda quando guardar 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, ligações).
- É orientada a não acrescentar factos, datas, preços ou nomes que não estavam no texto. Confira a sugestão antes de a usar.
- Não escreve do zero a partir de um tema, não traduz e não cria imagens.
- Quando não há nada a 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 para um fornecedor de IA apenas para gerar a sugestão, e a Memberfy **não guarda** nenhum dos dois. Fica registado apenas que o recurso foi usado: quem, em que comunidade, em que tipo de campo e quando, nunca o conteúdo. Ver [Termos de utilização › Dados pessoais](/conceitos/termos-de-uso#dados-pessoais).

## Limites e mensagens

| Mensagem | Porquê | O que fazer |
|---|---|---|
| *"O texto ultrapassa o limite de 20.000 caracteres. Encurte-o e tente novamente."* | Cada pedido aceita até 20.000 caracteres | Melhore o texto por partes |
| *"O texto sugerido ultrapassa o limite de … caracteres deste campo."* | O campo tem um limite menor do que a sugestão | Peça um texto mais curto na instrução e clique em **Melhorar novamente** |
| *"Demasiados pedidos em pouco tempo. Aguarde um pouco e tente novamente."* | Uma pausa contra abusos, para muitos pedidos seguidos da mesma pessoa; a mensagem indica o limite | O botão mostra *"Tente em … s"*; aguarde a contagem e tente novamente |
| *"Não foi possível melhorar agora. O seu texto continua como estava."* | A IA não respondeu a tempo | Tente novamente dentro de instantes |
| *"A comunidade atingiu o limite mensal de utilizações de IA para texto do plano. Escreva sem a IA por agora ou fale com quem administra a comunidade."* | A quota **Usos de IA por mês** do plano acabou; volta no mês seguinte. Ver [Plano e extensões](/configuracoes/plano#as-quotas-do-plano) | Escreva sem a IA ou fale com quem administra a comunidade |

## Pelo assistente (MCP)

Não há ferramenta para isto: 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 utilização](/conceitos/termos-de-uso)
- [Conteúdo](/espacos/conteudo)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)