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

# Cache de dados

> Adicione um cache de backend gerenciado ao seu aplicativo web para que o servidor faça o trabalho lento uma única vez e atenda todos os visitantes com rapidez.

## O que é

O **Cache de dados** permite que seu aplicativo web lembre os resultados de trabalhos lentos e os reutilize para todos os visitantes. O servidor do seu aplicativo faz o trabalho lento uma vez, salva a resposta e entrega essa resposta salva a todos que pedirem em seguida.

Um trabalho lento pode ser uma chamada a uma API externa, uma busca de dados no Google Sheets ou no Notion, ou uma consulta pesada ao banco de dados. Sem um cache de dados, seu servidor repete esse trabalho para cada visitante. Com um cache de dados, a maioria dos visitantes recebe a resposta salva imediatamente.

O cache de dados é uma instância Redis gerenciada que roda ao lado do servidor do seu aplicativo. Você não precisa de conta separada, chaves nem configuração. O Manus o ativa e escreve o código que o utiliza.

> [!NOTE]
>
> Um cache de dados não serve para todo aplicativo. Ele vale a pena quando muitos visitantes pedem os mesmos dados lentos. Se o seu site tem pouco tráfego, ou se suas páginas já são rápidas, provavelmente você não precisa de um. Não tem certeza? [Pergunte ao Manus](#ask-manus-whether-your-app-will-benefit) para verificar seu projeto primeiro.

### Quando um cache de dados ajuda

#### Dados ao vivo sem atingir o limite da API

Seu site mostra preços, clima ou placares esportivos ao vivo vindos de uma API externa. Cada visitante dispara uma nova chamada à API, então as páginas ficam mais lentas conforme o tráfego cresce. A maioria das APIs também limita as chamadas por minuto e pode bloquear seu site.

Com um cache de dados, seu servidor chama a API no máximo uma vez por minuto e atende todos os visitantes a partir do cache. A API recebe cerca de uma chamada por minuto, não importa quantos visitantes cheguem.

> "Minha página inicial mostra preços ao vivo da \[API]. Use o cache de dados integrado do Manus para buscá-los no máximo uma vez por minuto e atender todos os visitantes a partir do cache."

#### Páginas rápidas quando seu conteúdo fica no Google Sheets ou no Notion

Você mantém um cardápio, uma lista de produtos, uma agenda de eventos ou posts de blog em uma planilha ou em um banco de dados do Notion. Cada visualização de página chama esse serviço, o que adiciona espera e pode atingir os limites dele.

Com um cache de dados, seu servidor busca o conteúdo a cada poucos minutos e entrega aos visitantes a cópia salva. Suas edições continuam aparecendo no site em poucos minutos.

> "Meu site carrega o cardápio do Google Sheets. Use o cache de dados integrado do Manus para buscá-lo no máximo uma vez a cada 5 minutos e atender todos os visitantes a partir do cache."

#### Rankings e listas de "em alta agora" que continuam rápidos

Sua comunidade, quiz ou jogo mostra um ranking dos 100 melhores, uma lista de "mais populares da semana" ou estatísticas do site inteiro. Montar essa lista exige uma consulta pesada ao banco de dados, e a consulta fica mais lenta conforme seus dados crescem.

Com um cache de dados, seu servidor monta a lista uma vez por minuto e entrega a cópia salva. As pontuações continuam seguras no seu banco de dados.

> "Minha página de ranking está ficando lenta. Use o cache de dados integrado do Manus para montar o top 100 uma vez por minuto e entregar a lista salva."

#### Outras formas como os aplicativos usam um cache de dados

* **Totais de painéis.** Calcule as "vendas de hoje" uma vez por minuto em vez de a cada visualização de página.
* **Limites em janelas curtas.** Permita no máximo 20 tentativas de login por minuto a partir de um mesmo endereço IP.
* **Códigos que expiram.** Armazene códigos de verificação de e-mail que deixam de funcionar após 10 minutos.
* **Sessões para login personalizado.** Mantenha os usuários conectados quando seu aplicativo tem um sistema de login próprio. O login padrão do Manus não precisa disso.

### Quando você provavelmente não precisa de um

* **Seu site tem pouco tráfego.** Se poucos visitantes chegam, há pouco trabalho repetido a economizar.
* **Seu site não tem código de servidor.** Sites estáticos, landing pages e portfólios não podem usar um cache de dados. A hospedagem do Manus já faz cache dos arquivos deles.
* **Suas páginas já são rápidas.** Consultas pequenas ao banco de dados não precisam de cache.
* **Os dados nunca podem ser perdidos.** Pedidos, contas, pagamentos e conteúdo de usuários pertencem ao seu banco de dados.

## Como usar

### Pergunte ao Manus se seu aplicativo vai se beneficiar

**1. Abra as configurações do Cache de dados**

Abra seu projeto web e vá para **Configurações → Hospedagem** (**Settings → Hosting**). Encontre a seção **Cache de dados** (**Data cache**). Antes de você adicionar um cache de dados, ela mostra **Adicionar um cache de dados** (**Add a data cache**).

![A seção Cache de dados em Configurações, Hospedagem, antes de adicionar um cache de dados, com o botão Perguntar ao Manus.](https://mintcdn.com/docs-manus/uRrLxOT2Ia6qhFvR/images/website-builder/data-cache-card-add.png?fit=max\&auto=format\&n=uRrLxOT2Ia6qhFvR\&q=85\&s=334cb36c96bbad66c8cdbce4fce00ceb)

**2. Pergunte ao Manus**

Selecione **Perguntar ao Manus** (**Ask Manus**). O Manus prepara um prompt no chat. Envie o prompt. O Manus analisa seu projeto e informa quais páginas ficariam mais rápidas, quanto custaria e quais são as contrapartidas.

**3. Aprove o cache de dados**

Se você concordar, o Manus ativa o cache de dados e escreve o código que o utiliza.

**4. Teste e publique**

Teste seu aplicativo na Visualização e depois publique-o. Para mais detalhes, leia [Publicação](https://manus.im/docs/pt-br/website-builder/publishing.md).

Você também pode começar pelo chat. Descreva a página lenta e peça ao Manus para usar "o cache de dados integrado do Manus".

### Gerencie seu cache de dados

Depois que você adiciona um cache de dados, a seção **Cache de dados** mostra o status dele e o armazenamento utilizado.

![A seção Cache de dados depois de adicionar um cache de dados, com o status do Redis, o armazenamento utilizado e o botão Limpar cache.](https://mintcdn.com/docs-manus/uRrLxOT2Ia6qhFvR/images/website-builder/data-cache-card-active.png?fit=max\&auto=format\&n=uRrLxOT2Ia6qhFvR\&q=85\&s=6d01a190f35496ad979d64ab6f5c34a2)

* **Para limpar todos os dados em cache:** selecione **Limpar cache** (**Clear cache**) e confirme. Isso limpa os dados tanto da Visualização quanto do site publicado. Você precisa de permissão de escrita no banco de dados.
* **Para desativar o cache de dados:** peça ao Manus para desativá-lo. O Manus primeiro remove o código que depende dele e, em seguida, exclui o cache de dados e seus dados.

## O que você precisa saber

> [!WARNING]
>
> Os dados em cache são temporários. Eles podem ser excluídos a qualquer momento, então seu aplicativo precisa ser capaz de recriá-los. Mantenha registros importantes no seu banco de dados.

* **Ele vem desativado por padrão.** Você adiciona um cache de dados por projeto, e ele só acelera as partes do seu aplicativo que o utilizam.
* **Ele é para aplicativos web com servidor.** Não está disponível para projetos de Jogo ou Mobile. Se o seu projeto web ainda não tem servidor, o Manus adiciona um. Para mais detalhes, leia [Infraestrutura em Nuvem](https://manus.im/docs/pt-br/website-builder/cloud-infrastructure.md).
* **Ele não é um cache de páginas.** Ele não faz cache das suas páginas HTML, imagens ou scripts no navegador. Ele acelera o trabalho que seu servidor faz.
* **A Visualização e o site publicado compartilham um único cache de dados.** Dados gravados enquanto você testa na Visualização ficam visíveis no seu site ao vivo.
* **Publicar não limpa o cache de dados.** Peça ao Manus para definir um tempo de expiração nos dados em cache para que eles se atualizem sozinhos.
* **Seus dados são excluídos se o seu saldo de Nuvem acabar.** Depois que você recarregar, seu aplicativo começa com um cache de dados vazio.
* **Cópias de um projeto começam vazias.** A cópia de um projeto recebe seu próprio cache de dados novo, cobrado separadamente. Para mais detalhes, leia [Fazer uma cópia](https://manus.im/docs/pt-br/website-builder/make-a-copy.md).
* **Ele é cobrado do seu saldo de Nuvem, não dos créditos do Agente.** As cobranças usam primeiro sua cota gratuita de Nuvem e depois seu saldo pago de Nuvem. Para mais detalhes, leia [Uso e Preços](https://manus.im/docs/pt-br/website-builder/getting-started/usage-and-pricing.md).

| Item | Preço |
| - | - |
| Taxa mensal | \$0,75 por mês UTC em que o cache de dados estiver ativo no fim do mês |
| Comandos | \$0,30 por 100.000 comandos |
| Largura de banda | \$0,045 por GB |
| Armazenamento | \$0,375 por GB-mês |

## Dicas

* **Conte ao Manus sobre seu tráfego.** Mencione quantos visitantes você espera e quais páginas parecem lentas. Assim o Manus pode avaliar se um cache de dados vale a pena.
* **Mencione o recurso no seu prompt.** Escreva "o cache de dados integrado do Manus". Em sessões de chat mais antigas, o Manus pode, caso contrário, sugerir um provedor Redis externo.
* **Defina um tempo de expiração.** Um minuto é adequado para dados ao vivo. Alguns minutos são adequados para conteúdo vindo de uma planilha.
* **Não faça consultas com frequência excessiva.** Cada comando é cobrado. Uma verificação a cada segundo custa cerca de \$8,53 por mês sem benefício real.

## Perguntas frequentes

> [accordion] Como sei se meu aplicativo precisa de um cache de dados?
>
> Pergunte ao Manus. Selecione **Perguntar ao Manus** em **Configurações → Hospedagem → Cache de dados**, e o Manus analisa seu projeto. Como regra, um cache de dados ajuda quando muitos visitantes carregam os mesmos dados lentos.

> [accordion] Um cache de dados vai deixar meu site mais rápido?
>
> Ele acelera requisições repetidas que seu servidor processa, como chamadas a APIs externas e consultas pesadas. Ele não muda a forma como arquivos estáticos ou páginas chegam ao navegador.

> [accordion] Quanto custa?
>
> O custo depende de quantos comandos seu aplicativo envia. Estas estimativas usam preços de tabela e não são valores medidos:
>
> | Exemplo | Comandos por mês | Custo estimado por mês |
> | - | - | - |
> | Aplicativo pequeno: 20.000 visitas, 2 comandos cada | 40.000 | Cerca de \$0,88 |
> | Aplicativo movimentado: 1.000.000 de requisições, 3 comandos cada | 3.000.000 | Cerca de \$10,06 |

> [accordion] Como paro de pagar por ele?
>
> Peça ao Manus para desativar o cache de dados. Se você desativá-lo antes do fim do mês UTC, não paga a taxa de \$0,75 daquele mês.

> [accordion] Por que meu site ao vivo mostra dados antigos depois que publico?
>
> Publicar não limpa o cache de dados. Peça ao Manus para definir um tempo de expiração nos dados em cache ou selecione **Limpar cache**.

> [accordion] Por que meus usuários foram desconectados depois que limpei o cache de dados?
>
> Seu aplicativo pode armazenar as sessões de login no cache de dados. Limpar o cache exclui essas sessões. O login padrão do Manus não usa o cache de dados, então a limpeza não o afeta.

> [accordion] O Manus sugeriu um provedor Redis externo. O que devo fazer?
>
> Selecione **Perguntar ao Manus** em **Configurações → Hospedagem → Cache de dados** ou escreva "o cache de dados integrado do Manus" no seu prompt.

> [!TIP]
>
> **Não tem certeza se o cache é adequado para seu aplicativo?** Vá para **Configurações → Hospedagem → Cache de dados** e selecione **Perguntar ao Manus**. O Manus verifica seu projeto e informa se um cache de dados vai ajudar antes que você pague por qualquer coisa.


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