Microsoft 365 Copilot

Leve os seus dados do PlaidCloud para o Microsoft 365 Copilot. Depois que o agente PlaidCloud é instalado e uma pessoa recebe acesso, ela pode perguntar ao Copilot sobre seus projetos, tabelas, dimensões e modelos de alocação em linguagem natural, sem login separado, sem abrir uma janela do PlaidCloud e sem SQL.

“Liste meus projetos do PlaidCloud.” “Quais tabelas há em Enterprise Profitability? Mostre as primeiras linhas de uma delas.” “Por que o custo de TI alocado para o centro de custo de Atlanta aumentou no último trimestre?”

Nota

Isto é diferente do GitHub Copilot, que conecta o IDE de um desenvolvedor ao PlaidCloud. Esta página trata do Microsoft 365 Copilot, o assistente do Teams, do Outlook e do aplicativo Microsoft 365 que toda a sua equipe já usa.

Como funciona

O PlaidCloud publica um pequeno agente que se integra ao Microsoft 365 Copilot. Quando alguém faz uma pergunta ao Copilot sobre seus dados, o agente se conecta com segurança ao seu espaço de trabalho do PlaidCloud, executa a solicitação com as permissões da própria pessoa, e o Copilot explica a resposta.

• Somente leitura para a maioria das pessoas. O nível de acesso comum é somente leitura: listar e descrever projetos e tabelas, ler dados de tabelas, listar membros de dimensões e explicar resultados de alocação. Ele nunca inventa números; toda resposta vem de uma consulta real aos seus dados, e cada resposta traz um indicador de confiança e ressalvas em linguagem simples. Consulte Respostas em que você pode confiar.
• Cada pessoa vê apenas os próprios dados. As solicitações são executadas como o usuário conectado, limitadas pelas mesmas funções e controles de acesso do PlaidCloud que ele já tem. O agente nunca consegue acessar configurações de credenciais, identidade ou controle de acesso.
• Nenhum acesso até que seja concedido. Instalar o agente não equivale a conceder acesso. Uma pessoa conectada recebe uma mensagem clara “no access has been granted” até que um administrador do PlaidCloud lhe atribua um nível de acesso. Isso é proposital. Consulte Níveis de acesso.

Para saber o que acontece por trás desses pontos (o pacote do agente publicado, o cliente OAuth dedicado e como os níveis de acesso são resolvidos e aplicados), consulte Arquitetura do Copilot.

Configuração em resumo

O caminho completo, em ordem. Até três funções estão envolvidas, e muitas vezes a mesma pessoa acumula mais de um papel. As etapas 1 a 5 instalam o agente; a etapa 6 é o que realmente permite que os dados fluam.

#	Etapa	Quem	Onde
1	Baixar o pacote do agente (.zip)	Administrador do espaço de trabalho do PlaidCloud	Plano de controle do PlaidCloud → Workspaces
2	Permitir aplicativos personalizados	Administrador do Microsoft 365 / Teams	Centro de administração do Teams → Setup policies
3	Carregar o pacote	Administrador do Microsoft 365 / Teams	Centro de administração do Teams → Manage apps → Ações
4	Adicionar o agente no Copilot	Cada usuário	Microsoft 365 Copilot → More agents
5	Fazer login	Cada usuário	Copilot (uma vez)
6	Conceder um nível de acesso	Administrador do PlaidCloud	PlaidCloud

Cuidado

Até a etapa 6, o agente se conecta, mas não retorna dados. Um login bem-sucedido seguido de uma resposta “no access has been granted” significa que tudo está funcionando: a pessoa só precisa de um nível de acesso. Isso não é um erro.

Etapa 1 — Baixar o pacote do agente

O pacote do agente da sua organização é um único .zip, pronto para você baixar no plano de controle do PlaidCloud: não há nada a solicitar nem arquivo para esperar.

1. Faça login no plano de controle do PlaidCloud e abra Workspaces na navegação à esquerda.

2. Abra o espaço de trabalho que contém seus dados (a ação Editar ou Visão).

3. Na parte inferior da caixa de diálogo do espaço de trabalho, clique em Download Copilot Package e salve o .zip.

