Caminhos de análise

Um caminho de análise é um nome amigável para uma tabela que analisa com frequência — como “Resultados operacionais” ou “a demonstração de resultados”. Registe-o uma vez e, a partir daí, o utilizador (e o seu assistente de IA ligado) pode fazer perguntas sobre ele por esse nome, sem repetir de cada vez a que projeto e a que tabela se refere.

Escolha um como predefinição da área de trabalho e perguntas simples como “porque subiu isto no último trimestre?” funcionam sem mais — o assistente já sabe a que se refere “isto”.

Nota

Os caminhos de análise são uma comodidade partilhada da área de trabalho: um administrador configura-os e, depois, qualquer pessoa na área de trabalho pode utilizá-los nas suas perguntas — através do Microsoft 365 Copilot ou de um agente de programação ligado por MCP. Cada pergunta continua a ser executada com as permissões de cada pessoa.

Porquê utilizá-los

Sem um caminho de análise, cada pergunta tem de indicar exatamente onde estão os dados — o projeto e a tabela —, o que se torna fastidioso depressa e é fácil de errar. Com um, fala dos seus dados da forma como realmente pensa neles:

• Pergunte pelo nome. “Resuma os Resultados operacionais.” em vez de “resuma a tabela ops_summary_v3 no projeto Enterprise Profitability.”
• Defina uma predefinição. Marque a tabela mais utilizada como predefinida e dispense o nome — “o que mudou desde o mês passado?” chega automaticamente aos dados certos.
• Mantenha todos coerentes. Quando toda a equipa se refere a “a demonstração de resultados”, todos chegam à mesma tabela — sem adivinhação, sem cópias desatualizadas.

Registar um caminho de análise

Se é administrador da área de trabalho, não precisa de um formulário nem de um ecrã de definições — basta pedir ao seu assistente de IA ligado, em linguagem simples, que registe o caminho por si:

“Registe um caminho de análise com o nome Resultados operacionais que aponte para a tabela ops_summary no projeto Enterprise Profitability.”

O assistente confirma o caminho e este fica imediatamente pronto a utilizar. Pode registar quantos quiser — um por cada tabela que analise regularmente.

Dica

Escolha nomes como a sua equipa fala: “Resultados operacionais”, “a Previsão”, “Efetivos”. Quanto mais amigável o nome, mais naturais se tornam as suas perguntas.

Definir um caminho predefinido

Como administrador, marque um caminho como predefinido para que as perguntas que não indicam uma tabela cheguem automaticamente a ele:

“Torne Resultados operacionais o caminho de análise predefinido.”

A partir daí, “quais foram as maiores variações neste trimestre?” ou “porque desceu o total?” são executadas sobre essa tabela sem mais nada a especificar. Existe uma única predefinição para toda a área de trabalho, pelo que as perguntas sem destino de todos se resolvem para a mesma tabela. Definir uma nova predefinição limita-se a transferir a coroa — só há sempre uma, e o assistente indica qual é.

Tornar um caminho útil para os assistentes de IA

Um nome e uma tabela dizem a um assistente onde estão os dados. Não lhe dizem o que os dados significam: que filtros se aplicam sempre, como funciona o seu ano fiscal, a que se referem as palavras da sua equipa. Sem isso, um assistente adivinha, e uma resposta errada e confiante é pior do que uma lenta. Esta secção abrange os dois locais onde coloca esse conhecimento e porque é que ambos importam.

Neste guia, assistentes de IA significa qualquer LLM ligado através do MCP do PlaidCloud (Claude, Microsoft Copilot, ChatGPT e outros) mais a IA integrada do PlaidCloud.

A Orientação do prompt determina a qualidade das respostas

Um caminho com boa Orientação do prompt e memorandos de coluna na sua tabela obtém respostas corretas e coerentes de todos os assistentes. Um caminho sem nenhum dos dois obtém o que o assistente deduzir a partir dos nomes das colunas. Dez minutos dedicados a estas duas coisas são a configuração de maior valor que pode fazer para um caminho.

Adicionar Orientação do prompt

Cada caminho de análise tem uma Orientação do prompt: texto livre, escrito por si, que diz aos assistentes como utilizar o caminho. Escreva uma diretiva por linha.

Para a adicionar, abra o menu Ferramentas e escolha Caminhos de análise, depois selecione um caminho e escolha Editar (ou escolha Novo para criar um). O campo Orientação do prompt segue-se a Tabela, imediatamente antes de Definir como predefinição da área de trabalho. Um assistente ligado com permissão para gerir caminhos de análise também a pode definir. Os chamadores de MCP e API veem este campo como description, por exemplo: “Defina a descrição do caminho Resultados operacionais como …”

Os assistentes utilizam a Orientação do prompt de duas formas:

1. Para escolher o caminho. Quando uma pergunta não indica um caminho, o assistente compara-a com o nome e a Orientação do prompt de cada caminho e escolhe a melhor correspondência.
2. Como orientação permanente. Depois de escolher um caminho, o assistente aplica a Orientação do prompt a todas as consultas a esse caminho: os filtros a incluir, a terminologia a traduzir. Para um assistente ligado por MCP, os próprios números de negócio provêm das definições de indicadores do projeto, não da orientação.

