Utilizar o interpretador de código em exemplos de pedidos

Os seguintes exemplos demonstram a funcionalidade do intérprete de código para processar pedidos complexos.

Os exemplos partem do pressuposto de que iniciou um novo pedido e ativou o intérprete de código nas definições do pedido.

Exemplo de cenário 1: pedido do intérprete de código para auditar transações

O gestor de compras da Contoso audita regularmente as transações de compra. Recebem um relatório PDF periódico que identifica os fornecedores de alto risco e segue uma política que exige notas de encomenda para transações superiores a 10.000 USD. O gestor de compras usa o PDF para auditar as transações no Excel. O gestor de compras usa pedidos com o intérprete de código para automatizar o processo de auditoria.

Editar e testar o pedido de transações

Com o editor de pedidos aberto e o intérprete de código ativado, siga estes passos para criar o pedido:

1. Introduza as seguintes instruções para o pedido:

   1. You are given:
   -An Excel file <parameter A> with thousands of procurement transactions, including vendor name, invoice amount, PO number, and transaction date.
   -A PDF file <parameter B> listing vendors flagged as "High Risk" in the latest compliance audit.
   
   2. Your tasks:
   -Process the Excel file to identify:
   -Transactions over $10,000 with missing or blank PO numbers.
   -Extract vendor names from the PDF file that are marked "High Risk".
   -Cross-reference the vendor names in Excel with those from the PDF file.
   -Flag transactions that meet either of the following criteria:
     -High-value transaction with missing PO
     -Vendor is classified as High Risk
   -For each flagged transaction:
     -Highlight the row in red
     -Add a comment explaining the issue (for example, "High Risk Vendor" or "PO Missing")
   
   3. Generate a summary report listing:
   -Total flagged transactions
   -Vendor names involved
   -Reasons for flagging
   
   4. Return:
   -The updated Excel file with highlights and comments
   -A summary audit report formatted as PDF
   -A summary of updates made in text
   

2. Nas instruções, substitua <parameter A> por um parâmetro de entrada de ficheiro para o ficheiro do Excel que contém transações de compra. Para efetuar a alteração, substitua o texto por / e selecione Imagem ou documento no menu de contexto. Forneça um nome para este parâmetro, como "transações de compra", e carregue um ficheiro Excel de exemplo com transações usando o formato esperado.

   Certifique-se de que o ID da transação, o nome do fornecedor, o montante da fatura, número da NE e a data da transação como as colunas no ficheiro de transação. Pode utilizar outro pedido com o intérprete de código ativado para criar este ficheiro Excel de exemplo, conforme necessário.

3. Siga os mesmos passos para substituir o <parameter B> de texto nas instruções por um documento PDF de entrada carregado para o relatório de risco do fornecedor. Pode ter nomes de fornecedores como uma lista no ficheiro PDF. De novo, pode utilizar outro pedido com o intérprete de código ativado para criar o ficheiro PDF de exemplo, conforme necessário.

4. Selecione Teste.

   Em alguns segundos, verá a saída de resumo em texto como a resposta do modelo.

   Nota

   Pode deixar o modelo predefinido como GPT-4o ou selecionar qualquer outro conforme necessário.

5. Em Resposta de modelo>Saída, selecione Documento para o formato de resposta de modelo. A resposta do modelo também deve mostrar o ficheiro Excel atualizado com transações sinalizadas e o relatório de resumo em formato PDF. Pode transferir estes ficheiros para verificar os resultados.

6. Para voltar a testar com ficheiros de entrada diferentes, carregue novos ficheiros de exemplo nas instruções e selecione Testar sem regenerar.

   

Este exemplo ilustra o poder do intérprete de código, que permite que pedidos executem cenários complexos utilizando ficheiros.

Exemplo de cenário 2: pedido do intérprete de código para criar um resumo visual de tabelas do Dataverse

Este exemplo mostra como criar um pedido com o intérprete de código ativado para ler registos de tabelas do Dataverse, analisar os dados e gerar um resumo visual (gráfico) e um resumo em texto.

Editar e testar o pedido do Dataverse

Com o editor de pedidos aberto e o intérprete de código ativado, siga estes passos para criar o pedido:

1. Introduza as seguintes instruções para o pedido:

   1. You are given:
   - Ticket data that gives the created date/time, first response date/time, and the first response SLA date/time:
   
   2. Your tasks:
   - Create a histogram of the tickets by day of the week created and show the first response SLA status
   - Create insights into trends in the data
   
   3. Return:
   - A graph. Make sure to return the graph as a base64 encoded image
   - A summary of insights
   

2. Fundamente o pedido ligando-o a tabelas relevantes do Dataverse (por exemplo, pedidos de suporte e horários da equipa).

   1. Use / para abrir o menu de entrada e conhecimento e selecione Dataverse em Conhecimento.

      

   2. Selecione uma tabela e selecione os campos necessários (por exemplo, estado do pedido de suporte, agente atribuído, estado do SLA) para o pedido.

   3. Selecione Adicionar para adicionar os campos da tabela ao pedido.

      

   4. Selecione Atributo de filtro, conforme necessário, para filtrar os dados da tabela com base em atributos e valores específicos.

      