Nota

O botão Download Copilot Package só aparece depois que o PlaidCloud configura a conexão do espaço de trabalho com o Copilot. Se você não o vir, a conexão ainda não está pronta: entre em contato com seu representante do PlaidCloud. (O botão fica na tela Workspaces, não na tela Tenants, exclusiva de administradores.)

Etapa 2 — Permitir aplicativos personalizados

Administrador do Microsoft 365 / Teams. Por padrão, o Microsoft 365 bloqueia aplicativos que não vêm da loja pública, portanto o agente PlaidCloud não pode ser instalado até que você ative esta opção.

1. No centro de administração do Teams, acesse Teams apps → Setup policies → Global (Org-wide default).

2. Defina Upload custom apps como Em e clique em Salvar.

Cuidado

Ser administrador global não equivale a ter esta configuração ativada: ela é uma política separada. Se você a ignorar, o carregamento falha com “Uploading custom apps is not allowed.” As alterações de política podem levar até cerca de 24 horas para se propagar (muitas vezes bem menos). Para limitá-la a um grupo piloto em vez de toda a organização, crie uma política de configuração separada e atribua-a a esses usuários.

Etapa 3 — Carregar o pacote

Administrador do Microsoft 365 / Teams. Adicione o .zip ao catálogo de aplicativos da sua organização.

1. No centro de administração do Teams, acesse Teams apps → Manage apps.

2. Clique no menu Ações no canto superior direito da página e, em seguida, em Upload new app.

   Nota

   “Upload new app” fica no menu Ações no canto superior direito, e não na barra de ferramentas cinza (Edit installs / Edit availability / …), que age sobre um aplicativo já selecionado.

3. Escolha o .zip que você baixou. O aplicativo é carregado e publicado (você verá Published version 1.0.0), com suporte no Teams, no Outlook e no Copilot.

4. Na página do aplicativo, defina Availability: Everyone (org-wide default) para a implantação geral ou um grupo específico para um piloto.

Dica

Quer testar em você mesmo imediatamente, sem implantação para toda a organização? Pule o centro de administração: abra o Microsoft 365 Copilot e, em Agents, escolha carregar um aplicativo personalizado e selecione o .zip. Ele é instalado por sideload apenas para você e aparece na hora.

Etapa 4 — Adicionar o agente no Copilot

O agente agora precisa ser adicionado ao Copilot de cada pessoa.

1. Abra o Microsoft 365 Copilot (m365.cloud.microsoft/chat ou no Teams) e clique em More agents na lista Agents.

2. Encontre o agente PlaidCloud e clique em Adicionar. Ele passa a aparecer na lista Agents, pronto para ser aberto. O agente de todo espaço de trabalho se chama PlaidCloud; quando você tem mais de um, o nome do espaço de trabalho aparece na descrição do agente para diferenciá-los.

Nota

Um agente recém-publicado para toda a organização pode demorar a aparecer em More agents: minutos, às vezes algumas horas, enquanto a Microsoft o propaga. Um aplicativo instalado por sideload (a dica da etapa 3) aparece imediatamente. Para pré-instalar o agente para todos, sem que precisem adicioná-lo, fixe-o por meio de uma política de configuração do Teams.

Etapa 5 — Fazer login

Na primeira vez que uma pessoa abre o agente e faz uma pergunta, o Copilot pede que ela faça login. Essa é uma etapa normal, feita uma única vez.

1. Abra o agente e faça uma pergunta, por exemplo “Liste meus projetos do PlaidCloud.”

2. Quando solicitado, escolha Sign in e conclua o login no PlaidCloud.

Depois disso, a conexão é lembrada: as pessoas não precisam fazer login a cada vez nem a cada dia. Um novo login só é necessário ocasionalmente (aproximadamente uma vez por mês) ou se o acesso mudar.

Nota

O login é interativo mesmo que você já esteja no Microsoft 365: o Copilot abre a própria janela de login, que não usa a sua sessão existente. Isso é esperado. A janela exibe a marca do próprio PlaidCloud, portanto a tela de login do PlaidCloud é a correta a ser concluída.