A Orientação do prompt é guardada com o caminho e é visível para todos na área de trabalho que possam ver caminhos de análise. Chega aos assistentes que trabalham através do MCP e à IA integrada do PlaidCloud. Não é transmitida à assistência de IA no passo LLM de um fluxo de trabalho.

O que escrever

Inclua o que um novo analista precisaria de ouvir no primeiro dia com esta tabela. Dê a cada diretiva a sua própria linha.

Escreva isto	Exemplo
As perguntas a que o caminho responde e as que não responde.	“Resultados operacionais mensais por unidade de negócio. Utilizar para perguntas sobre receita, custo e EBITDA. Não serve para efetivos nem previsões; utilize o caminho Previsão.”
Que indicador uma palavra de negócio designa, para assistentes ligados por MCP.	“‘Receita’ é o indicador Receita líquida. billed_amount é faturação, não receita.”
Filtros que se aplicam sempre.	“Excluir sempre scenario = 'Budget', salvo se perguntarem pelo orçamento. As linhas intragrupo têm entity_type = 'IC'; deixá-las de fora dos totais.”
Convenções de sinal, calendário e granularidade.	“Os custos são guardados como negativos. O ano fiscal começa em julho, pelo que o AF26 vai de jul. de 2025 a jun. de 2026. Uma linha por unidade de negócio por mês.”
Termos de negócio associados aos dados.	“‘O Midwest’ significa region IN ('IL','IN','OH','MI'). ‘Produtos principais’ significa product_tier = 'A'.”

Seja breve e específico. Uma diretiva por linha vale mais do que um parágrafo, e o limite é de 1000 carateres. Os espaços iniciais e finais são removidos.

Nota

Para um assistente ligado por MCP, a forma como um número de negócio é calculado — que coluna, somada como, sobre que linhas — pertence a uma definição de indicador, não à Orientação do prompt. A orientação diz que filtros e termos se aplicam ao caminho; um indicador diz o que é o número.

O que não escrever

• O que os assistentes já veem. Os tipos de coluna, as chaves e as contagens de linhas são devolvidos com a tabela. Repeti-los consome os seus 1000 carateres.
• O que significa uma coluna. Coloque isso num memorando de coluna para que fique com a coluna, onde quer que a tabela seja utilizada. A Orientação do prompt serve para indicar como utilizar o caminho no seu todo.
• Qualquer coisa confidencial. A Orientação do prompt é visível em toda a área de trabalho, não apenas para quem tem acesso ao projeto da tabela. Não inclua palavras-passe nem chaves, dados pessoais, nem valores e comentários que não mostraria a todos os membros da área de trabalho.

Orientação do prompt boa e fraca

Os dois exemplos abaixo são para o mesmo caminho, e a mesma pergunta é feita: “Qual foi o EBITDA do Midwest no ano passado?”

	Orientação fraca	Orientação boa
Texto	“Dados operacionais.”	“Resultados operacionais mensais por unidade de negócio. EBITDA = ebitda_adj; ignorar ebitda. Excluir scenario = 'Budget' e linhas intragrupo (entity_type = 'IC'). O ano fiscal começa em julho. Midwest = IL, IN, OH, MI.”
O que o assistente faz	Escolhe a coluna simples ebitda, inclui linhas de orçamento e intragrupo e interpreta “ano passado” como o ano civil.	Utiliza ebitda_adj, deixa de fora as linhas de orçamento e intragrupo, utiliza o último ano fiscal concluído e filtra pelos quatro estados do Midwest.
A resposta	Um número plausível, errado e diferente do da equipa financeira.	O número que a equipa financeira comunica.

A orientação fraca não é falsa. Limita-se a deixar todas as decisões à suposição do assistente.

Adicionar memorandos de coluna

A Orientação do prompt abrange o caminho no seu todo. Um memorando de coluna explica uma coluna e é assim que os assistentes ficam a saber o que uma coluna realmente contém. Quando a finalidade de uma coluna não é clara pelo nome, um memorando é a diferença entre a coluna certa e uma errada plausível.

Os memorandos na tabela do caminho são devolvidos aos assistentes de IA com a lista de colunas, em table_describe com include=['columns'], como memo em cada coluna que tenha um. As colunas sem memorando são devolvidas como antes. Os mesmos memorandos chegam à assistência de IA no passo LLM de um fluxo de trabalho, para as tabelas que este utiliza.

Quando é necessário um memorando

Adicione um memorando para	Memorando de exemplo
Códigos e abreviaturas	seg_cd: “Código do segmento de cliente: E = Grandes empresas, M = Médias empresas, S = PME.”
Medidas semelhantes	ebitda_adj: “EBITDA depois de removidos os itens extraordinários. Utilizar para relatórios; ebitda não está ajustado.”
Flags	is_ic: “1 se a linha for uma transação intragrupo. Excluir dos totais consolidados.”
Unidades ou moeda	amt_local: “Montante na moeda local da entidade, em milhares.”
Valores derivados ou alocados	alloc_cost: “Custo partilhado alocado a esta unidade por efetivos. Não incorrido diretamente.”

