Microsoft 365 Copilot

Leve os seus dados do PlaidCloud para o Microsoft 365 Copilot. Depois de o agente PlaidCloud estar instalado e de ser concedido acesso a uma pessoa, esta pode questionar o Copilot sobre os seus projetos, tabelas, dimensões e modelos de alocação em linguagem corrente, sem outro início de sessão, sem janela do PlaidCloud e sem SQL.

“Apresente os meus projetos do PlaidCloud.” “Que tabelas existem no Enterprise Profitability? Mostre as primeiras linhas de uma delas.” “Porque aumentou, no último trimestre, o custo de TI alocado ao centro de custo de Atlanta?”

Nota

Isto é diferente do GitHub Copilot, que liga o IDE de um programador ao PlaidCloud. Esta página trata do Microsoft 365 Copilot, o assistente do Teams, do Outlook e da aplicação Microsoft 365 que toda a sua equipa já utiliza.

Como funciona

O PlaidCloud publica um pequeno agente que se integra no Microsoft 365 Copilot. Quando alguém faz ao Copilot uma pergunta sobre os seus dados, o agente liga-se de forma segura à sua área de trabalho do PlaidCloud, executa o pedido com as permissões dessa mesma pessoa e o Copilot explica a resposta.

• Só de leitura para a maioria das pessoas. O nível de acesso mais comum é o de leitura: listar e descrever projetos e tabelas, ler dados de tabelas, listar membros de dimensões e explicar resultados de alocação. Nunca inventa números; cada resposta resulta de uma consulta real aos seus dados e inclui um sinal de confiança e ressalvas em linguagem corrente. Consulte Respostas em que pode confiar.
• Cada pessoa vê apenas os seus próprios dados. Os pedidos são executados com o utilizador que iniciou sessão, limitados pelas mesmas funções e controlos de acesso do PlaidCloud que já tem. O agente nunca consegue aceder às definições de credenciais, de identidade ou de controlo de acesso.
• Sem acesso até ser concedido. Instalar o agente não equivale a conceder acesso. Uma pessoa que inicie sessão recebe uma mensagem clara “no access has been granted” até que um administrador do PlaidCloud lhe atribua um nível de acesso. Isto é deliberado. Consulte Níveis de acesso.

Para saber o que acontece por detrás destes 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 resumida

O caminho completo, por ordem. Estão envolvidas até três funções, e a mesma pessoa assume muitas vezes mais do que uma. Os passos 1 a 5 instalam o agente; o passo 6 é o que permite efetivamente o fluxo de dados.

#	Passo	Quem	Onde
1	Transferir o pacote do agente (.zip)	Administrador da área de trabalho do PlaidCloud	Plano de controlo do PlaidCloud → Áreas de trabalho
2	Permitir aplicações personalizadas	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 utilizador	Microsoft 365 Copilot → More agents
5	Iniciar sessão	Cada utilizador	Copilot (uma só vez)
6	Conceder um nível de acesso	Administrador do PlaidCloud	PlaidCloud

Cuidado

Até ao passo 6, o agente liga-se mas não devolve dados. Um início de sessão bem-sucedido seguido de uma resposta “no access has been granted” significa que tudo está a funcionar: a pessoa só precisa de um nível de acesso. Não é um erro.

Passo 1: transferir o pacote do agente

O pacote do agente da sua organização é um único ficheiro .zip, que pode transferir diretamente a partir do plano de controlo do PlaidCloud, sem nada para pedir nem ficheiro para esperar.

1. Inicie sessão no plano de controlo do PlaidCloud e abra Áreas de trabalho na navegação à esquerda.

2. Abra a área de trabalho que contém os seus dados (a ação Editar ou Vista).

3. No fundo da caixa de diálogo da área de trabalho, clique em Download Copilot Package e guarde o .zip.

Nota

O botão Download Copilot Package só aparece depois de o PlaidCloud configurar a ligação ao Copilot da área de trabalho. Se não o vir, a ligação ainda não está pronta; contacte o seu representante do PlaidCloud. (O botão está no ecrã Áreas de trabalho, e não no ecrã Tenants, exclusivo de administradores.)

Passo 2: permitir aplicações personalizadas

Administrador do Microsoft 365 / Teams. Por predefinição, o Microsoft 365 bloqueia aplicações que não provenham da loja pública, pelo que o agente PlaidCloud não pode ser instalado enquanto não ativar esta opção.

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

2. Defina Upload custom apps como Em e, em seguida, Guardar.

