View a markdown version of this page

Automações de construção - Amazon Quick

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Automações de construção

O Amazon Quick Automate fornece vários métodos para criar automações para atender a diferentes necessidades e níveis de habilidade. Esta seção descreve os métodos e ferramentas de criação disponíveis.

Pré-requisitos

Antes de criar uma automação, você precisa criar um projeto dentro de um grupo de automação específico. O grupo de automação controlará quais integrações e credenciais estão disponíveis para você ao criar essa automação. Garanta que as integrações e credenciais necessárias estejam configuradas para qualquer sistema externo com o qual você planeja interagir em sua automação.

Depois de criar um projeto, clique no botão Começar a construir para começar.

nota

Você deve ter permissões de proprietário para gerenciar integrações e credenciais para um grupo de automação.

Métodos de criação

Escolha entre três abordagens para criar sua automação. Se você é novo no Amazon Quick Automate, recomendamos:

  • Comece explorando exemplos de automações

  • Tente criar uma automação simples usando linguagem natural

  • Experimente a edição manual quando estiver familiarizado com o básico

Usando automações de amostra

Comece rapidamente explorando amostras pré-criadas que demonstram padrões comuns de automação. Esses exemplos fornecem exemplos práticos de diferentes recursos de automação e servem como recursos de aprendizado para ajudar você a se familiarizar com os recursos do Amazon Quick Automate. Para usar um exemplo de automação:

  • Pesquise para explorar diferentes amostras por setor.

  • Clique na amostra para ver uma visão geral da automação.

    • Se alguma integração for necessária, ela será listada como pré-requisito.

  • Clique em Iniciar com amostra para abrir a automação na tela.

  • Agora você poderá visualizar a automação, editá-la e testá-la.

Criando com linguagem natural

O Automation Assistant fornece uma AI-powered abordagem para criar automações por meio de:

  • Interface de bate-papo - Descreva seu processo conversacionalmente em linguagem natural

  • Upload de documentos - Importe qualquer documentação que descreva as etapas e os requisitos do seu processo

Quando você fornece informações por meio de qualquer método, o Assistente de automação gera sua automação por meio de uma experiência guiada em duas etapas:

  • High-level plano

    • Primeiro, o Assistente analisa seus requisitos e gera um plano de automação de alto nível. O plano consiste em etapas do processo que agrupam logicamente as ações relacionadas como parte da automação. Cada etapa do processo contém inicialmente instruções em linguagem natural.

    • Revise e edite as instruções para cada etapa do processo e clique em Gerar para criar as ações de baixo nível para essa etapa.

  • Low-level actions

    • Em seguida, o Assistente criará as ações de baixo nível e a lógica do processo com base nas instruções da etapa.

    • Revise e edite as ações geradas. Clique em Executar ou Depurar para começar o teste.

Práticas recomendadas para fornecer entradas de linguagem natural:

  • Especifique o processo passo a passo como se estivesse treinando um novo contratado

  • Inclua os detalhes exatos necessários para realizar cada etapa:

    • Endereço de e-mail se estiver enviando uma mensagem

    • Nome do arquivo e localização uploading/downloading de um documento

    • URL se estiver navegando até um site

Criando do zero (automação em branco)

Crie automações manualmente usando a interface do designer visual:

  • Navegue até o resumo do seu projeto

  • Clique em Começar a construir

  • Selecione Ignorar para acessar a tela

A interface do designer fornece vários componentes principais:

  • Canvas - Visualiza a automação. Você pode ampliar e reduzir, expandir e reduzir as etapas do processo e reordenar as ações na tela.

  • Painel de ações - O painel de ações tem uma lista abrangente de todas as ações de automação disponibilizadas em seu grupo de automação. Você pode pesquisar e filtrar para encontrar ações organizadas por categoria (Agentes, fluxo de processos, navegador da Web etc.). Drag-and-drop ações na tela para criar sua automação. Você também pode clicar no sinal de adição encontrado ao passar o mouse entre as ações para adicionar uma nova ação diretamente na tela.

  • Painel de propriedades - Depois de adicionar uma ação ou clicar em uma existente em seu processo, o painel de propriedades permite que você configure os parâmetros de entrada e saída que controlam como essa ação se comportará.

  • Painel de configurações - Permite criar e editar configurações de tempo de execução e explorar as credenciais disponíveis para sua automação.

  • Painel de variáveis - Exibe todas as variáveis usadas em sua automação. A criação de uma variável é simples ao adicionar uma nova referência diretamente em sua automação.