3. Selecione Testar para executar o pedido.

4. Verifique se o pedido lê os dados dos pedidos de suporte, aplica as regras de atribuição e atualiza os registos no Dataverse conforme esperado.

   

5. Guarde o pedido.

Integrar o pedido num fluxo de agente no Copilot Studio

Em seguida, pode criar um fluxo de agente para encapsular o pedido e ligá-lo ao Dataverse.

1. Aceda à página Ferramentas do agente e selecione Adicionar uma ferramenta>Nova ferramenta>Fluxo de agente.

   O estruturador de fluxos do agente é apresentado com um acionador inicial Quando um agente chama o fluxo.

2. No estruturador, selecione Inserir>Executar um pedido para adicionar uma nova ação Executar um pedido.

   

3. No nó Executar um pedido, selecione o pedido do interpretador de código.

   

4. No estruturador, selecione Inserir>Responder ao agente para adicionar uma nova ação Responder ao agente após a ação Executar um pedido.

5. Em seguida, abra o editor do nó Responder ao agente para selecionar os parâmetros a devolver ao agente como resultados.

6. Utilize Adicionar uma saída para adicionar o texto de resumo e os dados da imagem do gráfico do pedido como saídas para o fluxo.

   Atribua o nome Summary a uma das saídas e utilize a opção de valor dinâmico para selecionar a variável de saída Insights da ação Executar um pedido.

   Atribua à segunda saída o nome GraphBase64 e defina o valor de saída utilizando a opção de expressão. Selecione a saída de imagem Base64 a partir da ação Executar um pedido.

   

7. Selecione Guardar rascunho.

8. No separador Descrição Geral, em Detalhes, atribua um nome ao fluxo.

Publicar e utilizar o agente

1. Guarde e publique o agente.

   O agente pode agora processar registos do Dataverse e gerar um resumo e um gráfico.

2. Vá para a página Ferramentas do agente e selecione o fluxo de agente específico que utiliza o pedido.

3. Em Conclusão, defina a ação Após a execução para Enviar um cartão adaptativo (especificar abaixo).

4. Em Cartão Adaptativo a apresentar utilizando uma fórmula do Power Fx, selecione Fórmula para definir o cartão utilizando uma fórmula.

   O editor de fórmulas de cartão adaptativo aparece.

5. Defina o conteúdo e a origem do cartão adaptativo utilizando a fórmula seguinte:

   {
     "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
     "type": "AdaptiveCard",
     "version": "1.0",
     "body": [
       {
         "type": "Image",
         "url": "data:image/png;base64," & Topic.Output.GraphBase64,
         "altText": "Ticket analysis generated graph"
       },
       {
         "type": "TextBlock",
         "text": Topic.Output.Summary,
         "wrap": true
       }
     ]
   }
   

   Aqui, Topic.Output.GraphBase64 e Topic.Output.Summary são as variáveis de saída definidas anteriormente para o fluxo de agente.

6. Guarde o seu agente e teste-o.

7. Publique o seu agente para que outros utilizadores possam gerar conteúdo dinâmico com base nas tabelas do Dataverse.

Exemplo de cenário 3: pedido do intérprete de código para criar um gráfico a partir de um ficheiro Excel fornecido pelo utilizador

Este exemplo mostra como criar um pedido com o intérprete de código ativado para ler um ficheiro Excel carregado, converter os dados numa imagem de gráfico e devolver a imagem ao utilizador. O pedido é acionado a partir de um tópico quando o utilizador carrega um ficheiro Excel e pede um gráfico.

Criar e configurar o pedido de geração de gráfico

Com o editor de pedidos aberto e o intérprete de código ativado, siga estes passos para criar um pedido:

1. Atribua ao seu pedido um nome significativo (por exemplo, Pedido de geração de imagem) e introduza as seguintes instruções para o pedido:

   Read the attached Excel (.xlsx) and convert it into a chart named mychart.png. 
   

2. Utilize / para abrir o menu de entrada e conhecimento e selecione Imagem ou documento em Entrada.

3. Selecione um ficheiro Excel com dados de exemplo para carregar como documento de entrada para testes.

4. Selecione Guardar.

5. Selecione Adicionar ao agente para adicionar o pedido como uma ferramenta.

Criar um tópico que chame o pedido de gráfico

1. Aceda ao separador Tópicos no Copilot Studio e crie um novo tópico selecionando Adicionar um tópico>A partir do zero.

2. Na nota Acionador, defina Descrever o que o tópico faz como "Quando um ficheiro é carregado e o utilizador disser 'gera o meu gráfico'."

3. Selecione Adicionar nó e, em seguida, selecione Gestão de variáveis>Gestão de listas>Percorrer uma lista para adicionar um nó de ciclo.