Cuidado

Ser administrador global não equivale a ter esta definição ativada: é uma política à parte. Se a ignorar, o carregamento falha com “Uploading custom apps is not allowed.” As alterações de política podem demorar até cerca de 24 horas a propagar-se (muitas vezes bastante menos). Para a limitar a um grupo-piloto em vez de toda a organização, crie uma política de configuração separada e atribua-a a esses utilizadores.

Passo 3: carregar o pacote

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

1. No centro de administração do Teams, aceda a 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” está no menu Ações, no canto superior direito, e não na barra de ferramentas cinzenta (Edit installs / Edit availability / …), que atua sobre uma aplicação já selecionada.

3. Escolha o .zip que transferiu. A aplicação é carregada e publicada (verá Published version 1.0.0), com suporte no Teams, no Outlook e no Copilot.

4. Na página da aplicação, defina Availability: Everyone (org-wide default) para uma implementação geral ou um grupo específico para um piloto.

Dica

Pretende testá-lo de imediato em si próprio, sem implementação em toda a organização? Dispense o centro de administração: abra o Microsoft 365 Copilot e, em Agentes, escolha carregar uma aplicação personalizada e selecione o .zip. É instalada apenas para si e aparece de imediato.

Passo 4: adicionar o agente no Copilot

O agente tem agora de 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 de Agentes.

2. Encontre o agente PlaidCloud e clique em Adicionar. Passa então a aparecer na lista de Agentes, pronto a abrir. O agente de cada área de trabalho chama-se PlaidCloud; quando existe mais do que um, o nome da área de trabalho surge na descrição do agente para os distinguir.

Nota

Um agente recém-publicado para toda a organização pode demorar a aparecer em More agents: minutos, por vezes algumas horas, enquanto a Microsoft o propaga. Uma aplicação instalada manualmente (a sugestão no passo 3) aparece de imediato. Para pré-instalar o agente para todos, para que não tenham de o adicionar eles próprios, fixe-o através de uma política de configuração do Teams.

Passo 5: iniciar sessão

Na primeira vez que uma pessoa abre o agente e faz uma pergunta, o Copilot pede-lhe que inicie sessão. É um passo normal, feito uma única vez.

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

2. Quando lhe for pedido, escolha Sign in e conclua o início de sessão no PlaidCloud.

Depois disso, a ligação fica memorizada: as pessoas não iniciam sessão de cada vez, nem todos os dias. Só é necessário um novo início de sessão ocasionalmente (aproximadamente todos os meses) ou se o acesso mudar.

Nota

O início de sessão é interativo, mesmo que já esteja no Microsoft 365: o Copilot abre a sua própria janela de início de sessão, que não aproveita a sessão existente. É o comportamento esperado. A janela tem a marca do próprio PlaidCloud, pelo que o ecrã de início de sessão do PlaidCloud é o correto para concluir.

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. A partir daí, o agente executa as suas consultas só de leitura sem voltar a perguntar, pelo que uma pergunta com vários passos é respondida de uma só vez. Todas as consultas de dados do PlaidCloud feitas pelo agente são só de leitura, e o acesso continua limitado ao que o nível de acesso, as permissões e a segurança ao nível da linha do PlaidCloud da pessoa permitirem.

Passo 6: conceder um nível de acesso

Este é o passo que transforma “no access has been granted” em respostas reais. Depois de uma pessoa ter iniciado sessão, um administrador do PlaidCloud concede-lhe um nível de acesso (consulte Níveis de acesso abaixo). O acesso é negado por predefinição: sem nenhum nível atribuído, o agente liga-se mas não devolve dados.

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

Nível	Grupo
Só de leitura	Microsoft 365 Copilot Read Only
Leitura/escrita	Microsoft 365 Copilot Read and Write
Completo	Microsoft 365 Copilot Full Access

Uma pessoa que não pertença a nenhum destes grupos recebe uma mensagem a indicar que deve pedir 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 precisa.

Depois de concedido um nível, a pessoa volta a perguntar, sem necessidade de terminar sessão nem de reinstalar. O acesso é verificado em direto a cada pedido, pelo que a mensagem seguinte já devolve dados.

Nota

Os níveis de acesso são geridos no PlaidCloud. Contacte o seu representante do PlaidCloud ou support@plaidcloud.com para que as pessoas sejam incluídas (ou alteradas) ou, se o seu administrador do PlaidCloud gerir a identidade diretamente, atribua o nível na gestão de identidade do PlaidCloud.