Configurações e variáveis de tempo de execução

As configurações de tempo de execução permitem que você crie configurações facilmente editáveis que são usadas pela sua automação. Exemplos de configurações de tempo de execução incluem:

  • URLs do site

  • Nomes e localizações dos arquivos

  • Configurações de e-mail, como assuntos e listas de remetentes

As variáveis são usadas para armazenar e transmitir informações entre as ações em sua automação quando ela é executada. Adicione uma nova variável à sua automação simplesmente fornecendo um novo nome de referência em uma propriedade de saída. Os tipos comuns de variáveis incluem:

  • Cadeia de caracteres - Texto sem formatação (por exemplo, nome, descrição)

  • Número - Valor numérico (por exemplo, quantidade, pontuação)

  • Booleano - valor True/False

  • Matriz - Coleção ou lista de itens

  • Objeto - Key-value pares

  • Arquivo - Documentos e mídia (por exemplo, PDFs, imagens)

  • Tabela de Spreadsheet-like dados - dados com linhas e colunas

Edição de automações

Depois de criar sua automação, você pode modificá-la usando o Assistente de automação ou editando diretamente na tela.

Usando o Assistente de Automação

O Assistente de automação ajuda você a fazer alterações por meio da linguagem natural. Você pode:

  • Solicite atualizações para toda a automação, etapas específicas ou ações específicas

    • Concentre o bate-papo em etapas específicas selecionando-as primeiro

  • Faça perguntas e obtenha ajuda e sugestões no produto com base em sua automação real

  • Peça ajuda para escrever expressões e códigos com base em suas necessidades

Para editar com o Assistente:

  • Clique em Criar com o Assistant na barra de ferramentas

  • Descreva as mudanças que você deseja fazer

  • Revise e confirme as modificações sugeridas

    • O bate-papo inclui um resumo das mudanças. Clique em Rejeitar alterações para reverter para a versão anterior.

  • Teste a automação atualizada

Edição em tela

Faça alterações diretamente no designer visual:

  • Selecione a etapa ou ação a ser modificada

  • Use o painel de propriedades para ajustar as configurações

  • Reorganize as etapas usando o recurso de arrastar e soltar

nota

Cada ação tem um menu de opções com ações comuns, como duplicar a ação ou excluí-la.

Práticas recomendadas para edição:

  • Faça alterações incrementais

  • Teste após cada modificação significativa

nota

As alterações são salvas automaticamente na versão ao vivo. Se você quiser implantar essas alterações, confirme e implante a versão atualizada.

dica

Se você encontrar problemas durante a construção:

  • Use o Assistente de automação para obter ajuda

  • Verifique a documentação da ação para obter os requisitos específicos

Entradas e saídas de automação

Defina esquemas de entrada e saída para criar automações parametrizadas e reutilizáveis no Amazon Quick Automate. Ao definir esquemas de entrada e saída usando os nós Início e Fim, você pode transformar automações estáticas em fluxos de trabalho reutilizáveis que aceitam dados diferentes cada vez que são executados. Em vez de valores de codificação permanente, você define parâmetros de entrada digitados que são fornecidos em tempo de execução e valores de saída estruturados que são capturados quando a automação é concluída. As entradas e saídas funcionam em todos os métodos de invocação: execuções manuais, chamadas de API e acionadores programados.

Principais benefícios do uso de entradas e saídas:

  • Reutilização — Execute a mesma automação com dados diferentes sem modificar a automação em si.

  • Segurança de tipos — O Amazon Quick Automate valida os dados de entrada em relação ao esquema antes do início da execução, o que impede a execução de dados inválidos.

  • Integração de API — os Auto-generated esquemas permitem a descoberta programática e a integração com sistemas externos.

  • Observabilidade — Os resultados estruturados são capturados como artefatos de execução para auditoria e revisão.

Tipos de dados compatíveis

Os seguintes tipos de dados são compatíveis com campos de entrada e saída:

  • Texto — valores de texto simples (por exemplo, texto1, texto2)

  • Número — Valores numéricos incluindo decimais (por exemplo, 3,14, 100)

  • Boolean — Valores verdadeiros ou falsos

  • Arquivo — Objetos de arquivo com tamanho máximo de 5 MB

Nódulos inicial e final

Cada automação inclui um nó inicial e um nó final, que estão em branco por padrão. Você pode editar esses nós para criar um esquema, usar as entradas na automação e atualizar os dados de saída para retornar da automação. O nó inicial recebe dados de entrada em tempo de execução, enquanto os nós finais (incluindo nós de processo final) coletam dados de saída durante a execução e os retornam como artefatos estruturados quando a automação é concluída.

