Use o interpretador de código em exemplos de solicitações

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

Os exemplos pressupõem que você já:

• Criou um novo prompt do AI Builder e ative o interpretador de código nas configurações de prompt.

Cenário de exemplo 1: prompt de interpretador de código para auditar transações

O gerente de compras da Contoso audita regularmente as transações de compra. Eles recebem um relatório PDF periódico que identifica fornecedores de alto risco e seguem uma política que exige ordens de compra para transações de mais de US$ 10.000. O gerenciador de compras usa o PDF para auditar as transações no Excel. O gerente de compras usa prompts com interpretador de código para automatizar esse 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. Digite as seguintes instruções para o prompt:

   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 arquivo para o arquivo do Excel que contém transações de aquisição. Para fazer a alteração, substitua o texto / e selecione Imagem ou documento no menu de contexto. Forneça um nome para esse parâmetro, como "transações de aquisição", e carregue um arquivo de exemplo do Excel com transações usando o formato esperado.

   Certifique-se de ter a ID da transação, o nome do fornecedor, o valor da fatura, o número da PO e a data da transação como colunas no arquivo de transação. Você pode usar outro prompt com o interpretador de código ativado para criar este arquivo de exemplo do Excel 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 fornecedor 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, você deverá ver a saída de resumo no texto como a resposta do modelo.

   Observação

   Você pode deixar o modelo padrão como GPT-4o ou selecionar qualquer outro, conforme necessário.

5. Em Resposta do modelo>Saída, selecione Documento para o formato de resposta do modelo. A resposta do modelo também deve mostrar o arquivo do Excel atualizado com transações sinalizadas e o relatório de resumo no formato PDF. Você pode baixar esses arquivos para verificar os resultados.

   Importante

   Para fazer o teste 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 dispara o reprocessamento.

Este exemplo ilustra o poder do interpretador de código, que habilita comandos para executar cenários complexos usando arquivos.

Cenário de exemplo 2: prompt de 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 do 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. Digite as seguintes instruções para o prompt:

   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. Baseie a solicitação vinculando-se a tabelas do Dataverse relevantes (por exemplo, tíquetes, escalas de equipe).

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

      

   2. Selecione uma tabela e os campos necessários (por exemplo, status do tíquete, agente atribuído, status do SLA) para a solicitação.

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

      

   4. Selecione o atributo Filter, 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 a solicitação.

Integrar o prompt a um 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>Novo ferramenta>Fluxo do Agente.

   O designer de fluxo do agente é exibido com um gatilho Quando um agente chama o fluxo inicial.

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

   

3. No nó Executar uma solicitação, selecione a solicitação do interprete de código.

   

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

5. Em seguida, abra o editor de nós Responder ao agente para selecionar parâmetros a serem repassados para o agente como saídas.

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

   Nomeie uma das saídas Summary, e use a opção de valor dinâmico para selecionar a Insights variável de saída 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 saída Base64 da imagem na ação Executar uma solicitação.

   

7. Selecione Salvar rascunho.

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

Publicar e usar o agente

1. Salve 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 do agente específico que usa a solicitação.

3. Em Conclusão, defina a ação Após a execução para Enviar um cartão adaptável (especifique abaixo).

4. Em cartão adaptável para exibir usando uma fórmula PowerFx, 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. Salve seu agente e teste-o.

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

Cenário de exemplo 3: prompt de interpretador de código para criar um gráfico a partir de um arquivo do Excel fornecido pelo usuário

Este exemplo mostra como criar um prompt com o interpretador de código ativado para ler um arquivo do Excel carregado, converter os dados em uma imagem de gráfico e retornar a imagem para o usuário. O prompt é disparado a partir de um tópico quando o usuário carrega um arquivo do Excel e solicita 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 prompt um nome significativo (por exemplo, prompt de geração de imagem) 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 arquivo do Excel com dados de exemplo para carregar como a entrada do documento para teste.

4. Clique em Salvar.

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

Criar um tópico que chama o prompt de gráfico

1. Vá para a guia Tópicos no Copilot Studio e crie um novo tópico selecionando Adicionar um tópico>em branco.

2. Na observação Gatilho, defina Descreva o que o tópico faz como "Quando um arquivo é carregado e o usuário diz 'gerar meu gráfico'".

3. Selecione Adicionar nó e selecione Gerenciamento de variáveis>Gerenciamento de listas>Loop em uma lista para adicionar um nó de loop.

4. Selecione o nó Loop em uma lista para abrir o editor de nós. Em Itens para fazer loop, selecione Selecionar variável>Sistema>Atividade.Anexos.

   

5. Dentro do loop, selecione Adicionar nó e Adicionar uma ferramenta e selecione o prompt criado anteriormente para adicionar a ferramenta de prompt ao tópico.

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

   

7. Dentro do loop, selecione Adicionar nó>Criar uma mensagem para adicionar um nó de mensagem. O nó de mensagem é usado para retransmitir a saída do prompt para o usuário. 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> e insira a seguinte fórmula:"data:" & Topic.Output.artifacts.mychart.mimeType & ";base64," & Topic.Output.artifacts.mychart.base64Content

    Observação

    Esse formato é necessário para que o chat renderize 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 mudar em outros exemplos, dependendo de como a saída do prompt e as variáveis de tópico são nomeadas.

    

11. Selecione Salvar para salvar seu tópico.

12. Selecione Teste. Você deverá ver uma imagem exibida quando o prompt for disparado.

    

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. Esses exemplos mostram como solicitar que o interpretador de código execute tarefas complexas.