Níveis de acesso

Cada utilizador do Copilot do PlaidCloud tem um de três níveis. O nível é um limite máximo do que o agente pode fazer; dentro dele, continuam a aplicar-se as permissões do PlaidCloud da própria pessoa, pelo que o agente nunca pode mostrar nem alterar dados a que a pessoa ainda não conseguisse aceder.

Nível	Ferramentas que o agente carrega	Pode escrever?	SQL em bruto	Utilização típica
Só de 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.	Apenas consultas de leitura (SELECT e operações de conjuntos); uma instrução que escrevesse é recusada.	A maioria das pessoas. A predefinição segura.
Leitura/escrita	Tudo o que o nível só de leitura inclui, mais as ferramentas de escrita que a pessoa pode utilizar, como atualizar dados de tabelas, editar nós de dimensões e carregar documentos.	Sim, apenas escritas estruturadas, cada uma limitada pelas permissões da própria pessoa.	Apenas consultas de leitura. As alterações passam pelas ferramentas de escrita, nunca por SQL de escrita em bruto.	Analistas que mantêm dados.
Completo (descontinuado; removido a 15 de janeiro de 2027)	O conjunto completo de ferramentas do PlaidCloud da pessoa, menos as ações sempre bloqueadas abaixo.	Sim, escritas estruturadas e SQL em bruto que escreve, limitadas pela função de base de dados da própria pessoa.	SQL de leitura e escrita.	Utilizadores avançados e construtores.

Algumas regras aplicam-se a todos os níveis:

• Negado por predefiniçã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, por algum motivo, mais do que um nível, aplica-se o mais elevado.
• Algumas ações nunca estão disponíveis para o agente, nem mesmo no nível Completo. As ferramentas de credenciais, identidade, controlo de acesso e implementação de código permanecem exclusivas de humanos, sejam quais forem as permissões do PlaidCloud da própria pessoa. O agente nunca pode, em nenhum nível:
  • alterar credenciais ou o controlo de acesso: credenciais de ligações de dados e quem é proprietário de uma ligação ou tem acesso a ela, credenciais de repositórios de documentos e respetivo controlo de acesso, controlo de acesso de projetos, o modo de lançamento ERP de um projeto, contas de membros, pertença a grupos e funções, listas de distribuição, reposições de palavra-passe ou publicação; e
  • implementar ou criar código: código de funções definidas pelo utilizador, aplicações JupyterLite ou Aplicações Panel.

Utilizar o agente

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

• Encontrar o seu trabalho: “Apresente os meus projetos do PlaidCloud.” / “Que tabelas existem no projeto X?”
• Ler dados: “Mostre-me as primeiras 20 linhas da tabela de clientes.” / “Que valores existem na dimensão Region?”
• Explicar resultados: “Porque mudou o custo alocado ao centro de custo de Atlanta entre o 1.º e o 2.º trimestre?”
• Levar consigo: “Exporte isto como folha de cálculo.” O agente cria um ficheiro 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 seguindo-se uma pequena tabela ou um resumo. Se um pedido exigir dados a que não tem acesso, ou uma alteração acima do seu nível, o agente di-lo em vez de adivinhar.

Fazer perguntas que obtêm respostas diretas

O Copilot encontra o caminho de análise, o projeto e a tabela certos para uma pergunta de negócio e, se o PlaidCloud devolver um erro, lê-o, corrige o pedido e tenta de novo, pelo que não precisa de reformular depois de um contratempo. Alguns hábitos tornam as respostas mais rápidas e mais exatas:

• Indique a medida e o filtro por palavras simples. “EBITDA do AF2027 em UDM, Allocated e DairyCheese” indica a medida (EBITDA) e os filtros (ano fiscal, unidade de medida, cenário, unidade de negócio). Um total filtrado é devolvido numa única consulta.
• Diga a que âmbito se refere. Se um total puder ser de uma empresa inteira, de uma divisão ou de uma unidade de negócio, diga qual. Quando é ambíguo, o Copilot pergunta em vez de adivinhar.
• Verifique os filtros que o Copilot indica. Cada resposta lista os filtros aplicados. Se algum não for o que pretendia, diga-o e o Copilot repete a consulta.
• Indique o caminho de análise quando utiliza mais do que um. Consulte Caminhos de análise.

Perguntas a que responde bem

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