4. Selecione o nó Percorrer uma lista para abrir o editor de nós. Em Itens a percorrer, selecione Selecionar variável>Sistema>Activity.Attachments.

   

5. No ciclo, selecione Adicionar nó e, em seguida, selecione Adicionar uma ferramenta e selecione o pedido que criou anteriormente para adicionar a ferramenta de pedidos ao tópico.

6. Configure as variáveis de entrada e saída adequadamente. Para a entrada, defina utilizando uma fórmula para Topic.LoopValue1.Value e selecione Inserir. Para a saída, inicialize uma variável chamada Output para capturar a saída do pedido.

   

7. No ciclo, selecione Adicionar nó>Criar uma mensagem para adicionar um nó de mensagem. O nó de mensagem é utilizado para reencaminhar a saída do pedido para o utilizador. Neste exemplo, o pedido inicializa a variável Output com a resposta. O texto é armazenado em Output.text.

8. Na parte de texto da mensagem, selecione Inserir variável e selecione Output.text.

9. Selecione Adicionar>Imagem para adicionar uma imagem à mensagem.

   

10. Em seguida, formate para apresentar a imagem corretamente. Seguinte Suporte de dados e em URL da imagem, selecione Selecionar variável>Fórmula e introduza a seguinte fórmula: "data:" & Topic.Output.artifacts.mychart.mimeType & ";base64," & Topic.Output.artifacts.mychart.base64Content

    Nota

    Este formato é necessário para que o chat possa compor a imagem corretamente. Neste exemplo, mychart representa o nome que selecionámos para a saída do ficheiro no nosso pedido e Output é o nome da variável. Os detalhes podem variar noutros exemplos, dependendo de como são nomeadas a saída do pedido e as variáveis de tópico.

    

11. Selecione Guardar para guardar o tópico.

12. Selecione Teste. Deverá ver uma imagem apresentada quando o pedido é ativado.

    

Mais exemplos de pedidos utilizando o intérprete de código

A tabela a seguir fornece mais exemplos de pedidos que podem ser utilizados com o intérprete de código ativado. Estes exemplos mostram como pedir ao intérprete de código que execute tarefas complexas.

Pedido	Resultado esperado
Criar um ficheiro PDF para capturar detalhes da encomenda	Gerar um formulário de captura de encomendas em formato PDF
Criar uma cópia do <parâmetro A> do ficheiro PDF	Criar uma cópia do ficheiro PDF de entrada fornecido.
Criar um ficheiro do Excel com um conjunto de dados sintéticos de transações de vendas	Crie um ficheiro do Excel com uma transação de vendas de exemplo. Pode melhorar o desempenho fornecendo mais instruções no pedido, de modo a gerar dados sintéticos mais avançados. O exemplo a seguir mostra um pedido mais complexo.
Criar um ficheiro Excel com um conjunto de dados sintético realista que simule transações semanais de vendas em quatro regiões ("Norte", "Sul", "Este", "Oeste") para um ano de calendário completo. Cada registo deve incluir: - Data de transação (semanal) - Região - Nome do Representante de Vendas (pelo menos três nomes exclusivos por região) - Categoria do Produto (por exemplo, "Eletrónico", "Móvel", "Eletrodoméstico", "Vestuário") - Nome do Produto (nomes realistas com base na categoria) - Unidades Vendidas - Preço Unitário (varia por categoria) - Montante Total da Venda (calculado) - Meta Atingida (Sim/Não, com base num limiar regional) - Trimestre - Canal (Online, Retalho, Distribuidor) - Segmento de Cliente (por exemplo, "Empresa", "SMB", "Consumidor") Injete alguma variação aleatória e sazonalidade: - Aumentar as vendas de "Equipamento eletrónico" no 4.º trimestre - Vendas mais baixas no "Norte" durante janeiro-fevereiro (simular a desaceleração do inverno) - Maiores vendas de vestuário no 2.º trimestre (primavera) O conjunto de dados final deve ter pelo menos 2000 linhas. Adicione uma leve aleatoriedade para maior realismo.	Este pedido gera um ficheiro do Excel com dados sintéticos mais avançados do que antes. Este pedido ilustra a eficácia do intérprete de código e como devemos dar instruções claras e detalhadas no pedido.
Folha de Resumo de Criação Automática – utilizando o <parâmetro A> gere: - Rollups mensais - Regiões com melhor desempenho - Formatação condicional para pessoas com baixo desempenho	Execute a análise de um ficheiro do Excel passando o ficheiro como a entrada para este pedido. Este pedido cria o resumo no Excel, mas também pode ser guardado num ficheiro PDF, mediante pedido adequado.
Realce as células na cor verde se as vendas > 1000, caso contrário torná-las vermelhas	Peça ao intérprete de código para executar a formatação do Excel com base nas condições e fórmulas. A formatação é expressa no pedido conforme ilustrado. Pode aplicar a mesma ideia a outros casos de utilização na formatação/processamento de estilos do Excel.