Gerencie dados no seu aplicativo (prévia)

Aplicativos frequentemente precisam de informações, como tarefas, ativos, solicitações ou registros de clientes. Ao criar um aplicativo no Microsoft Copilot Studio, você pode começar com dados de exemplo, guardar informações no navegador ou conectar o app a uma fonte de dados organizacional.

Este artigo explica as formas comuns como um app trabalha com dados e como conexões, identidade e permissões afetam as pessoas que o utilizam.

Maneiras comuns de aplicativos trabalharem com dados

Um aplicativo pode usar uma ou mais das seguintes abordagens.

Alguns aplicativos não precisam de armazenamento de dados. Por exemplo, uma calculadora ou conversor unitário pode produzir resultados sem precisar salvá-los. Um aplicativo também pode usar múltiplas fontes, sujeitas às capacidades e políticas do seu ambiente.

Escolha uma abordagem de dados

Use as seguintes perguntas para decidir como o app deve funcionar com os dados:

Comece com dados de amostra

Se você não conectar uma fonte existente, o Copilot Studio pode gerar dados de amostra que correspondem ao app que você descreveu. Dados de amostra facilitam a visualização e testagem de uma versão inicial do app.

Trate dados de exemplo como conteúdo representativo, não como um lugar para armazenar registros comerciais. Alterações feitas ao usar dados de amostra podem ser resetadas quando o app recarrega ou quando o Copilot Studio regenera parte do app.

Registros de amostra também podem ser incluídos no próprio aplicativo gerado. Como resultado, atualizar a prévia do app não é uma forma confiável de determinar onde um app armazena seus dados. Revise os Dados e Conexões do aplicativo antes de confiar nele para reter as informações.

Armazene os dados do aplicativo no navegador

Alguns aplicativos autônomos podem armazenar informações no navegador. Dados locais no navegador podem permanecer após uma atualização, mas não são o mesmo que dados organizacionais conectados.

Dados locais no navegador em geral:

• Está disponível apenas no perfil do navegador onde você criou
• Não é compartilhado automaticamente com outros usuários do app
• Pode não estar disponível em outro dispositivo
• Não é governado como um registro de dados do SharePoint, Dataverse ou outro dado conectado

Use uma fonte de dados organizacional quando precisar compartilhar registros, gerenciar dados centralmente ou disponibilizar dados entre dispositivos.

Armazene e use dados organizacionais

Dados organizacionais conectados podem suportar dois fluxos de trabalho relacionados:

• Armazenar registros que as pessoas criam ou atualizam pelo aplicativo
• Trabalhar com tabelas que sua organização já utiliza

A configuração pode variar conforme a fonte de dados. O Copilot Studio gerencia o processo de conexão suportado e gera a configuração do aplicativo necessária para trabalhar com os dados selecionados. Uma tabela conectada pode conter registros existentes e continuar recebendo novos registros do app.

Use listas do SharePoint

Use listas do SharePoint quando seu aplicativo precisar de dados de equipe simples e em formato de lista. Dependendo do cenário de pré-visualização suportado, o Copilot Studio pode conectar o aplicativo a uma lista existente ou criar novas listas em um site SharePoint que você possa usar.

O Copilot Studio pode perguntar a quais registros de aplicativos você quer armazenar, se deve usar um site SharePoint existente e a qual site as listas devem pertencer. Criar ou usar uma conexão pode exigir sua aprovação e permissão para o site e as listas selecionados.

Usar dados de tabelas Dataverse existentes

Use o Dataverse quando o app deve trabalhar com dados organizacionais estruturados que sua organização já gerencia em um ambiente Power Platform. Na prévia, o Copilot Studio conecta aplicativos a tabelas Dataverse existentes.

O Copilot Studio pode pedir que você selecione um ambiente, uma tabela e uma conexão do Dataverse. Você precisa ter permissão para usar a tabela selecionada e realizar as operações que o aplicativo exige.

Compare listas do SharePoint e Dataverse