Pergunta	O que o agente faz
“EBITDA do AF2027 da DairyCheese em UDM, Allocated”	Devolve um total filtrado, utilizando a sua definição de indicador quando existe e listando os filtros aplicados.
“Mostre a receita, o volume e o custo por produto”	Totaliza todas as medidas de cada produto numa única passagem por toda a tabela, em vez de uma amostra de linhas.
“Qual é o custo por libra da fábrica 12?”	Responde a um valor com nome, como um $/lb, a partir da sua definição de indicador.
“Como é alocado o custo de TI aos centros de custo?”	Explica a metodologia dos seus modelos de alocação: que indutores são utilizados e com que base.
“Exporte isto como folha de cálculo”	Cria um ficheiro 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 obter filtros permanentes, convenções de sinais e os seus termos de negócio, e aplica-os a todas as perguntas sobre esse caminho.

Lista de verificação da configuração para administradores

O agente só é tão preciso quanto o contexto que os seus administradores lhe dão. Depois de instalado:

1. Escreva uma descrição em cada caminho de análise. Diga o que é a tabela, as suas convenções de sinais, os filtros que se aplicam sempre e os seus termos de negócio. O agente lê-a antes de cada consulta nesse caminho. Consulte Tornar um caminho útil para assistentes de IA.
2. Defina os indicadores de negócio que as pessoas pedem. Quando um projeto tem definições de indicadores, o agente responde a valores com nome, como a receita ou o custo por libra, a partir delas, pelo que todos obtêm o mesmo número. Consulte Definições de indicadores.
3. Mantenha o pacote atualizado. A criação de ficheiros e as respostas sobre indicadores, desagregações e metodologia de alocação exigem a versão 1.4.0 do pacote ou posterior. Transfira novamente o pacote e atualize-o.

Resolução de problemas

Sintoma	Causa e solução
Não encontra Upload new app em Manage apps	Está no menu Ações, no canto superior direito da página, e não na barra de ferramentas cinzenta. Se não aparecer de todo, Permitir aplicações personalizadas ainda não está ativado.
“Uploading custom apps is not allowed” na instalação	A política Upload custom apps está desativada. Ative-a (passo 2), aguarde pela propagação e tente novamente.
O agente não está na lista de Agentes 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 manualmente o .zip para si.
“No Microsoft 365 Copilot access has been granted to this user”	Esperado até ser concedido um nível de acesso. A pessoa tem sessão iniciada e está ligada, só precisa de um nível. Volte a perguntar logo após a concessão.
“Ask an administrator to add you to the Microsoft 365 Copilot Read Only group” (ou de outro nível)	A pessoa ainda não pertence a um grupo de acesso do Copilot. Adicione-a ao grupo do nível de que precisa e peça-lhe que volte a perguntar.
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 a partir do plano de controlo e inicie uma nova conversa.
Um pedido para alterar dados é recusado	O nível de acesso da pessoa (ou as suas próprias permissões do PlaidCloud) não permite essa escrita. Se for adequado, aumente o seu nível de acesso.
É pedido novo início de sessão depois de já estar a funcionar	Normal: a ligação guardada é atualizada periodicamente (aproximadamente todos os meses). Inicie sessão mais uma vez e continue.
As respostas parecem precisar de dados a que a pessoa não consegue aceder	Esperado: o agente só devolve dados que o utilizador com sessão iniciada já tem permissão para ver.
Um utilizador só de leitura consegue iniciar sessão mas não consegue ler tabelas	Situação provisória, em resolução: os utilizadores do Copilot só de leitura precisam atualmente de um acesso de análise mais amplo para ler tabelas; contacte support@plaidcloud.com.

Atualizar o pacote do agente

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

1. Transfira novamente o pacote a partir do plano de controlo (passo 1).

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

3. Peça aos seus utilizadores que iniciem uma nova conversa com o agente. Uma conversa já aberta mantém o comportamento anterior.

Os níveis de acesso e os inícios de sessão mantêm-se; ninguém precisa de iniciar sessão novamente. Se o Copilot continuar a utilizar a versão anterior depois da atualização, remova e volte a adicionar o agente: abra o Agent Store, escolha o menu … do agente e Uninstall e, em seguida, adicione-o novamente a partir de Built by your org. Inicie depois uma nova conversa.

Relacionado

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

Precisa de ajuda?

O pacote do agente é transferido por si a partir do plano de controlo; consulte o passo 1. Para níveis de acesso, ou qualquer situação que não se comporte como descrito aqui, contacte o seu representante do PlaidCloud ou support@plaidcloud.com.