As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Trabalhando com dados em aplicativos no Quick
Você pode persistir e gerenciar dados em seus aplicativos no Quick Apps de várias maneiras.
## Built-in armazenamento de aplicativos
A maneira mais simples de manter os dados é com o armazenamento de aplicativos integrado. É um sistema de valores-chave que não requer configuração externa e é escalável para suportar um grande número de registros.
### Escopos de armazenamento
+ **Armazenamento privado** — Dados visíveis somente para o usuário atual. Use para configurações pessoais, preferências, filtros salvos, favoritos e estado por usuário.
+ **Armazenamento compartilhado** — Dados visíveis para qualquer pessoa com acesso ao aplicativo. Use para listas colaborativas, comentários, votos, configuração compartilhada e dados da equipe.
### Operações de armazenamento
| Operation | Privado | Compartilhado | Description |
| --- | --- | --- | --- |
| Colocar item | Sim | Sim | Armazene ou atualize um item de valor-chave. |
| Obter item | Sim | Sim | Recupere um item por chave. |
| Itens da lista | Sim | Sim | Listar itens com filtro de prefixo de chave opcional. |
| Excluir item | Sim | Sim | Remova um item pela chave. |
| Lista por tag | Não | Sim | Consulte itens compartilhados por tag (índice secundário). |
### Principais conceitos
+ **Tabelas** — agrupamentos lógicos para seus dados. Você define os nomes das tabelas; nenhuma configuração é necessária.
+ **Chaves** — Cada item tem uma chave exclusiva em sua tabela. As chaves podem ter até 255 caracteres.
+ **Valores — Valores** de seqüência de caracteres de até 350 KB. Use a serialização JSON para dados estruturados.
+ **Tags (somente compartilhadas)** — Cadeias de categorização opcionais em itens compartilhados. As tags permitem consultas eficientes por categoria.
+ **Modos de gravação** — UPSERT (padrão) sobrescreve os itens existentes. O INSERT falhará se a chave já existir, o que é útil para evitar duplicatas.
**nota**
Cada aplicativo tem armazenamento completamente separado. Os dados persistem nas sessões do usuário e nas recargas do aplicativo.
## Exportar dados
Você pode pedir ao agente que adicione a funcionalidade de exportação. O Apps in Quick suporta a exportação de dados como arquivos CSV, JSON, PDF e Excel por meio da API bridge. Você também pode fazer com que seu aplicativo grave instantâneos de dados em um espaço conectado. Isso serve como backup e disponibiliza os dados para outros recursos do Quick.
## Lidar com aprovações de gravação quando a inferência de IA está ativa
Quando um aplicativo usa inferência de IA e grava dados (no armazenamento compartilhado ou por meio de um conector de ação), você deve revisar e aprovar cada carga de gravação. Essa medida de segurança garante que você revise o AI-generated conteúdo antes que o aplicativo o persista.
Três estratégias podem reduzir a frequência das solicitações de aprovação:
1. **Gravações em lote** — colete todos os itens e salve-os em uma única chave de armazenamento em uma única operação.
1. **Separe a IA das gravações** — projete o aplicativo para que o processamento da IA e a persistência dos dados ocorram em ações distintas do usuário.
1. **Remova a inferência de IA quando não for necessária** — Se seu aplicativo não usa AI-generated conteúdo, certifique-se de que a integração da inferência de IA não esteja registrada. Sem inferência de IA, você pode escolher “Permitir neste aplicativo” para operações de gravação. A permissão persiste em todas as sessões.
## Acessando informações do usuário
Com os aplicativos no Quick, você pode acessar a identidade do usuário atual em tempo de execução. Isso permite que você personalize a experiência do aplicativo, exiba o nome do usuário ou implemente a lógica por usuário.
As informações disponíveis do usuário incluem e-mail, nome, sobrenome e nome de identidade.
**dica**
Combine a identidade do usuário com o armazenamento privado para criar experiências personalizadas, como saudações, preferências salvas, favoritos e painéis personalizados por usuário.