Tanto as listas do SharePoint quanto o Dataverse armazenam dados organizacionais sob governança de administrador, mas atendem a necessidades diferentes. Se ambas as opções estiverem disponíveis, use a seguinte comparação para escolher a que melhor se encaixa.

Após conectar uma tabela do SharePoint ou Dataverse, revise os Dados e Conexões do aplicativo para confirmar qual fonte ele utiliza.

Conecte-se a outras tabelas existentes

Se sua organização já tem os dados que o app precisa, peça ao agente para conectar o app a essa fonte. Além de SharePoint e Dataverse, um aplicativo pode trabalhar com outras fontes tabulares disponíveis em seu ambiente, como Excel ou SQL.

Conexões de dados permitem que um aplicativo leia ou escreva linhas em uma fonte estruturada. A configuração exata varia de fonte para origem, mas o Copilot Studio orienta você na seleção dos dados e da conexão que o app deve usar.

Aprenda sobre as diferentes formas como um aplicativo pode usar um arquivo Excel ou CSV no Work with Excel e arquivos CSV. Outras fontes tabulares também podem estar disponíveis. A disponibilidade depende do ambiente do aplicativo. Revise e teste o resultado antes de publicar o app, especialmente quando os usuários podem adicionar, atualizar ou excluir registros.

Altere ou atualize uma conexão de dados

Se a fonte, estrutura da tabela ou conexão mudar, peça ao agente para atualizar a conexão de dados do app. Revise os campos atualizados e teste o app novamente antes de publicar. Evite mudar diretamente o código de conexão gerado.

Disponibilidade de conexão e políticas de administrador

Os aplicativos podem usar fontes de dados e conexões que estão disponíveis e permitidas em seu ambiente. Políticas de dados e outros controles de administrador determinam quais fontes e conexões estão disponíveis.

Os aplicativos do Copilot Studio podem ter acesso a um subconjunto do catálogo mais amplo de conectores. Aprenda como os administradores classificam e controlam conectores em políticas de dados.

Uma fonte de dados ou conexão pode estar indisponível por um dos seguintes motivos:

• Uma política bloqueia isso.
• O catálogo de conectores do ambiente não inclui isso.
• A conexão necessária não existe.
• Sua conta não tem permissão para usá-la.
• A licença necessária não está disponível.

Entre em contato com seu administrador se esperar que uma fonte de dados esteja disponível, mas não puder selecioná-la ou usá-la.

Trabalhar com arquivos Excel e CSV

Você pode usar arquivos de várias formas, dependendo se deseja fornecer contexto, conectar dados ao vivo ou permitir que usuários de aplicativos enviem um arquivo.

Anexe um arquivo enquanto cria um aplicativo

Selecione + no Chat para anexar um arquivo que forneça mais contexto ao agente. Por exemplo, um livro de exercícios pode ajudar o agente a entender os campos e informações que o aplicativo deve exibir. Anexar um arquivo como contexto não cria uma conexão duradoura com esse arquivo.

Conectar uma tabela do Excel

Quando o conector Excel está disponível, o Copilot Studio pode conectar um aplicativo a uma tabela em um workbook Excel. Essa conexão utiliza dados em tempo real em vez de um anexo de arquivo único. A pasta de trabalho deve conter uma tabela do Excel definida, e a disponibilidade e as permissões dos conectores ainda se aplicam.

Adicionar upload de arquivo a um aplicativo

O Copilot Studio também pode gerar uma experiência de aplicativo na qual o usuário seleciona um arquivo Excel ou CSV para o aplicativo processar no navegador. Nesse cenário, o arquivo é inserido no aplicativo em execução. Ela não se torna automaticamente uma fonte de dados compartilhada centralmente ou continuamente sincronizada.

Entenda identidade e permissões

Os aplicativos acessam os dados conectados em nome do usuário logado.

Essa condição significa:

• O app não dá automaticamente acesso a dados que não poderia usar de outra forma.
• Usuários diferentes podem ver dados diferentes com base em suas permissões.
• Um usuário pode precisar criar ou consentir com uma conexão na primeira vez que usa o aplicativo.
• Uma operação de dados conectados pode falhar se o usuário não tiver permissão para realizá-la.

