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:
-
Gravações em lote — colete todos os itens e salve-os em uma única chave de armazenamento em uma única operação.
-
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.
-
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.