Na primeira vez que o agente lê dados do PlaidCloud, o Copilot pergunta uma vez: “I’ll connect to PlaidCloud to help with this and future requests. You can manage access anytime in Settings.” Escolha Permitir. Depois disso, o agente executa suas consultas somente leitura sem perguntar de novo, de modo que uma pergunta com várias etapas é respondida de uma só vez. Todas as consultas de dados do PlaidCloud feitas pelo agente são somente leitura, e o acesso continua limitado ao que o nível de acesso, as permissões e a segurança em nível de linha do PlaidCloud da pessoa permitem.

Etapa 6 — Conceder um nível de acesso

Esta é a etapa que transforma “no access has been granted” em respostas reais. Depois que uma pessoa fez login, um administrador do PlaidCloud concede a ela um nível de acesso (consulte Níveis de acesso abaixo). O acesso é negado por padrão: sem nível atribuído, o agente se conecta, mas não retorna dados.

Cada nível é um grupo do PlaidCloud, e a pessoa pertence a um deles:

Nível	Grupo
Somente leitura	Microsoft 365 Copilot Read Only
Leitura/gravação	Microsoft 365 Copilot Read and Write
Completo	Microsoft 365 Copilot Full Access

Uma pessoa que não está em nenhum desses grupos recebe uma mensagem pedindo que solicite a um administrador que a adicione ao grupo Microsoft 365 Copilot Read Only (ou a um dos outros dois). Adicione-a ao grupo que corresponde ao acesso de que ela precisa.

Depois que um nível é concedido, a pessoa simplesmente pergunta de novo: não é preciso sair nem reinstalar. O acesso é verificado em tempo real a cada solicitação, portanto a próxima mensagem retorna dados.

Nota

Os níveis de acesso são gerenciados no PlaidCloud. Entre em contato com seu representante do PlaidCloud ou com o support@plaidcloud.com para que as pessoas recebam acesso (ou o alterem) ou, se o administrador do PlaidCloud gerencia a identidade diretamente, atribua o nível no gerenciamento de identidade do PlaidCloud.

Níveis de acesso

Todo usuário do Copilot no PlaidCloud tem um de três níveis. O nível é um teto para o que o agente pode fazer; dentro dele, as permissões do PlaidCloud da própria pessoa continuam valendo, de modo que o agente nunca pode mostrar nem alterar dados que ela ainda não alcançaria sozinha.

Nível	Ferramentas que o agente carrega	Pode gravar?	SQL bruto	Uso típico
Somente leitura	Apenas ferramentas de leitura e consulta: listar e descrever projetos e tabelas, ler dados de tabelas, listar membros de dimensões, explicar alocações.	Não. Apenas ler e descrever.	Somente consultas de leitura (SELECT e operações de conjunto); uma instrução que gravaria é recusada.	A maioria das pessoas. O padrão seguro.
Leitura/gravação	Tudo do nível somente leitura, mais as ferramentas de gravação que a pessoa tem permissão de usar, como atualizar dados de tabelas, editar nós de dimensões e carregar documentos.	Sim, apenas gravações estruturadas, cada uma ainda limitada pelas permissões da própria pessoa.	Somente consultas de leitura. As alterações passam pelas ferramentas de gravação, nunca por SQL de gravação bruto.	Analistas que mantêm dados.
Completo (obsoleto, será removido em 15 de janeiro de 2027)	O conjunto completo de ferramentas do PlaidCloud da pessoa, menos as ações sempre bloqueadas abaixo.	Sim, gravações estruturadas e SQL bruto que grava, limitados pela função de banco de dados da própria pessoa.	SQL de leitura e gravação.	Usuários avançados e construtores.

Algumas regras valem em todos os níveis:

• Negado por padrão. Nenhum nível atribuído ⇒ nenhum acesso. Nada é exposto até que alguém receba um nível.
• Prevalece o mais permissivo. Se uma pessoa tiver mais de um nível, vale o mais alto.
• Algumas ações nunca estão disponíveis para o agente, nem no nível Completo. As ferramentas de credenciais, identidade, controle de acesso e implantação de código continuam exclusivas de humanos, sejam quais forem as permissões da própria pessoa no PlaidCloud. Em nenhum nível o agente pode:
  • alterar credenciais ou controle de acesso: credenciais de conexões de dados e quem é dono de uma conexão ou tem acesso a ela, credenciais de repositórios de documentos e seu controle de acesso, controle de acesso de projetos, o modo de lançamento de ERP de um projeto, contas de membros, associação a grupos e funções, listas de distribuição, redefinições de senha ou publicação; e
  • implantar ou criar código: código de funções definidas pelo usuário, aplicativos JupyterLite ou aplicativos Panel.

Usar o agente

Abra o Copilot, selecione o seu agente PlaidCloud e pergunte em linguagem natural. Bons pontos de partida:

• Encontre o seu trabalho: “Liste meus projetos do PlaidCloud.” / “Quais tabelas há no projeto X?”
• Leia dados: “Mostre as primeiras 20 linhas da tabela de clientes.” / “Quais valores há na dimensão Região?”
• Explique resultados: “Por que o custo alocado para o centro de custo de Atlanta mudou entre o T1 e o T2?”
• Leve com você: “Exporte isto como uma planilha.” O agente cria um arquivo CSV, Excel, PowerPoint ou Word a partir dos dados que obteve.

O agente escolhe a ferramenta certa, executa a consulta nos seus dados e o Copilot responde, começando pelo resultado e depois mostrando uma tabela ou um resumo curto. Se uma solicitação precisar de dados aos quais você não tem acesso ou de uma alteração acima do seu nível, ele informa isso em vez de adivinhar.

Faça perguntas que levam a respostas diretas

O Copilot encontra o caminho de análise, o projeto e a tabela certos para uma pergunta de negócios, e lê qualquer erro retornado pelo PlaidCloud, corrige a solicitação e tenta de novo: você não precisa reformular a pergunta depois de um contratempo. Alguns hábitos tornam as respostas mais rápidas e mais exatas:

• Cite a medida e o filtro em palavras simples. “EBITDA do AF2027 em UDM, Alocado e DairyCheese” cita a medida (EBITDA) e os filtros (ano fiscal, unidade de medida, cenário, unidade de negócios). Um total filtrado volta em uma única consulta.
• Diga a qual escopo você se refere. Se um total puder ser de uma empresa inteira, de uma divisão ou de uma unidade de negócios, diga qual. Quando houver ambiguidade, o Copilot pergunta em vez de adivinhar.
• Confira os filtros informados pelo Copilot. Toda resposta lista os filtros aplicados. Se algum não for o que você queria, avise e o Copilot executa de novo.
• Cite o caminho de análise quando usar mais de um. Consulte Caminhos de análise.

Perguntas que ele responde bem

O agente funciona melhor com perguntas de negócios específicas. Exemplos:

Você pergunta	O que o agente faz
“EBITDA do AF2027 da DairyCheese em UDM, Alocado”	Retorna um total filtrado, usando sua definição de métrica quando existe e listando os filtros aplicados.
“Mostre receita, volume e custo por produto”	Totaliza todas as medidas de cada produto em uma única passagem por toda a tabela, em vez de uma amostra de linhas.
“Qual é o custo por libra da fábrica 12?”	Responde um valor nomeado, como US$/lb, com base na sua definição de métrica.
“Como o custo de TI é alocado aos centros de custo?”	Explica a metodologia dos seus modelos de alocação: quais direcionadores são usados e com que base.
“Exporte isto como uma planilha”	Cria um arquivo CSV, Excel, PowerPoint ou Word a partir dos dados que acabou de obter.

O agente também lê a descrição de cada caminho de análise para identificar filtros permanentes, convenções de sinal e seus termos de negócios, e os aplica a todas as perguntas sobre esse caminho.

Lista de verificação de configuração do administrador

O agente é tão preciso quanto o contexto que seus administradores fornecem. Depois de instalado:

1. Escreva uma descrição em cada caminho de análise. Diga o que é a tabela, suas convenções de sinal, os filtros que sempre se aplicam e seus termos de negócios. O agente a lê antes de cada consulta sobre esse caminho. Consulte Como tornar um caminho útil para assistentes de IA.
2. Defina as métricas de negócios que as pessoas pedem. Quando um projeto tem definições de métricas, o agente responde valores nomeados, como receita ou custo por libra, com base nelas, de modo que todos obtêm o mesmo número. Consulte Definições de métricas.
3. Mantenha o pacote atualizado. A criação de arquivos e as respostas sobre métricas, detalhamentos e metodologia de alocação exigem a versão 1.4.0 ou posterior do pacote. Baixe o pacote novamente e atualize-o.

Solução de problemas

Sintoma	Causa e solução
Não encontro Upload new app em Manage apps	Ele fica no menu Ações no canto superior direito da página, não na barra de ferramentas cinza. Se ele não aparecer de forma alguma, Permitir aplicativos personalizados ainda não está ativado.
“Uploading custom apps is not allowed” na instalação	A política Upload custom apps está desativada. Ative-a (etapa 2), aguarde a propagação e tente de novo.
O agente não está na lista Agents do Copilot	Procure em More agents e clique em Adicionar. Um agente publicado para toda a organização pode demorar a aparecer; para testar agora, instale o .zip por sideload para você mesmo.
“No Microsoft 365 Copilot access has been granted to this user”	Esperado até que um nível de acesso seja concedido. A pessoa está conectada e com a conexão estabelecida: só precisa de um nível. Pergunte de novo logo depois que ele for concedido.
“Ask an administrator to add you to the Microsoft 365 Copilot Read Only group” (ou de outro nível)	A pessoa ainda não está em um grupo de acesso do Copilot. Adicione-a ao grupo do nível de que ela precisa e peça que pergunte de novo.
O Copilot diz que não tem uma ferramenta para consultar o PlaidCloud	O pacote do agente está desatualizado. Atualize-o para a versão mais recente do plano de controle e inicie um novo chat.
Uma solicitação para alterar dados é recusada	O nível de acesso da pessoa (ou as próprias permissões dela no PlaidCloud) não permite essa gravação. Aumente o nível de acesso, se apropriado.
Pede-se que faça login de novo depois de ter funcionado	Normal: a conexão salva é renovada periodicamente (aproximadamente uma vez por mês). Faça login mais uma vez e continue.
As respostas parecem precisar de dados que a pessoa não alcança	Esperado: o agente só retorna dados que o usuário conectado já tem permissão para ver.
Um usuário somente leitura consegue fazer login, mas não consegue ler tabelas	Situação provisória, em tratamento: os usuários do Copilot com acesso somente leitura atualmente precisam de acesso mais amplo ao Analyze para ler tabelas. Entre em contato com support@plaidcloud.com.

Atualizar o pacote do agente

Quando o PlaidCloud lança uma nova versão do pacote do agente, um administrador o atualiza em três etapas:

1. Baixe o pacote novamente no plano de controle (Etapa 1).

2. No centro de administração do Teams, abra Manage apps, selecione o agente PlaidCloud e escolha Atualizar para carregar o novo .zip (Etapa 3).

3. Peça aos seus usuários que iniciem um novo chat com o agente. Um chat já aberto mantém o comportamento anterior.

Os níveis de acesso e os logins são mantidos; ninguém precisa fazer login de novo. Se o Copilot continuar usando a versão anterior depois da atualização, remova e adicione o agente novamente: abra o Agent Store, escolha o menu … do agente e Uninstall; depois, adicione-o de novo em Built by your org. Em seguida, inicie um novo chat.

Relacionados

• Arquitetura do Copilot: o que as etapas de configuração realmente fazem e como os níveis de acesso são aplicados
• Respostas em que você pode confiar: como o PlaidCloud classifica e ressalva cada resposta de IA
• Rastrear alocações: pergunte por que um resultado alocado mudou
• Caminhos de análise: dê nomes às suas tabelas principais para que toda a equipe pergunte sobre elas da mesma forma

Precisa de ajuda?

Você mesmo baixa o pacote do agente no plano de controle; consulte a Etapa 1. Para níveis de acesso, ou qualquer coisa que não esteja se comportando como descrito aqui, entre em contato com seu representante do PlaidCloud ou com support@plaidcloud.com.