Saída de JSON

Por padrão, o prompt gera texto como resposta. O texto pode ser conveniente para muitos casos de uso; No entanto, se a resposta tiver vários elementos que precisam ser identificados individualmente, a opção de texto pode ser limitada.

Benefícios do uso da saída JSON

A saída JSON permite gerar uma estrutura JSON para a sua resposta de prompt em vez do texto. O JSON facilita o processamento de respostas com vários elementos em agentes, fluxos de nuvem ou aplicativos.

A seguir está um exemplo de casos de uso que se tornam possíveis com a saída JSON:

• Exiba conteúdo estruturado, como cronograma do projeto ou informações do produto.
• Extraia dados de texto, como faturas, ordem de compra, formulários de entrega e muito mais.
• Identifique atributos de objeto de fontes de texto, como e-mails ou dados do Dataverse.
• Obtenha várias categorias ou sentimentos de um texto.

Criar um prompt com saída JSON

Esta seçã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 do prompt é renderizada, selecione JSON como a saída no canto superior direito.

Editar formato JSON

Para visualizar ou editar o formato JSON, selecione o ícone de configurações à esquerda de Saída: JSON.

Por padrão, o formato é Detetado automaticamente. Esse formato significa que cada vez que você testa seu prompt, o formato associado ao prompt é atualizado com o detetado no momento do teste. Esse formato é conveniente quando você está iterando as instruções do prompt e quer saber como o formato de resposta evolui.

Se você atualizar o exemplo JSON, o formato se tornará Personalizado e nunca será atualizado se você testar seu prompt novamente. Esse formato é conveniente quando você não deseja ajustes rápidos para influenciar o formato ou se você precisa seguir um formato específico.

Você pode reverter para o modo de deteção automática selecionando o ícone Voltar à deteção automática .

Para testar e salvar o prompt, siga estas etapas:

1. Para confirmar o exemplo recém-modificado, selecione Aplicar.
2. Para verificar como a resposta de prompt é renderizada com o novo formato, selecione Testar.
3. Quando terminar as modificações, selecione Salvar personalizado. Se você pular esta etapa, suas alterações serão perdidas.

Ao guardar o prompt, está a bloquear o formato mais recente detetado automaticamente ou o formato personalizado definido. Isso significa que quando você usa seu prompt em um agente, um fluxo de nuvem ou um aplicativo, o formato salvo é usado — não varia.

A qualquer momento, você pode verificar o esquema JSON que gera a partir dos exemplos JSON selecionando </>. Não é possível modificar esse esquema atualmente.

Usar um prompt com saída JSON no Power Automate

Esta seção orienta você a criar o seguinte fluxo de nuvem:

1. Crie um prompt para processar faturas usando uma imagem ou documento como entrada.

   Saiba mais em Adicionar entrada de texto, imagem ou documento a um prompt.

   

2. Atualize o formato JSON fornecendo o seguinte exemplo JSON:

   

3. Crie um fluxo de nuvem com o gatilho Quando um novo e-mail chegar . Para processar e-mails específicos, certifique-se de definir filtros.

   Saiba mais em Introdução aos gatilhos.

4. Adicione a ação Executar um prompt e selecione o prompt criado na primeira etapa.

5. Na entrada da fatura, adicione o anexo de e-mail da ação de ativação.

   

6. Adicione a ação Enviar um e-mail .

7. Edite o corpo do e-mail para incluir os elementos extraídos pelo prompt com a saída JSON.

   

FAQ

Não foi possível gerar um JSON

Você pode encontrar o seguinte erro ao testar um prompt: Não foi possível gerar um JSON. Edite as instruções do prompt e tente novamente.

Esse erro pode ser porque o modelo está incluindo a saída JSON com informações de metadados que impedem a verificação bem-sucedida do formato JSON necessário. Para resolver o problema, tente adicionar a seguinte instrução ao prompt: Não inclua a marcação JSON na resposta.

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

É possível que nenhum JSON seja retornado depois de selecionar o prompt de teste com o modo de deteção automática ativado. Pode ser porque as instruções de prompt contradizem a instrução do sistema para retornar um JSON. Isso poderia ser resolvido alterando a instrução imediata e teste novamente.

O formato JSON não é atualizado no tempo de execução do prompt

O formato JSON mais recente detetado no modo de deteção automática ou o formato JSON mais recente definido no modo personalizado é gravado no momento de gravação. Este formato JSON registado é aplicado durante a execução do prompt, garantindo a consistência do formato de resposta mesmo quando as entradas dinâmicas do prompt mudam.

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.

Informações adicionais

Vídeo: construtor de prompts: saídas JSON no construtor de prompts