Usar interpretador de código nos exemplos de prompts

Os exemplos a seguir demonstram a funcionalidade do interpretador de código para lidar com prompts complexos.

Os exemplos assumem que começaste um novo prompt e ativaste o interpretador de código nas definições do prompt.

Cenário de exemplo 1: mensagem de comando do interpretador 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 utiliza 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 prompt de transações

Com o editor de prompt aberto e o interpretador de código ativado, siga estas etapas para criar o prompt:

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 de Excel que contém transações de aquisição. Para fazer a alteração, substitua o texto por / e selecione Imagem ou documento no menu de contexto. Dê um nome a este parâmetro, como "transações de aquisição", 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. Podes usar outro prompt com o interpretador de código ativado para criar este ficheiro Excel de exemplo conforme necessário.

3. Siga as mesmas etapas para substituir o texto <parameter B> por um documento PDF de entrada carregado para o relatório de risco do fornecedor. Você pode ter nomes de fornecedores como uma lista no arquivo PDF. Novamente, você pode usar outro prompt com o interpretador de código ativado para criar o arquivo 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.

   Observação

   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 deve também mostrar o ficheiro Excel atualizado com transações sinalizadas e o relatório resumo em formato PDF. Pode transferir estes ficheiros para verificar os resultados.

   Importante

   Para testar novamente com um arquivo diferente, você precisa alterar o texto do prompt e salvar. Simplesmente carregar ou trocar o arquivo de exemplo sem modificar o prompt não aciona o reprocessamento.

Este exemplo ilustra o poder do interpretador de código que permite que prompts executem cenários complexos usando arquivos.

Cenário de exemplo 2: prompt do interpretador de código para criar um resumo visual de tabelas do Dataverse

Este exemplo mostra como criar um prompt com o interpretador de código ativado para ler registros de tabelas Dataverse, analisar os dados e gerar um resumo visual (gráfico) e um resumo de texto.

Editar e testar o prompt do Dataverse

Com o editor de prompt aberto e o interpretador de código ativado, siga estas etapas para criar o prompt:

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 prompt.

      

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

      

3. Selecione Testar para executar o prompt.

4. Verifique se o prompt lê os dados do tíquete, aplica regras de atribuição e atualiza os registros no Dataverse conforme o esperado.

   

5. Salve o aviso.

Integra o prompt num fluxo de agente no Copilot Studio

Em seguida, você pode criar um fluxo de agente para encapsular o prompt e conectá-lo ao Dataverse.

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

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

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

   

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

   

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

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.

   Nomeie uma das saídas Summary e use a opção de valor dinâmico para selecionar a variável de saída Insights a partir da ação Executar um prompt.

   Nomeie a segunda saída GraphBase64e defina o valor de saída usando a opção de expressão. Selecione a imagem Base64 gerada pela ação Executar um prompt.

   

7. Selecione Guardar rascunho.

8. Na guia Visão geral , em Detalhes, dê um nome ao fluxo.

Publique e utilize o agente

1. Guarde e publique o agente.

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

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

3. Em Conclusão, defina a ação Depois de executar como Enviar um cartão adaptável (especifique abaixo).

4. Em Cartão Adaptativo para mostrar usando uma fórmula Power Fx, selecione Fórmula para definir o cartão usando uma fórmula.

   O editor de fórmulas de cartão adaptável é exibido.

5. Defina o conteúdo e a origem do cartão adaptável usando a seguinte fórmula:

   {
     "$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 do agente.

6. Guarde o seu agente e teste-o.

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

Exemplo de cenário 3: prompt do interpretador de código para criar um gráfico a partir de um ficheiro Excel fornecido pelo utilizador

Este exemplo mostra como criar um prompt com o interpretador 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 prompt é ativado a partir de um tópico quando o utilizador carrega um ficheiro Excel e pede um gráfico.

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

Com o editor de prompt aberto e o interpretador de código habilitado, siga estas etapas para criar um prompt:

1. Dê ao seu prompt um nome significativo (por exemplo, Image gen prompt) e insira as seguintes instruções para o prompt:

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

2. Use / 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 entrada do documento para testes.

4. Selecione Guardar.

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

Criar um tópico que faça referência ao prompt do gráfico

1. Vá ao separador Tópicos na Copilot Studio e crie um novo tópico selecionando Adicionar um tópico>From blank.

2. Na nota Trigger, defina Descreva o que o tópico faz como "Quando um arquivo é carregado e o usuário diz 'gerar um gráfico para mim'".

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 serem repetidos, selecione Selecionar variável>Atividade do sistema.Anexos>.

   

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 de acordo. Para a entrada, defina usando uma fórmula como Topic.LoopValue1.Value e selecione Inserir. Como saída, inicialize uma variável nomeada Output para armazenar a saída do prompt.

   

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 prompt 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 exibir a imagem corretamente. Selecione Mídia e, em URL da imagem, selecione Selecionar variável>Fórmula e insira a seguinte fórmula: "data:" & Topic.Output.artifacts.mychart.mimeType & ";base64," & Topic.Output.artifacts.mychart.base64Content

    Observação

    Este formato é necessário para que o chat processe a imagem corretamente. Neste exemplo, mychart representa o nome que selecionamos para a saída do arquivo em nosso prompt 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. Você verá uma imagem exibida quando o prompt for acionado.

    

Mais exemplos de prompts usando o interpretador de código

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

Prompt	Resultado esperado
Crie um arquivo PDF para capturar detalhes do pedido	Gerar um formulário de captura de pedido em formato PDF
Criar uma cópia do <parâmetro A> do ficheiro PDF	Crie uma cópia do arquivo PDF fornecido.
Crie um ficheiro Excel com um conjunto de dados sintéticos de transações de vendas	Crie um ficheiro Excel com exemplos de transação de vendas. Você pode melhorar o desempenho dando mais instruções no prompt para obter dados sintéticos mais avançados gerados. O próximo exemplo mostra um prompt mais complexo.
Crie 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") durante um ano civil 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 prompt gera um ficheiro Excel com dados sintéticos mais ricos 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	Realize a análise de um ficheiro Excel passando o ficheiro como entrada neste prompt. Este prompt cria o resumo no Excel, mas também pode ser guardado num ficheiro PDF com o devido comando.
Realce as células na cor verde se as vendas > 1000, caso contrário torná-las vermelhas	Peça ao interpretador de código para realizar formatação no Excel com base em condições e fórmulas. A formatação é expressa no pedido conforme ilustrado. Podes aplicar a mesma ideia a outros casos de uso em formatação/tratamento de estilos no Excel.