Início

O nó inicial é o ponto de entrada que aceita parâmetros de entrada quando a automação é acionada. Por padrão, está em branco.

Propriedades:

  • Formato de entrada — Define o esquema dos parâmetros de entrada que a automação aceita. Edite usando o editor de esquema de entrada descrito em Definição de esquemas de entrada e saída.

  • Variável de entrada — Variável que armazena os valores de entrada para a automação conforme definido no formato de entrada e fornecido pelo usuário.

Fim

O nó final é o ponto de terminação que coleta e retorna os valores de saída quando a automação é concluída com êxito. Você pode definir os valores de saída das variáveis na automação usando as propriedades do nó final. Sua automação pode ter vários nós finais (processo final) com base na estrutura da automação.

Propriedades:

  • Formato de saída — Define o esquema dos parâmetros de saída que a automação retorna. Escolha Editar e adicione ou modifique o esquema usando o editor de esquema de saída descrito em Definindo esquemas de entrada e saída.

  • Dados de saída — mapeia valores de variáveis em sua automação para os campos de saída que você definiu. Para cada variável de saída criada no nó final (esquema de saída), especifique qual variável de automação contém os dados que você deseja retornar. Use o editor Editar dados de saída para configurar esses mapeamentos no campo Valor de saída.

Definindo esquemas de entrada e saída

Os esquemas definem a estrutura de dados que sua automação aceita como entrada e produz como saída. O estúdio de criação fornece um criador visual de formulários para definir esquemas de entrada e saída diretamente na tela de automação.

Para definir um esquema de entrada:

  • Abra sua automação no Amazon Quick Automate.

  • Escolha o nó Iniciar na tela para abrir o editor de esquemas. Você também pode abrir o editor de esquemas no painel de propriedades. Para fazer isso, escolha o nó Iniciar e, em seguida, escolha Editar no formato de entrada no painel de propriedades.

  • Escolha +Adicionar campo para adicionar um campo de entrada.

  • Para cada campo de entrada, configure as seguintes propriedades:

    • Nome — Um identificador exclusivo para o campo.

    • Tipo — O tipo de dados que o campo aceita. Para obter mais informações, consulte Tipos de dados com suporte.

    • Obrigatório — Se o campo deve ser fornecido ao executar a automação.

    • Valor padrão (opcional) — Essa opção estará ativa somente se o campo Obrigatório estiver desmarcado. Os valores padrão aparecem pré-preenchidos no formulário de entrada quando você executa um teste ou aciona a automação.

    • Descrição — Uma descrição do que o campo representa.

  • Escolha Salvar para armazenar o esquema com sua automação.

Para definir um esquema de saída:

  • Escolha um nó final na tela para abrir o editor do esquema de saída. Você também pode abrir o editor de esquemas no painel de propriedades. Para fazer isso, escolha o nó Fim e, em seguida, escolha Editar no formato de saída no painel de propriedades.

  • Escolha +Adicionar campo para adicionar um campo de saída.

  • Para cada campo de saída, configure as seguintes propriedades:

    • Nome — Um identificador exclusivo para o campo.

    • Tipo — O tipo de dados para a saída.

    • Descrição — Uma descrição do que a saída representa.

  • Escolha Salvar.

nota

Você pode definir entradas do nó inicial e saídas de qualquer nó final. Se sua automação tiver vários nós finais, adicionar ou modificar o esquema de um nó final modifica todos os esquemas de nós finais.

Usando valores de entrada do nó inicial

Quando sua automação tem um esquema de entrada definido no nó Iniciar, você pode acessar esses valores de entrada em todo o fluxo de trabalho usando o inputs dicionário. O tempo de execução valida e preenche automaticamente esse dicionário com os valores fornecidos quando a automação é executada.

# Access required input fields value = inputs["field_name"] # Example usage customer_id = inputs["customer_id"] # Retrieves a required string input

Definindo valores de saída no nó final

O nó final define quais valores de sua automação são retornados como saídas. Você configura isso usando a propriedade Output Data, que fornece dois modos de interação para definir valores de saída no editor. Alterne entre os modos escolhendo o ícone de código (</>) ao lado do campo Valor de saída.

