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

# Amalia: IA soberana em português europeu

> Pergunta à Amalia sobre a tua marca, vê se ela te cita nos teus prompts e valida artigos em português europeu e no tom de voz da marca. Os dados não saem da UE.

> [!WARNING]
>
> A Amalia está em **beta**. Estamos a avaliá-la no programa de incubação da BSC AI Factory, por isso ainda não aparece em todos os workspaces. Se não a vês no menu da marca, [fala connosco](https://semantika.pt/fala-connosco).

A Amalia traz para a Semantika o **AMALIA**, um modelo de linguagem aberto criado para o português de Portugal por um consórcio de universidades e centros de investigação portugueses. Na Semantika, corre em infraestrutura própria na UE. Os dados que lhe envias não saem da UE.

Sabe mais sobre o projeto em [semantika.pt/amalia](https://semantika.pt/amalia).

Usa-a para três coisas:

> [card] Perguntar
>
> Faz perguntas sobre a tua marca e lê a resposta em português de Portugal.

> [card] Monitorização
>
> Corre os prompts da marca na Amalia e vê em quais a marca é citada.

> [card] Validador de artigos
>
> Revê um artigo antes de publicar: português europeu, tom da marca, clareza e afirmações sem fonte.

> [!NOTE]
>
> A Amalia responde **sem pesquisa web**. Mostra o que o modelo sabe, não o que está publicado hoje. Confirma os factos antes de os usar.

## Onde a encontrar

Abre a marca e escolhe **Amalia** no menu lateral. A página tem três separadores: **Perguntar**, **Monitorização** e **Validador de artigos**.

## Perguntar

Uma conversa com a Amalia sobre a marca aberta.

**1. Escreve a pergunta**

Escreve em português no campo **Faz a tua pergunta…**. Por exemplo: "Como descreverias a minha marca a um estudante?"

**2. Envia**

Clica em **Perguntar**. Enquanto a resposta não chega, vês "A Amalia está a pensar…". A resposta pode demorar perto de um minuto.

**3. Continua a conversa**

A Amalia tem em conta as últimas perguntas e respostas, por isso podes fazer perguntas de seguimento.

Cada resposta mostra a hora e quantos segundos a Amalia demorou.

Se a Amalia não responder a tempo, a mensagem fica a vermelho. Clica no ícone ao lado para perguntar outra vez.

A conversa é tua e da marca aberta. Os outros utilizadores do workspace não a veem.

## Monitorização

Corre os prompts da marca na Amalia para ver se ela cita a marca quando responde.

**1. Corre os prompts**

Clica em **Correr todos na Amalia**. A Amalia responde a todos os prompts ativos da marca, um de cada vez. Enquanto corre, o botão mostra "A correr na Amalia…" e cada prompt por responder mostra um indicador de carregamento.

**2. Lê o resultado de cada prompt**

Cada prompt respondido tem uma etiqueta:

* **Citada · 1.ª**, **Citada · 2.ª**, …: a marca aparece na resposta. O número é a posição da marca face aos concorrentes. **1.ª** quer dizer que a marca foi nomeada antes de qualquer concorrente.
* **Não citada**: a marca não aparece na resposta.

**3. Abre a resposta**

Clica num prompt para ver a **Resposta da Amalia**. O nome da marca aparece a negrito.

Por cima da lista, vês o resumo da última ronda. Por exemplo: "Marca citada em 3 de 10 prompts · última run hoje, às 14:30".

Cada nova ronda substitui o resultado anterior de cada prompt.

> [!NOTE]
>
> Os resultados da Amalia **não contam para a pontuação de visibilidade**. São uma leitura à parte do que o modelo sabe sobre a tua marca. A visibilidade nos [motores de IA](https://docs.semantika.pt/concepts/ai-engines.md) continua a ser medida nas análises.

Se a marca não tiver prompts, vês "Esta marca não tem prompts para correr na Amalia." Adiciona prompts à marca primeiro. Vê o [guia de início](https://docs.semantika.pt/quickstart.md).

## Validador de artigos

Revê um artigo antes de o publicar. A Amalia assinala o que não está em português europeu, o que foge ao tom da marca, as frases difíceis de ler e as afirmações sem fonte.

**1. Prepara o artigo**

* Em **Tom de voz**, escolhe um dos tons da marca. O tom por defeito vem já escolhido.
* Preenche o **Título do artigo**.
* Escreve ou cola o texto no editor. Podes usar negrito, itálico, sublinhado, títulos, listas e links. O contador por baixo mostra o número de palavras.

**2. Valida**

Clica em **Validar artigo**. O botão só fica ativo com tom, título e texto preenchidos. Enquanto vês "A validar…", o texto fica bloqueado. A validação pode demorar alguns minutos.

**3. Revê as sugestões**

Cada problema fica sublinhado no texto, com a cor da sua categoria. Clica num sublinhado, ou no problema na lista ao lado, para ver a sugestão e decidir:

* **Aceitar**: troca o trecho pela sugestão.
* **Ignorar**: deixa o texto como está.
* **Marcar como revisto**: aparece nas afirmações a verificar, que não trazem sugestão de texto.

**4. Copia o texto**

Clica em **Copiar texto corrigido**. O texto copiado leva as sugestões que aceitaste e as que ainda não decidiste. As que ignoraste ficam de fora.

### O que a Amalia assinala

| Categoria | Problema | O que fazer |
| - | - | - |
| **Tom da marca** | Tom demasiado exagerado para a marca | Aceita a versão mais sóbria ou reescreve. |
| **Clareza** | Frase demasiado longa | Aceita a versão mais curta ou divide a frase. |
| **Afirmações a verificar** | Estudo e percentagem sem fonte | Indica o estudo e a data, ou remove o número. |
| **Afirmações a verificar** | Número sem fonte | Indica a fonte, ou remove o número. |

### Pontuação

O **Resultado da validação** mostra uma pontuação de 0 a 100. Quantos menos problemas por resolver, mais alta a pontuação. Sobe sempre que aceitas, ignoras ou marcas um problema como revisto.

Se a Amalia não encontrar nada, vês "Nenhuma melhoria identificada". Nesse caso, o botão passa a **Copiar artigo**.

> [!WARNING]
>
> A Amalia assinala afirmações a confirmar, mas **não verifica se os factos são verdadeiros**. Essa revisão continua a ser tua.

### Mudar o texto e validar outra vez

Depois da validação, o texto fica só de leitura, exceto pelas sugestões que aceitas. Para o alterar:

1. Clica em **Editar texto**. As sugestões desaparecem e o editor volta a aceitar alterações.
2. Faz as alterações.
3. Clica em **Validar novamente**.

## Chamadas e tokens

No topo da página vês dois contadores:

* **Chamadas**: quantos pedidos foram feitos à Amalia este mês.
* **Tokens**: quanto texto a Amalia leu e escreveu este mês.

Cada contador mostra o uso face ao limite mensal do workspace. Os contadores somam o uso de todo o workspace, em todas as marcas e nos três separadores. Recomeçam no início de cada mês.

| Ação | Chamadas usadas |
| - | - |
| Uma pergunta em **Perguntar** | 1 |
| **Correr todos na Amalia** em **Monitorização** | 1 por prompt |
| **Validar artigo** | 1 |

## Limites

* **Pensada para português.** A Amalia responde em português de Portugal. Escreve as perguntas e os artigos em português para melhores resultados.
* **Sem pesquisa web.** As respostas refletem o que o modelo sabe, que pode estar desatualizado.
* **Respostas lentas.** Uma pergunta pode demorar perto de um minuto. Uma validação pode demorar alguns minutos.
* **Tamanho.** Uma pergunta aceita até 4000 caracteres. Um artigo aceita até 10 000 caracteres.
* **Fora da pontuação.** A monitorização da Amalia não entra na pontuação de visibilidade nem nos dashboards.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.