Dispense as colunas cujos nomes dizem tudo, como invoice_date ou customer_name. Um memorando que repete o nome não acrescenta nada.

Como adicionar um memorando

1. Abra a tabela do caminho no Explorador de tabelas.
2. Na barra de ferramentas, ative Propriedades da coluna.
3. Selecione a coluna na lista de colunas.
4. Introduza o texto em Memorando.

Um memorando definido na tabela aplica-se onde quer que a tabela seja utilizada, incluindo todos os caminhos de análise que apontem para ela.

Orientação do prompt ou memorando

Coloque cada facto num único local.

	Orientação do prompt	Memorando de coluna
Abrange	Como utilizar o caminho no seu todo	O que significa uma coluna
Conteúdo típico	Perguntas a que responde, filtros permanentes, calendário fiscal, termos de negócio	Códigos, unidades, flags, qual das semelhantes utilizar
Exemplo	“Excluir das totalizações as linhas intragrupo.”	is_ic: “1 se a linha for intragrupo.”

Aqui, o memorando diz o que is_ic significa e a Orientação do prompt diz o que fazer com isso.

Nota

Se a sua área de trabalho utiliza o Microsoft 365 Copilot: assim que a sua área de trabalho estiver nesta versão, reinstale o pacote do Copilot atualizado para obter as novas instruções. Consulte Microsoft 365 Copilot.

Utilizá-los

Depois de os seus caminhos estarem registados, basta perguntar:

1. Pelo nome — “Mostre-me as primeiras linhas dos Resultados operacionais.”

2. Pela predefinição — “O que mudou em relação ao último trimestre?” (sem tabela indicada — utiliza o caminho de análise predefinido da área de trabalho).

3. Mude à vontade — “Agora faça o mesmo para a Previsão.” O assistente acompanha, de caminho em caminho.

Isto combina naturalmente com perguntas sobre alocação — consulte Rastrear alocações — para que possa ir de “porque se alteraram os Resultados operacionais?” diretamente às contas e aos indutores que estão por trás.

Utilizá-los através do MCP

Quando um assistente ligado por MCP passa um caminho de análise a uma ferramenta, pode utilizar o nome do caminho (sem distinção de maiúsculas e minúsculas) ou o seu id. Um caminho atualizado com um id que não existe é recusado; para criar um novo caminho, omita o id.

query_data_read aceita analysis_path em vez de um projeto e uma tabela para table, json_paths, dimension_value, column_values e aggregate.

Pré-visualize apenas algumas colunas. Passe columns=[...] a query_data_read(action='table') para devolver apenas as colunas que indicar. As regras de acesso às linhas continuam a aplicar-se na íntegra. Não pode ser combinado com version_id.

Obtenha um total filtrado numa só chamada. Peça a column_values a medida e filtre pela coluna que lhe interessa:

query_data_read(
  action='column_values',
  project_id=<project>,
  table_id=<table>,
  dimension_column_name=<filter column>,
  value_column_name=<measure>,
  filters={<filter column>: <value>}
)

Devolve uma linha para esse valor. Quando o nome de uma coluna está mal escrito, o erro lista até cinco correspondências próximas para que o assistente possa corrigir e tentar de novo.

Totalize ou detalhe numa só chamada. Utilize action='aggregate' para agrupar por uma ou mais colunas e totalizar, calcular a média ou contar medidas no servidor, em vez de ler linhas:

query_data_read(
  action='aggregate',
  project_id=<project>,
  table_id=<table>,
  group_by=['Product'],
  measures=[{'column': 'Revenue', 'agg': 'sum'}, {'column': 'Volume'}],
  filters={'Fiscal Year': 2027},
  order_by='Revenue',
  limit=10
)

measures aceita em agg os valores sum (a predefinição), avg, min, max ou count; count também aceita '*'. Um valor de filters pode ser uma lista para corresponder a qualquer um de vários valores. limit tem por predefinição 50 e o máximo é 500. order_by indica uma medida ou uma coluna de grupo; as medidas são ordenadas da mais alta para a mais baixa. A resposta tem rows, total_groups e truncated, que é verdadeiro quando existem mais grupos do que os devolvidos por limit. As regras de acesso às linhas aplicam-se antes de os totais serem calculados.

Quem os pode configurar

Configurar caminhos de análise — registá-los e escolher a predefinição — é uma ação de administrador, para que os nomes partilhados se mantenham limpos e de confiança para todos. Depois de existirem, todos os membros da área de trabalho podem utilizá-los nas suas perguntas, vendo cada um apenas os dados que as suas próprias permissões permitem.

Relacionado

• Definições de indicadores — acorde uma vez como se calcula um número de negócio
• Respostas em que pode confiar — como o PlaidCloud classifica e ressalva cada resposta de IA
• Rastrear alocações — explique porque um resultado com nome se alterou
• Obtenção, fundamentação e caminhos de análise — onde os caminhos de análise se inserem na arquitetura de obtenção em geral
• Primeiros passos com agentes de programação com IA — ligue um assistente por MCP
• Microsoft 365 Copilot — utilize caminhos de análise a partir do Teams e do Outlook