Dois modos para definir saídas:

  • Modo de seleção de variáveis (menu suspenso) — A interface padrão exibe uma lista suspensa de todas as variáveis disponíveis em sua automação. Selecione a variável que você deseja atribuir a cada campo de saída.

  • Modo de expressão (Código) — Escolha o ícone de código (</>) ao lado de qualquer campo de valor de saída para alternar para o modo de expressão. Esse modo permite inserir expressões personalizadas, realizar cálculos, acessar dados aninhados ou definir valores literais.

Definindo esquemas com o Build with Assistant

O Build with Assistant pode criar ou modificar esquemas de entrada e saída diretamente. Descreva seus requisitos de entrada e saída em linguagem natural e o assistente gera a definição do esquema para você. Todas as alterações feitas pelo assistente são sincronizadas automaticamente com o criador de formulários visuais do Studio.

Considerações

Lembre-se do seguinte ao usar entradas e saídas de automação:

  • Os esquemas de entrada e saída são opcionais. As automações existentes sem esquemas continuam funcionando inalteradas.

  • As entradas de arquivo têm um tamanho máximo de 5 MB. Para arquivos maiores, transmita a localização do arquivo (como um caminho do Amazon S3) como entrada de texto.

  • Os valores de entrada e saída são armazenados em cada execução para fins de observabilidade e auditoria.

  • Ao atualizar um esquema, você deve reimplantar a automação para que as alterações entrem em vigor nas execuções implantadas. As execuções de teste sempre usam o esquema de rascunho mais recente.

Você pode usar os valores de entrada e saída das seguintes formas:

Gerenciando versões de automação

O Amazon Quick Automate fornece recursos de controle de versão para ajudá-lo a rastrear e manter o histórico de atualizações de suas automações e restaurar facilmente as versões anteriores.

Principais conceitos

  • Versão ao vivo - A cópia de trabalho atual da sua automação que você pode editar na tela. As alterações são salvas automaticamente na versão ao vivo à medida que você edita.

  • Versões confirmadas - Read-only instantâneos de sua automação que podem ser implantados. Confirme uma nova versão de sua automação para acompanhar as atualizações significativas e poder revertê-las, se necessário.

  • Versões implantadas - As versões confirmadas podem ser implantadas e ativadas para serem executadas de acordo com um cronograma.

nota

Cada versão mantém seus próprios valores de configuração de tempo de execução. As alterações nas configurações de tempo de execução da versão Live não afetam as versões previamente confirmadas ou implantadas.

Comprometendo versões

Para confirmar uma versão:

  • Clique em Confirmar na barra de ferramentas da tela

  • Adicione uma nota descritiva explicando suas alterações

  • Escolha como incrementar o número da versão:

    • Versão secundária (por exemplo, 1,05 → 1,06) para atualizações menores (padrão)

    • Versão principal (por exemplo, 1.0 → 2.0) para mudanças significativas

  • Clique em Confirmar

Importante

Você não pode confirmar uma versão se a automação tiver algum erro de validação. Resolva todos os erros antes de tentar confirmar.

Quando você confirma uma versão:

  • A versão confirmada se torna um instantâneo somente para leitura

  • A configuração atual do tempo de execução é salva com a versão confirmada

  • Uma nova versão Live é criada com base nesse instantâneo para continuar editando.

Importante

Somente versões confirmadas podem ser implantadas. A versão Live deve ser confirmada primeiro antes de ser implantada.

Visualizando versões

Veja as versões em dois lugares:

  • Lista suspensa de versões na tela - O padrão é a versão Live. Escolha qualquer versão anterior no menu suspenso para visualizar no modo somente leitura na tela.

  • Guia Versões - encontrada nos detalhes do projeto. Mostra um histórico completo da versão, incluindo o número da versão, quando a versão foi confirmada, o usuário que confirmou a versão e quaisquer notas da versão. Clique no menu de ações para ver os detalhes da versão ou implantá-la.

Restaurar versões anteriores

Para restaurar uma versão anterior e continuar editando-a como a versão Live:

  • Selecione a versão no menu suspenso de versões acima da tela

  • Escolha Restaurar versão ao vivo

  • A versão selecionada substitui sua versão atual do Live

  • Continue editando a versão Live para fazer os ajustes necessários

  • Confirme como uma nova versão para tirar um instantâneo ou implantar as atualizações

nota

A restauração de uma versão cria uma nova cópia de trabalho, mas não exclui nenhum histórico de versões.

Práticas recomendadas

  • Adicione notas de versão claras para monitorar a finalidade das alterações

  • Confirme as versões após atualizações significativas

  • Teste as alterações antes de se comprometer

  • Revise a configuração do tempo de execução antes de confirmar