Antes de publicar, teste o app com uma conta que tenha permissões semelhantes às dos usuários pretendidos.

Preparar os dados do aplicativo para publicação

Um fluxo de trabalho comum é:

1. Descreva o aplicativo e revise a prévia do aplicativo.
2. Aprimore seus campos, telas e ações usando dados de exemplo ou dados locais do navegador.
3. Conecte uma fonte de dados organizacional, seja ela configurada para o app ou já existente.
4. Revise os Dados e Conexões do app.
5. Teste com contas que representem os usuários pretendidos.
6. Publique o aplicativo.
7. Compartilhe o aplicativo e confirme separadamente que os usuários podem acessar os dados subjacentes.

Você também pode começar diretamente a partir de dados organizacionais existentes quando já sabe qual fonte o app deve usar.

Gerencie conexões no seu app

Quando um aplicativo funciona com uma fonte organizacional ou um serviço externo, ele faz isso por meio de um conector — um link pré-construído para um serviço como Outlook, SharePoint ou Dataverse. Uma conexão é o link autorizado entre seu app e um desses conectores. Conectores estão disponíveis para uma ampla gama de serviços da Microsoft e de terceiros; para navegar por eles, veja a referência de conectores.

Você não cria conexões manualmente. Descreva o que você quer que o app faça, e o Copilot Studio adiciona o conector que o app precisa. Por exemplo, pedir para o aplicativo enviar uma mensagem quando um registro é adicionado é o que adiciona uma conexão a um conector de e-mail. Para remover, basta pedir no chat para remover a conexão estabelecida.

As conexões afetam as pessoas que usam seu app das seguintes maneiras.

Se um conector que você espera não estiver disponível, uma política de administrador é o motivo mais comum. Entre em contato com seu administrador para saber quais conectores são permitidos no seu ambiente.

Revise conexões no seu aplicativo

Para ver quais conexões seu app usa, selecione o nome do app na barra de comandos e depois selecione Conexões. Cada conexão lista o ícone do conector, o nome e uma breve descrição do que ele faz. Você pode pesquisar na lista por nome ou descrição.

Solução de problemas de dados e conexões no seu app

• As mudanças desaparecem quando o app recarrega. O app pode estar usando dados de amostra ou outra fonte de dados temporária. Revise seus Dados e Conexões e peça ao agente que conecte uma fonte de dados organizacional.
• Os dados permanecem após a atualização, mas outros usuários não conseguem vê-los. O app pode estar usando armazenamento local no navegador. Informações locais no navegador não são compartilhadas automaticamente entre usuários, navegadores ou dispositivos.
• Uma fonte de dados ou conexão não está disponível. A fonte de dados pode estar indisponível ou bloqueada no ambiente. Confirme que a conexão existe e que a política do administrador, as permissões e o licenciamento a permitam.
• Um usuário pode abrir o aplicativo, mas não pode ver seus dados. Abrir o aplicativo não dá acesso aos dados aos quais ele está vinculado. Confirme que o usuário tem acesso à lista do SharePoint, à tabela do Dataverse, à pasta de trabalho ou a outra fonte e que forneceu consentimento para qualquer conexão necessária.
• Alterações em um arquivo anexado não aparecem no app. Um arquivo anexado fornece contexto para a criação do app, mas não é automaticamente uma conexão ativa. Conecte a tabela do Excel por meio de um conector disponível caso o aplicativo precise ler os dados atuais da pasta de trabalho.
• Uma fonte conectada mudou, mas o app ainda usa uma estrutura mais antiga. A conexão gerada pode precisar ser atualizada ou recriada para que o app possa usar o esquema atualizado. Revise a fonte e a conexão antes de alterar manualmente o código do app gerado.

Informações relacionadas

• Crie um aplicativo no Microsoft Copilot Studio
• Publique e compartilhe um aplicativo no Microsoft Copilot Studio