Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]
Ao usar um interpretador de código, os agentes do Copilot Studio podem gerar e executar código Python quando precisam de responder a prompts do utilizador. O interpretador de código suporta tarefas como análise estatística, junções de tabelas, previsão e geração de gráficos. Estas tarefas funcionam com ficheiros estruturados como CSV e Excel.
Importante
Este artigo contém documentação de pré-visualização do Microsoft Copilot Studio e está sujeito a alterações.
As funcionalidades de pré-visualização não se destinam a utilização em produção e podem ter funcionalidades restritas. Esses recursos estão disponíveis antes de um lançamento oficial para que você possa obter acesso antecipado e fornecer feedback.
Se está a construir um agente pronto para produção, veja Microsoft Copilot Studio Overview.
A proposta de valor de usar um interpretador de código para analisar ficheiros de dados estruturados é:
- Ao usar computação determinística e reproduzível, pode desbloquear análises fiáveis dentro dos agentes, em vez de depender das capacidades matemáticas e de inferência inerentes aos grandes modelos de linguagem para responder a questões analíticas.
- Reduza a barreira de competências para análises avançadas permitindo que os utilizadores façam perguntas analíticas em linguagem natural.
- Gerar tabelas e visualizações de resultados programaticamente que os utilizadores possam ver, descarregar e reutilizar.
Os agentes do Copilot Studio podem usar o interpretador de código para analisar ficheiros estruturados fornecidos ao agente das seguintes duas formas:
- Como utilizador final, quando carregas ficheiros estruturados enquanto conversas com o agente.
- Como criador, quando adiciona a biblioteca de Documentos do SharePoint como fonte de conhecimento, que por sua vez contém os ficheiros estruturados.
Requerimentos
Licenciamento: Microsoft Copilot Studio faturação e licenciamento. A geração e execução de código contam como caraterísticas de ferramentas de texto e de IA generativa (premium).
Regiões suportadas: Disponível para todas as nuvens públicas. As clouds soberanas não são atualmente suportadas.
Cenários extensivamente testados
A Microsoft testou extensivamente os seguintes cenários com um elevado nível de confiança.
Observação
- Se o teu cenário não estiver entre os cenários listados nas tabelas, pode funcionar na mesma. Os cenários listados nas tabelas abaixo refletem o grupo de cenários que a Microsoft testou extensivamente com base no uso antecipado pelos clientes.
- O limite de tamanho para cada ficheiro que pode ser analisado por um interpretador de código, independentemente do tipo de ficheiro, é de 16 MB. Podes carregar um máximo de 10 ficheiros.
Cenários para ficheiros Excel (.xlsx)
| Categoria | Descrição do cenário | Exemplo 1 | Exemplo 2 | Exemplo 3 |
|---|---|---|---|---|
| Pesquisa - folha única | Recuperar um valor, etiqueta ou registo específico a partir de uma única folha de um ficheiro Excel. Não é necessário cálculo entre linhas. A resposta existe como uma pesquisa direta na célula/linha. Abrange valores numéricos, atributos de texto (nomes, funções, categorias) e carimbos temporais. | Que jogos incluem uma equipa a marcar no mínimo três golos? | Qual foi o fluxo de caixa livre no quarto trimestre de 2024? | A que segmento pertencem os combustíveis por grosso a partir do primeiro trimestre de 2024? |
Cenários para ficheiros .csv
| Categoria | Descrição do cenário | Exemplo 1 | Exemplo 2 | Exemplo 3 |
|---|---|---|---|---|
| Pesquisa - ficheiro único | Recupere um valor, atributo ou registo específico a partir de um único ficheiro CSV. Abrange consultas de entidades (contactos, aeroportos, projetos eólicos), recuperação de valor em determinado momento, e pesquisas em pequenas tabelas. Não é necessária agregação entre linhas. | Quem é o desenvolvedor do projeto Sunrise Wind? | Quantas motas estavam registadas no Tennessee em 1970? | Quem é o dono do aeroporto Horseshoe Landings em Keenesburg, CO? |
| Agregado - ficheiro único | Calcule totais, contagens, diferenças, resumos agrupados por grupo ou consultas ordenadas dentro de um único ficheiro CSV. Abrange agregações financeiras, contagens condicionais, recuperações ordenadas (máximo/mínimo) e resumos ao nível do grupo devolvidos como números, texto ou tabelas. | Qual foi o valor total dos royalties das vendas de petróleo onshore em 2019? | Quantos camiões mais foram registados na Califórnia em 2020 do que em 2010? | Qual é a receita total de vendas gerada por cada região em janeiro de 2025? |
| Consulta - múltiplos ficheiros | Una ou cruze referências de múltiplos ficheiros CSV para recuperar um valor ou lista específico (por exemplo, ao procurar inventário associando nomes de peças numa lista de peças, inventário e lista de preços; ou consultar dados de emissões associando nomes de setores ao ficheiro principal de emissões). | Quantos cortadores de jato de água estão disponíveis no armazém East? | Qual é o preço educacional de um torno 10x24? | Quantas brocas de 3/8" existem em stock no armazém East? |
| Agregado - vários ficheiros | Agregar ou comparar dados distribuídos por múltiplos ficheiros CSV (por exemplo, somar as horas dos funcionários entre CSVs mensais para um total trimestral, contar negócios entre exportações anuais de CSV, ou classificar setores por emissões através de ficheiros associados). | Quantas horas totais de trabalho foram registadas no terceiro trimestre? | Qual foi a hora mais cedo em que o Chris chegou em julho? | Qual setor produziu mais CO2 em 2020? |
Use o interpretador de código para análise de um ficheiro de dados estruturados carregado pelo utilizador
No Copilot Studio, selecione Configurações>IA Generativa. Na secção de capacidades de processamento de ficheiros, ativa a opção de carregar ficheiros .
Na secção de capacidades de processamento de ficheiros, ativa o alternador do interpretador de código.
Selecione Guardar.
No painel de teste, escreva uma consulta que exija que o agente realize um cálculo usando dados de um ficheiro de dados estruturados. Anexe o ficheiro de dados ao prompt.
Use um interpretador de código para análise de um ficheiro de dados estruturados como fonte de conhecimento SharePoint
Se o seu agente ainda não tiver um ficheiro de dados estruturados SharePoint como fonte de conhecimento, adicione este ficheiro de SharePoint como fonte de conhecimento.
No Copilot Studio, selecione Configurações>IA Generativa. Na secção de capacidades de processamento de ficheiros, ativa o alternador do interpretador de código.
Em Pesquisa, ativa o aterramento do grafo de inquilino com a opção de pesquisa semântica.
Selecione Guardar.
Se adicionou um ficheiro SharePoint seguindo as instruções no primeiro passo, publique o seu agente.
Teste o seu agente dando-lhe uma consulta que exija que o agente faça um cálculo para responder.