Ir para o conteúdo

Atividade de solicitação de imagem do Azure OpenAI

Introdução

Uma atividade de Solicitação de Imagem do Azure OpenAI, usando sua conexão do Azure OpenAI, gera uma imagem com base em um prompt especificado no Azure OpenAI e deve ser usada como um alvo para consumir dados em uma operação.

Criar uma atividade de solicitação de imagem do Azure OpenAI

Uma instância de uma atividade de Solicitação de Imagem do Azure OpenAI é criada a partir de uma conexão do Azure OpenAI usando seu tipo de atividade Solicitar Imagem.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade existente de Solicitar Imagem do Azure OpenAI pode ser editada nestes locais:

Configurar uma atividade de solicitação de imagem do Azure OpenAI

Siga estas etapas para configurar uma atividade de Solicitar Imagem do Azure OpenAI:

Etapa 1: insira um nome e especifique as configurações

Nesta etapa, forneça um nome para a atividade e especifique o texto do prompt e as configurações opcionais. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 1 da configuração da atividade de solicitação de imagem do Azure OpenAI

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade de Solicitação de Imagem do Azure OpenAI e não deve conter barras. /ou dois pontos :.

  • Texto de solicitação: Insira uma descrição da imagem a ser gerada. O tamanho máximo é de 1000 caracteres.

  • ID do modelo: Escolha um modelo de geração de imagem implantado no seu recurso Azure OpenAI. Clique em Atualize para atualizar a lista de modelos. Para obter informações sobre a implantação de modelos, consulte a documentação da Microsoft.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Formato de resposta: Selecione o formato da imagem gerada:

      • URL: (Padrão.) A API carrega a imagem gerada para um servidor temporário e retorna uma URL para essa imagem. A URL fica ativa por 24 horas.
      • Base 64: A imagem gerada é codificada como uma string base64 e incluída diretamente na resposta. Esta opção pode resultar em uma payload de resposta grande que excede os limites de tamanho de resposta da API.

    • Tamanho: Selecione as dimensões da imagem em pixels. Escolha entre 1024x1024 (padrão), 1024x1792 ou 1792x1024.

    • Número total de imagens: Insira o número de imagens a serem geradas. O valor padrão é 1 e o valor máximo é 5.

    • Qualidade da Imagem: Selecione a qualidade da imagem:

      • Padrão: (Padrão) Cria imagens de qualidade padrão com tempo de geração mais rápido.
      • HD: Cria imagens com resolução mais alta e detalhes aprimorados.

    • Estilo: Selecione o estilo da imagem:

      • Vívido: (Padrão) Cria imagens dramáticas, artísticas e estilizadas.
      • Natural: Cria imagens realistas e suaves.

    • Versões Suportadas: Selecione a versão do modelo, 2024-10-21 (padrão) ou visualização de 2025-03-01.

  • Continuar em caso de erro: Selecione para continuar a execução da atividade caso seja encontrado um erro em um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será gravado no log de operação.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Etapa 2: Revise os esquemas de dados

Todos os esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 2 da configuração da atividade de solicitação de imagem do Azure OpenAI

  • Esquemas de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    O conector Azure OpenAI usa a API REST do serviço Azure OpenAI. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

  • Atualizar: Clique no ícone de atualização ou a palavra Atualizar para regenerar esquemas do endpoint do Azure OpenAI. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Editar: Clique no ícone de edição acima de cada esquema de dados para acessar o editor esquema. O editor permite adicionar, excluir e reorganizar nós e campos, além de alterar seus tipos de dados. Todos os nós e campos recém-adicionados são definidos como [0, 1]cardinalidade. As alterações feitas nos esquemas de dados devem ser aceitáveis para o endpoint e devem ser feitas somente após consulta à documentação disponível para o endpoint. Após fazer edições no esquema, a data da última edição é exibida na parte superior do esquema aplicável para indicar que o esquema passou por edições manuais. Atualizar os esquemas os redefinirá para suas estruturas padrão.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Próximos passos

Após configurar uma atividade de Solicitação de Imagem do Azure OpenAI, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu de uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte menu de ações da atividade em Noções básicas do conector.

As atividades de Solicitação de Imagem do Azure OpenAI podem ser usadas como um alvo com esses padrões de operação:

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e executar a operação e validar o comportamento verificando os logs de operação.