Alterar a saída do pedido

Por predefinição, o pedido gera texto como resposta. O texto pode ser útil para muitos casos de utilização. No entanto, se a resposta tiver vários elementos que necessitam de ser identificados individualmente, a opção de texto pode ser limitada.

Benefícios da utilização da saída JSON

A saída JSON permite-lhe gerar uma estrutura JSON para a sua resposta de pedido em vez de um texto. O JSON permite um processamento mais fácil de respostas com vários elementos no Power Automate ou Power Apps.

Segue-se um exemplo de casos de utilização que se tornam possíveis com a saída JSON:

• Apresentar conteúdo estruturado, como a agenda do projeto ou as informações do produto.
• Extrair dados do texto, como faturas, notas de encomenda, formulários de entrega e muito mais.
• Identificar atributos de objeto a partir de origens de texto, como e-mails ou dados do Dataverse.
• Obter várias categorias ou sentimentos a partir de um texto.

Criar um pedido com saída JSON

Esta secção descreve como selecionar JSON como saída e editar o formato JSON.

Selecionar JSON como saída

Para alterar a forma como a resposta ao pedido é composta, siga estes passos:

1. No painel à direita abaixo do título Definições do pedido, selecione Saída>JSON.

2. No canto inferior esquerdo, selecione Testar pedido para verificar como a resposta ao pedido é composta no JSON.

   

Editar formato JSON

Por predefinição, o formato é Detetado automaticamente. Este formato significa que, sempre que testar o pedido, o formato associado ao pedido é atualizado com o formato detetado na altura do teste. Este formato é útil quando está a iterar as instruções do pedido e pretende saber como o formato da resposta evolui.

Se atualizar o exemplo JSON, o formato torna-se Personalizado e nunca é atualizado se testar novamente o pedido. Este formato é útil quando não pretende que ajustes de pedidos influenciem o formato ou se precisa de seguir um formato específico.

Pode reverter para o modo de deteção automática selecionando Voltar para detetar automaticamente.

Para testar e guardar o pedido, siga estes passos:

1. Para confirmar o exemplo recentemente modificado, selecione Aplicar.

2. Para verificar como a resposta ao pedido é composta no novo formato, selecione Testar pedido.

3. Quando terminar as modificações, selecione Guardar pedido personalizado.

   Se ignorar este passo, as alterações são perdidas.

   

Quando guarda o pedido, está a bloquear o formato Detetado automaticamente mais recente ou o formato Personalizado definido. Isto significa que quando utiliza o pedido no Power Automate ou Power Apps, o formato guardado é utilizado — não varia.

Em qualquer altura, pode verificar o esquema JSON que gera a partir dos exemplos JSON ao selecionar </>. Atualmente, não é possível modificar este esquema.

Utilizar um pedido com saída JSON no Power Automate

Depois de adicionar a ação Texto criado com GPT num fluxo do Power Automate, pode utilizar todos os campos JSON como valores dinâmicos sem adicionar lógica complexa para analisar a resposta.

O exemplo que se segue mostra como pode processar uma fatura recebida por e-mail utilizando o pedido descrito em Criar um pedido com saída JSON neste artigo.

1. Crie um fluxo com o acionador Quando um novo e-mail chega.

   Para saber mais, aceda a Introdução aos acionadores.

2. Se precisar apenas de processar e-mails específicos, certifique-se de que define filtros.

3. Extraia o texto dos anexos com a ação, Reconhecimento de texto numa imagem ou num documento PDF.

   Para saber mais sobre como criar e modificar um fluxo no estruturador, aceda a Compreender o estruturador de fluxos de cloud.

4. Como a ação anterior devolve uma tabela de linhas dentro de uma tabela da página, é mais conveniente agregar todas as linhas numa única variável.

   Inicialize uma variável e anexe o valor dinâmico Texto a partir da ação Reconhecimento de texto numa imagem ou num documento PDF nesta variável.

   

5. Conclua o fluxo ao realizar os seguintes passos:

   1. No seu fluxo, selecione Criar texto com GPT utilizando um pedido.
   2. No separador Parâmetros no campo Pedido, selecione pedido com JSON como saída.
   3. Adicione a variável da fatura que criou na entrada de pedido.

O seguinte procedimento permite-lhe utilizar vários valores extraídos de um texto de forma fácil e segura utilizando um pedido.

1. No seu fluxo, selecione Enviar um e-mail.

2. No separador Parâmetros, envie um e-mail que contenha os elementos extraídos pelo pedido com saída JSON.

   

FAQ

Não foi possível gerar um JSON

Pode deparar-se com o seguinte erro ao testar um pedido: Não foi possível gerar um JSON. Edite as instruções do pedido e tente novamente.

Este erro pode ser porque o modelo está a encapsular a saída JSON com informações de metadados que impedem a verificação bem-sucedida do formato JSON necessário. Tente adicionar as seguintes instruções ao seu pedido para resolver o problema: Não inclua o markdown JSON na sua resposta.

Nenhum JSON é devolvido no modo de deteção automática

É possível que nenhum JSON seja devolvido depois de selecionar Testar pedido com o modo de deteção automática ativado. Pode ser porque as instruções do pedido contradizem a instrução do sistema de devolver um JSON. Podia ser resolvido ao alterar a instrução do pedido e testar novamente.

O formato JSON não é atualizado no runtime do pedido

O formato JSON mais recente detetado no modo de deteção automática ou o formato JSON mais recente definido no modo personalizado é registado na hora de guardar o pedido. Este formato JSON gravado é aplicado no runtime do pedido, garantindo a consistência do formato de resposta mesmo quando as entradas dinâmicas para o pedido estão a mudar.

Limitações

• Não é possível modificar um esquema JSON.
• Não suportamos a definição de um formato JSON sem chaves de campo.
  Exemplo: ["abc", "def"] não é suportado, mas [{"Field1": "abc"}, {"Field1": "def"}] é suportado.