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

# Referência de ações do Automation
<a name="automations-actions-reference"></a>

Veja a seguir a documentação de referência para ações de automação usadas no App Studio.

Uma ação de automação, comumente chamada de **ação**, é uma etapa individual da lógica que compõe uma automação. Cada ação executa uma tarefa específica, seja enviando um e-mail, criando um registro de dados, invocando uma função Lambda ou chamando. APIs As ações são adicionadas às automações da biblioteca de ações e podem ser agrupadas em instruções condicionais ou loops.

Para obter informações sobre como criar e configurar automações e suas ações, consulte os tópicos em. [Automações e ações: defina a lógica de negócios do seu aplicativo](automations.md)

## Invoque a API
<a name="automations-actions-reference-invoke-API"></a>

Invoca uma solicitação da API REST HTTP. Os criadores podem usar essa ação para enviar solicitações do App Studio para outros sistemas ou serviços com APIs. Por exemplo, você pode usá-lo para se conectar a sistemas de terceiros ou aplicativos internos para acessar dados comerciais essenciais ou invocar endpoints de API que não podem ser chamados por ações dedicadas do App Studio.

Para obter mais informações sobre REST APIs, consulte [O que é uma RESTful API?](https://aws.amazon.com/what-is/restful-api/) .

### Propriedades
<a name="automations-actions-reference-invoke-API-properties"></a>

#### Conector
<a name="automations-actions-reference-invoke-API-properties-connector"></a>

O **conector** a ser usado para as solicitações de API feitas por essa ação. A lista suspensa de conectores contém somente conectores dos seguintes tipos: e. `API Connector` `OpenAPI Connector` Dependendo de como o conector está configurado, ele pode conter informações importantes, como credenciais e cabeçalhos padrão ou parâmetros de consulta.

Para obter mais informações sobre conectores de API, incluindo uma comparação entre o uso `API Connector` `OpenAPI Connector` de e. [Conecte-se a serviços de terceiros](add-connector-third-party.md)

#### Propriedades de configuração da solicitação de API
<a name="automations-actions-reference-invoke-API-properties-request-config"></a>

Escolha **Configurar solicitação de API** no painel de propriedades para abrir a caixa de diálogo de configuração da solicitação. Se um **conector de API** for selecionado, a caixa de diálogo incluirá informações sobre o conector.

**Método:** O método para a chamada da API. Os valores possíveis são:
+ `DELETE`: exclui um recurso especificado.
+ `GET`: recupera informações ou dados.
+ `HEAD`: recupera somente os cabeçalhos de uma resposta sem o corpo.
+ `POST`: envia dados para serem processados.
+ `PUSH`: envia dados para serem processados.
+ `PATCH`: atualiza parcialmente um recurso especificado.

**Caminho:** o caminho relativo até o recurso.

**Cabeçalhos:** quaisquer cabeçalhos na forma de pares de valores-chave a serem enviados com a solicitação da API. Se um conector for selecionado, seus cabeçalhos configurados serão adicionados automaticamente e não poderão ser removidos. Os cabeçalhos configurados não podem ser editados, mas você pode substituí-los adicionando outro cabeçalho com o mesmo nome.

**Parâmetros de consulta:** qualquer parâmetro de consulta na forma de pares de valores-chave a serem enviados com a solicitação da API. Se um conector for selecionado, seus parâmetros de consulta configurados serão adicionados automaticamente e não poderão ser editados nem removidos.

**Corpo:** informações a serem enviadas com a solicitação da API no formato JSON. Não há corpo para `GET` solicitações.

#### Saída simulada
<a name="automations-actions-reference-invoke-API-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Invocar AWS
<a name="automations-actions-reference-invoke-aws"></a>

Invoca uma operação de um AWS serviço. Essa é uma ação geral para chamar AWS serviços ou operações e deve ser usada se não houver uma ação dedicada para o AWS serviço ou operação desejada.

### Propriedades
<a name="automations-actions-reference-invoke-aws-properties"></a>

#### Serviço
<a name="automations-actions-reference-invoke-aws-properties-service"></a>

O AWS serviço que contém a operação a ser executada.

#### Operation
<a name="automations-actions-reference-invoke-aws-properties-operation"></a>

A operação a ser executada.

#### Conector
<a name="automations-actions-reference-invoke-aws-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-invoke-aws-properties-configuration"></a>

A entrada JSON a ser usada ao executar a operação especificada. Para obter mais informações sobre como configurar entradas para AWS operações, consulte o. [AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript)

## invocar o Lambda
<a name="automations-actions-reference-invoke-lambda"></a>

Invoca uma função Lambda existente.

### Propriedades
<a name="automations-actions-reference-invoke-lambda-properties"></a>

#### Conector
<a name="automations-actions-reference-invoke-lambda-properties-connector"></a>

O conector a ser usado para as funções Lambda executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para acessar a função Lambda e outras informações de configuração, como AWS a região que contém a função Lambda. Para obter mais informações sobre como configurar um conector para Lambda, consulte. [Etapa 3: Criar o conector Lambda](connectors-lambda.md#connectors-lambda-create-connector)

#### Nome da função
<a name="automations-actions-reference-invoke-lambda-properties-function-name"></a>

O nome da função Lambda a ser executada. Observe que esse é o nome da função e não o ARN (Amazon Resource Name).

#### Evento de função
<a name="automations-actions-reference-invoke-lambda-properties-function-event"></a>

Pares de valores-chave a serem passados para sua função Lambda como carga útil do evento.

#### Saída simulada
<a name="automations-actions-reference-invoke-lambda-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Loop
<a name="automations-actions-reference-loop"></a>

Executa ações aninhadas repetidamente para percorrer uma lista de itens, um item por vez. Por exemplo, adicione a [Criar registro](#automations-actions-reference-create-record) ação a uma ação de loop para criar vários registros.

A ação do loop pode ser aninhada em outros loops ou ações condicionais. As ações do loop são executadas sequencialmente e não em paralelo. Os resultados de cada ação dentro do loop só podem ser acessados para ações subsequentes dentro da mesma iteração do loop. Eles não podem ser acessados fora do loop ou em diferentes iterações do loop.

### Propriedades
<a name="automations-actions-reference-loop-properties"></a>

#### Fonte
<a name="automations-actions-reference-loop-properties-source"></a>

A lista de itens a serem percorridos, um item por vez. A origem pode ser o resultado de uma ação anterior ou de uma lista estática de cadeias de caracteres, números ou objetos que você pode fornecer usando uma JavaScript expressão.

##### Exemplos
<a name="automations-actions-reference-loop-properties-source-examples"></a>

A lista a seguir contém exemplos de entradas de origem.
+ Resultados de uma ação anterior: `{{results.actionName.data}}`
+ Uma lista de números: `{{[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]}}`
+ Uma lista de sequências de caracteres: `{{["apple", "banana", "orange", "grape", "kiwi"]}}`
+ Um valor computado: `{{params.actionName.split("\n")}}`

#### Nome do item atual
<a name="automations-actions-reference-loop-properties-function-name"></a>

O nome da variável que pode ser usada para referenciar o item atual que está sendo iterado. O nome do item atual é configurável para que você possa aninhar dois ou mais loops e acessar variáveis de cada loop. Por exemplo, se você estiver percorrendo países e cidades com dois loops, poderá configurar e referenciar e. `currentCountry` `currentCity`

## Condição
<a name="automations-actions-reference-condition"></a>

Executa ações com base no resultado de uma ou mais condições lógicas especificadas que são avaliadas quando a automação é executada. A ação condicional é composta pelos seguintes componentes:
+ Um campo de *condição*, usado para fornecer uma JavaScript expressão avaliada como `true` ou`false`.
+ Uma *ramificação verdadeira*, que contém ações que são executadas se a condição for avaliada como. `true`
+ Uma *ramificação falsa*, que contém ações que são executadas se a condição for avaliada como. `false`

Adicione ações às ramificações verdadeiras e falsas arrastando-as para a ação condicional.

### Propriedades
<a name="automations-actions-reference-condition-properties"></a>

#### Condição
<a name="automations-actions-reference-condition-properties-condition"></a>

A JavaScript expressão a ser avaliada quando a ação é executada.

## Criar registro
<a name="automations-actions-reference-create-record"></a>

Cria um registro em uma entidade existente do App Studio.

### Propriedades
<a name="automations-actions-reference-create-record-properties"></a>

#### Entidade
<a name="automations-actions-reference-create-record-properties-entity"></a>

A entidade na qual um registro deve ser criado. Depois que uma entidade é selecionada, os valores devem ser adicionados aos campos da entidade para que o registro seja criado. Os tipos dos campos e se os campos são obrigatórios ou opcionais são definidos na entidade.

## Atualizar registro
<a name="automations-actions-reference-update-record"></a>

Atualiza um registro existente em uma entidade do App Studio.

### Propriedades
<a name="automations-actions-reference-update-record-properties"></a>

#### Entidade
<a name="automations-actions-reference-update-record-properties-entity"></a>

A entidade que contém os registros a serem atualizados.

#### Condições
<a name="automations-actions-reference-update-record-properties-conditions"></a>

Os critérios que definem quais registros são atualizados pela ação. Você pode agrupar condições para criar uma declaração lógica. Você pode combinar grupos ou condições com `AND` nossas `OR` declarações.

#### Campos
<a name="automations-actions-reference-update-record-properties-fields"></a>

Os campos a serem atualizados nos registros especificados pelas condições.

#### Valores
<a name="automations-actions-reference-update-record-properties-values"></a>

Os valores a serem atualizados nos campos especificados.

## Excluir registro
<a name="automations-actions-reference-delete-record"></a>

Exclui um registro de uma entidade do App Studio.

### Propriedades
<a name="automations-actions-reference-delete-record-properties"></a>

#### Entidade
<a name="automations-actions-reference-delete-record-properties-entity"></a>

A entidade que contém os registros a serem excluídos.

#### Condições
<a name="automations-actions-reference-delete-record-properties-conditions"></a>

Os critérios que definem quais registros são excluídos pela ação. Você pode agrupar condições para criar uma declaração lógica. Você pode combinar grupos ou condições com `AND` nossas `OR` declarações.

## Invocar ação de dados
<a name="automations-actions-reference-invoke-data-action"></a>

Executa uma ação de dados com parâmetros opcionais.

### Propriedades
<a name="automations-actions-reference-invoke-data-action-properties"></a>

#### Ação de dados
<a name="automations-actions-reference-invoke-data-action-properties-data-action"></a>

A ação de dados a ser executada pela ação.

#### Parâmetros
<a name="automations-actions-reference-invoke-data-action-properties-parameters"></a>

Parâmetros de ação de dados a serem usados pela ação de dados. Os parâmetros de ação de dados são usados para enviar valores que são usados como entradas para ações de dados. Os parâmetros de ação de dados podem ser adicionados ao configurar a ação de automação, mas devem ser editados na guia **Dados**.

#### Configurações avançadas
<a name="automations-actions-reference-invoke-data-action-properties-advanced-settings"></a>

A `Invoke data action` ação contém as seguintes configurações avançadas:
+ **Tamanho da página:** o número máximo de registros a serem buscados em cada consulta. O valor padrão é 500 e o valor máximo é 3000.
+ **Token de paginação:** o token usado para buscar registros adicionais de uma consulta. Por exemplo, se `Page size` estiver definido como 500, mas houver mais de 500 registros, passar o token de paginação para uma consulta subsequente obterá os próximos 500. O token ficará indefinido se não existirem mais registros ou páginas.

## Amazon S3: Coloque o objeto
<a name="automations-actions-reference-s3-put-object"></a>

Usa a `Amazon S3 PutObject` operação para adicionar um objeto identificado por uma chave (caminho de arquivo) a um bucket específico do Amazon S3.

### Propriedades
<a name="automations-actions-reference-s3-put-object-properties"></a>

#### Conector
<a name="automations-actions-reference-s3-put-object-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais apropriadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-s3-put-object-properties-configuration"></a>

As opções necessárias para serem usadas no `PutObject` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon S3 PutObject` operação, consulte a *Referência [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)de API do Amazon Simple Storage Service*.
+ **Bucket:** o nome do bucket do Amazon S3 no qual colocar um objeto.
+ **Chave:** O nome exclusivo do objeto a ser colocado no bucket do Amazon S3.
+ **Corpo:** o conteúdo do objeto a ser colocado no bucket do Amazon S3.

#### Saída simulada
<a name="automations-actions-reference-s3-put-object-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon S3: Excluir objeto
<a name="automations-actions-reference-s3-delete-object"></a>

Usa a `Amazon S3 DeleteObject` operação para excluir um objeto identificado por uma chave (caminho de arquivo) de um bucket específico do Amazon S3.

### Propriedades
<a name="automations-actions-reference-s3-delete-object-properties"></a>

#### Conector
<a name="automations-actions-reference-s3-delete-object-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-s3-delete-object-properties-configuration"></a>

As opções necessárias para serem usadas no `DeleteObject` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon S3 DeleteObject` operação, consulte a *Referência [DeleteObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)de API do Amazon Simple Storage Service*.
+ **Bucket:** o nome do bucket do Amazon S3 do qual excluir um objeto.
+ **Chave:** O nome exclusivo do objeto a ser excluído do bucket do Amazon S3.

#### Saída simulada
<a name="automations-actions-reference-s3-delete-object-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon S3: Obter objeto
<a name="automations-actions-reference-s3-get-object"></a>

Usa a `Amazon S3 GetObject` operação para recuperar um objeto identificado por uma chave (caminho de arquivo) de um bucket específico do Amazon S3.

### Propriedades
<a name="automations-actions-reference-s3-get-object-properties"></a>

#### Conector
<a name="automations-actions-reference-s3-get-object-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-s3-get-object-properties-configuration"></a>

As opções necessárias para serem usadas no `GetObject` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon S3 GetObject` operação, consulte a *Referência [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)de API do Amazon Simple Storage Service*.
+ **Bucket:** o nome do bucket do Amazon S3 do qual recuperar um objeto.
+ **Chave:** O nome exclusivo do objeto a ser recuperado do bucket do Amazon S3.

#### Saída simulada
<a name="automations-actions-reference-s3-get-object-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon S3: Listar objetos
<a name="automations-actions-reference-s3-list-objects"></a>

Usa a `Amazon S3 ListObjects` operação para listar objetos em um bucket específico do Amazon S3.

### Propriedades
<a name="automations-actions-reference-s3-list-objects-properties"></a>

#### Conector
<a name="automations-actions-reference-s3-list-objects-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-s3-list-objects-properties-configuration"></a>

As opções necessárias para serem usadas no `ListObjects` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon S3 ListObjects` operação, consulte a *Referência [ListObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html)de API do Amazon Simple Storage Service*.
+ **Bucket:** o nome do bucket do Amazon S3 a partir do qual listar objetos.

#### Saída simulada
<a name="automations-actions-reference-s3-list-objects-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon Textract: analise o documento
<a name="automations-actions-reference-textract-analyze-document"></a>

Usa a `Amazon Textract AnalyzeDocument` operação para analisar um documento de entrada quanto às relações entre os itens detectados.

### Propriedades
<a name="automations-actions-reference-textract-analyze-document-properties"></a>

#### Conector
<a name="automations-actions-reference-textract-analyze-document-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-textract-analyze-document-properties-configuration"></a>

O conteúdo da solicitação a ser usada no `AnalyzeDocument` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon Textract AnalyzeDocument` operação, consulte [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeDocument.html)o *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket:** O nome do bucket Amazon S3. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Nome:** O nome do arquivo do documento de entrada. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Versão:** Se o bucket do Amazon S3 tiver o versionamento ativado, você poderá especificar a versão do objeto. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **FeatureTypes:** Uma lista dos tipos de análise a serem executados. Os valores válidos são: `TABLES`, `FORMS`, `QUERIES`, `SIGNATURES` e `LAYOUT`.

#### Saída simulada
<a name="automations-actions-reference-textract-analyze-document-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon Textract: analise despesas
<a name="automations-actions-reference-textract-analyze-expense"></a>

Usa a `Amazon Textract AnalyzeExpense` operação para analisar um documento de entrada em busca de relações financeiras entre texto.

### Propriedades
<a name="automations-actions-reference-textract-analyze-expense-properties"></a>

#### Conector
<a name="automations-actions-reference-textract-analyze-expense-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-textract-analyze-expense-properties-configuration"></a>

O conteúdo da solicitação a ser usada no `AnalyzeExpense` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon Textract AnalyzeExpense` operação, consulte [AnalyzeExpense](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeExpense.html)o *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket:** O nome do bucket Amazon S3. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Nome:** O nome do arquivo do documento de entrada. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Versão:** Se o bucket do Amazon S3 tiver o versionamento ativado, você poderá especificar a versão do objeto. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.

#### Saída simulada
<a name="automations-actions-reference-textract-analyze-expense-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon Textract: Analise o ID
<a name="automations-actions-reference-textract-analyze-id"></a>

Usa a `Amazon Textract AnalyzeID` operação para analisar um documento de identidade em busca de informações relevantes.

### Propriedades
<a name="automations-actions-reference-textract-analyze-id-properties"></a>

#### Conector
<a name="automations-actions-reference-textract-analyze-id-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-textract-analyze-id-properties-configuration"></a>

O conteúdo da solicitação a ser usada no `AnalyzeID` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon Textract AnalyzeID` operação, consulte [AnalyzeID](https://docs.aws.amazon.com/textract/latest/dg/API_AnalyzeID.html) no *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket:** O nome do bucket Amazon S3. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Nome:** O nome do arquivo do documento de entrada. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Versão:** Se o bucket do Amazon S3 tiver o versionamento ativado, você poderá especificar a versão do objeto. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.

#### Saída simulada
<a name="automations-actions-reference-textract-analyze-id-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon Textract: detecte texto de documentos
<a name="automations-actions-reference-textract-detect-document-text"></a>

Usa a `Amazon Textract DetectDocumentText` operação para detectar linhas de texto e as palavras que compõem uma linha de texto em um documento de entrada.

### Propriedades
<a name="automations-actions-reference-textract-detect-document-text-properties"></a>

#### Conector
<a name="automations-actions-reference-textract-detect-document-text-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-textract-detect-document-text-properties-configuration"></a>

O conteúdo da solicitação a ser usada no `DetectDocumentText` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon Textract DetectDocumentText` operação, consulte [DetectDocumentText](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)o *Amazon Textract Developer* Guide.
+ **Document/S3Object/Bucket:** O nome do bucket Amazon S3. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Nome:** O nome do arquivo do documento de entrada. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.
+ **Documento/S3Object/Versão:** Se o bucket do Amazon S3 tiver o versionamento ativado, você poderá especificar a versão do objeto. Esse parâmetro pode ser deixado em branco se um arquivo for passado para a ação com o componente de **upload do S3**.

#### Saída simulada
<a name="automations-actions-reference-textract-detect-document-text-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon Bedrock: GenAI Prompt
<a name="automations-actions-reference-bedrock-prompt"></a>

Usa a InvokeModel operação [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) para executar inferência usando os parâmetros de prompt e inferência fornecidos nas propriedades da ação. A ação pode gerar texto, imagens e incorporações.

### Propriedades
<a name="automations-actions-reference-bedrock-prompt-properties"></a>

#### Conector
<a name="automations-actions-reference-bedrock-prompt-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. Para usar essa ação com sucesso, o conector deve ser configurado com o **Amazon Bedrock Runtime** como serviço. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Modelo
<a name="automations-actions-reference-bedrock-prompt-properties-model"></a>

O modelo básico a ser usado pelo Amazon Bedrock para processar a solicitação. Para obter mais informações sobre modelos no Amazon Bedrock, consulte as informações do [modelo da Amazon Bedrock Foundation no Guia](https://docs.aws.amazon.com/bedrock/latest/userguide/foundation-models-reference.html) do usuário do *Amazon Bedrock*.

#### Tipo de entrada
<a name="automations-actions-reference-bedrock-prompt-properties-input-type"></a>

O tipo de entrada da entrada enviada para o modelo Amazon Bedrock. Os valores possíveis são **Texto**, **Documento** e **Imagem**. Se um tipo de entrada não estiver disponível para seleção, provavelmente não é suportado pelo modelo configurado.

#### Solicitação do usuário
<a name="automations-actions-reference-bedrock-prompt-properties-user-prompt"></a>

A solicitação a ser enviada ao modelo Amazon Bedrock para ser processada para gerar uma resposta. Você pode inserir texto estático ou transmitir uma entrada de outra parte do seu aplicativo, como de um componente usando parâmetros, uma ação anterior na automação ou outra automação. Os exemplos a seguir mostram como transmitir um valor de um componente ou de uma ação anterior:
+ Para passar um valor de um componente usando parâmetros: `{{params.paramName}}`
+ Para passar um valor de uma ação anterior: `{{results.actionName}}`

#### Prompt do sistema (modelos Claude)
<a name="automations-actions-reference-bedrock-prompt-properties-system-prompt"></a>

O sistema solicita que seja usado pelo modelo Amazon Bedrock ao processar a solicitação. O prompt do sistema é usado para fornecer contexto, instruções ou diretrizes aos modelos Claude.

#### Configurações de solicitação
<a name="automations-actions-reference-bedrock-prompt-properties-request-settings"></a>

Defina várias configurações de solicitação e parâmetros de inferência do modelo. Agora, é possível definir as seguintes configurações:
+ **Temperatura**: a temperatura a ser usada pelo modelo Amazon Bedrock ao processar a solicitação. A temperatura determina a aleatoriedade ou criatividade da saída do modelo Bedrock. Quanto mais alta a temperatura, mais criativa e menos analítica será a resposta. Os valores possíveis são`[0-10]`.
+ **Máximo de tokens**: limite o comprimento da saída do modelo Amazon Bedrock.
+ **TopP****: Na amostragem de núcleo, o modelo calcula a distribuição cumulativa de todas as opções para cada token subsequente em ordem decrescente de probabilidade e a interrompe quando atinge uma probabilidade específica especificada pelo TopP.** Você deve alterar a **temperatura** ou o **TopP**, mas não ambos
+ **Sequências de parada**: sequências que fazem com que o modelo pare de processar a solicitação e gerar a saída.

Para obter mais informações, consulte [Parâmetros de solicitação de inferência e campos de resposta para modelos básicos no Guia](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html) do *usuário do Amazon Bedrock*.

#### Sequências de parada
<a name="automations-actions-reference-bedrock-prompt-properties-guardrail"></a>

**Insira uma **ID** e uma versão do Amazon Bedrock Guardrail.** As grades de proteção são usadas para implementar proteções com base em seus casos de uso e políticas responsáveis de IA. Para obter mais informações, consulte [Impeça conteúdo nocivo em modelos usando o Amazon Bedrock Guardrails no Guia do usuário](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) do *Amazon Bedrock*.

#### Saída simulada
<a name="automations-actions-reference-bedrock-prompt-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## Amazon Bedrock: modelo Invoke
<a name="automations-actions-reference-bedrock-invoke-model"></a>

Usa a InvokeModel operação [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) para executar inferência usando os parâmetros de prompt e inferência fornecidos no corpo da solicitação. Você usa a inferência de modelos para gerar texto, imagens e incorporações.

### Propriedades
<a name="automations-actions-reference-bedrock-invoke-model-properties"></a>

#### Conector
<a name="automations-actions-reference-bedrock-invoke-model-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. Para usar essa ação com sucesso, o conector deve ser configurado com o **Amazon Bedrock Runtime** como serviço. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-bedrock-invoke-model-properties-configuration"></a>

O conteúdo da solicitação a ser usada no `InvokeModel` comando.

**nota**  
Para obter mais informações sobre a `Amazon Bedrock InvokeModel` operação, incluindo comandos de exemplo, consulte [InvokeModel](https://docs.aws.amazon.com/textract/latest/dg/API_DetectDocumentText.html)a *Amazon Bedrock API Reference*.

#### Saída simulada
<a name="automations-actions-reference-bedrock-invoke-model-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.

## JavaScript
<a name="automations-actions-reference-javascript"></a>

Executa uma JavaScript função personalizada para retornar um valor especificado.

**Importante**  
O App Studio não oferece suporte ao uso de JavaScript bibliotecas personalizadas ou de terceiros.

### Propriedades
<a name="automations-actions-reference-javascript-properties"></a>

#### Código-fonte
<a name="automations-actions-reference-javascript-properties-source-code"></a>

O trecho de JavaScript código a ser executado pela ação.

**dica**  
Você pode usar a IA para ajudar a gerar JavaScript para você executando as seguintes etapas:  
Escolha o ícone de expansão para abrir o JavaScript editor expandido.
(Opcional): ative a opção **Modificar código** para modificar qualquer código existente. JavaScript Caso contrário, a IA substituirá qualquer existente JavaScript.
Em **Gerar JavaScript**, descreva o que você quer fazer com JavaScript, por exemplo:**Add two numbers**.
Escolha o ícone de envio para gerar seu JavaScript.

## Invoque a automação
<a name="automations-actions-reference-invoke-automation"></a>

Executa uma automação especificada.

### Propriedades
<a name="automations-actions-reference-invoke-automation-properties"></a>

#### Invoque a automação
<a name="automations-actions-reference-invoke-automation-properties-invoke-automation"></a>

A automação a ser executada pela ação.

## Enviar e-mail
<a name="automations-actions-reference-send-email"></a>

Usa a `Amazon SES SendEmail` operação para enviar um e-mail.

### Propriedades
<a name="automations-actions-reference-send-email-properties"></a>

#### Conector
<a name="automations-actions-reference-send-email-properties-connector"></a>

O conector a ser usado para as operações executadas por essa ação. O conector configurado deve ser configurado com as credenciais adequadas para executar a operação e outras informações de configuração, como a AWS região que contém os recursos referenciados na operação.

#### Configuração
<a name="automations-actions-reference-send-email-properties-configuration"></a>

O conteúdo da solicitação a ser usada no `SendEmail` comando. As opções são as seguintes:

**nota**  
Para obter mais informações sobre a `Amazon SES SendEmail` operação, consulte [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)a *Referência da API do Amazon Simple Email Service*.

#### Saída simulada
<a name="automations-actions-reference-send-email-properties-mocked-output"></a>

As ações não interagem com serviços ou recursos externos no ambiente de pré-visualização. O campo **de saída simulada** é usado para fornecer uma expressão JSON que simula o comportamento de um conector no ambiente de visualização para fins de teste. Esse trecho é armazenado no `results` mapa da ação, assim como a resposta do conector seria para um aplicativo publicado no ambiente ativo.

Com esse campo, você pode testar vários cenários e seu impacto em outras ações dentro da automação, como simular diferentes valores de resultados, cenários de erro, casos extremos ou caminhos insatisfatórios sem se comunicar com serviços externos por meio de conectores.