Saída de JSON

Note

As funcionalidades deste artigo são alimentadas pelo arnês padrão, que utiliza as opções de faturação descritas em Licenciamento para agentes alimentados pelo chicote padrão. Aprenda a aceder a funcionalidades padrão nos agentes e fluxos de agentes padrão do Access.

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.

Captura de ecrã de seleções na página 'Prompt com JSON'.

Editar formato JSON

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

Captura de tela das configurações de saída.

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.

Captura de ecrã do 'Formato deteção automática'.

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 .

Captura de ecrã do í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:

Captura de ecrã de um fluxo na nuvem com um prompt

  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.

    Captura de tela de um prompt de processamento de fatura.

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

    Captura de tela de um formato JSON personalizado.

  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.

    Captura de tela de parâmetros de prompt em um fluxo de nuvem.

  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.

    Captura de tela de um corpo de e-mail mostrando campos 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.

Limitations

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

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

  • Last updated on