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á.
# Bloco de fluxo no Connect Customer: ferramenta externa
Este tópico define o bloco de fluxo para invocar uma ferramenta de um aplicativo externo diretamente de um fluxo.
**nota**
O ** bloco de ferramentas ** externas está disponível somente em [ instâncias de clientes do ](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) Amazon Connect e somente em determinadas regiões. Para ver a lista de regiões, consulte[Ferramenta externa](regions.md#externaltool_region).
## Description
+ Invoca uma ferramenta de um aplicativo externo, como Salesforce ou ServiceNow, que é integrada à sua instância Connect Customer por meio de um gateway Amazon Bedrock. AgentCore Seu fluxo pode enviar e ler dados de aplicativos de terceiros sem manter funções personalizadas do Lambda.
+ Executa uma ferramenta de forma síncrona, onde o fluxo é interrompido até que a ferramenta retorne, ou de forma assíncrona, onde o fluxo continua. Para uma invocação assíncrona, adicione um segundo ** bloco de ferramentas ** externas definido como ** Carregar resultado da ferramenta para recuperar o resultado**.
+ Armazena o resultado no `$.ExternalTool` namespace.
## Canais compatíveis
A tabela a seguir lista como esse bloco direciona um contato que está usando o canal especificado.
| Canal | Compatível? |
| --- | --- |
| Voz | Sim |
| Chat | Sim |
| Tarefa | Sim |
| E-mail | Sim |
## Tipos de fluxo
É possível usar esse bloco nos seguintes [tipos de fluxo](create-contact-flow.md#contact-flow-types):
+ Todos os fluxos
## Pré-requisitos e dependências
Antes de usar esse bloco, você deve [ integrar um aplicativo externo à sua instância do Connect Customer como um servidor ](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate) MCP. Para configurar a integração:
1. Abra o console Connect Customer.
1. Adicione uma nova integração e selecione o servidor ** MCP ** como o tipo de integração.
1. Selecione um AgentCore gateway Bedrock para se conectar à sua instância. Se não existir nenhum gateway, [ crie AgentCore ](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate) primeiro um no Bedrock.
1. Na configuração de identidade de entrada do gateway, adicione o ID do gateway ao campo Públicos ** ** permitidos. O ID do gateway é necessário para que as invocações de ferramentas sejam bem-sucedidas.
1. Associe sua instância Connect Customer à integração selecionando a instância que está configurada com o URL de descoberta do gateway.
Depois que a integração for concluída, o aplicativo aparecerá no ** bloco de ferramentas ** externas e poderá ser selecionado pelo nome.
## Propriedades
O bloco suporta as seguintes ações. Selecione uma ação usando ** Selecionar uma ação**. O padrão é a ferramenta ** ** Invoke.
### Ferramenta de invocação
As imagens a seguir mostram a configuração da ação da ferramenta Invoke nas propriedades do bloco de ferramentas externas.
+ **Nome do aplicativo ** (obrigatório): O aplicativo externo a ser chamado. Você pode definir isso manualmente ou dinamicamente. Somente os aplicativos associados à sua instância aparecem.
+ **Nome da ferramenta ** (obrigatório): a ferramenta a ser invocada no aplicativo. Você pode definir isso manualmente ou dinamicamente; a lista manual é atualizada por aplicativo. Os campos de entrada são gerados a partir do esquema da ferramenta, e as entradas da ferramenta podem ser fornecidas manualmente, dinamicamente ou como JSON bruto.
+ **Modo de execução**:
+ **Síncrono**: O contato é roteado para o próximo bloco somente após a conclusão da invocação da Ferramenta Externa.
+ **Assíncrono**: o contato é roteado para o próximo bloco sem esperar que a invocação da Ferramenta Externa seja concluída. Você pode configurar um [Wait](wait.md) bloco para esperar por uma ferramenta externa que seja invocada no modo de execução assíncrona.
+ **Tempo limite**: quanto tempo esperar antes que a invocação da Ferramenta Externa expire. O máximo é de 8 segundos para o ** modo ** síncrono e 60 segundos para o modo ** ** assíncrono.
+ Se uma invocação de ferramenta externa for limitada ou ocorrer uma falha geral no serviço (erro 500), a solicitação será repetida.
+ Quando uma invocação de ferramenta externa retorna um erro, o Connect Customer tenta novamente até três vezes, até o tempo limite especificado. Nesse ponto, o contato é direcionado para a ramificação **Error (Erro)**.
+ Filiais: ** sucesso ** e ** erro**.
### Resultado da ferramenta de carregamento
A imagem a seguir mostra a configuração da ação do resultado da ferramenta Carregar nas propriedades do bloco de ferramentas externas.
+ **ID de invocação de ferramenta externa**: A ID de invocação da ferramenta externa que foi executada no modo assíncrono. ** ** `$.ExternalTool.InvocationId`contém o ID de invocação da ferramenta externa mais recente executada de forma assíncrona.
+ Para a ** ação de resultado da ferramenta ** Carregar, defina ** Namespace ** = `ExternalTool` e ** Key ** = ** Invocation ID. **
+ Filiais: ** sucesso**, ** em andamento ** e ** erro**.
## Namespace
O ** bloco de ferramentas ** externas grava os resultados nos seguintes caminhos de namespace:
+ `$.ExternalTool.InvocationId`— o ID de invocação atual.
+ `$.ExternalTool.ResultData`— o resultado da ferramenta (até 32 KB).
Cada nova invocação substitui o resultado anterior. `$.ExternalTool` Para manter um resultado, copie-o para um atributo de contato (`$.Attributes.*`) ou atributo de fluxo (`$.FlowAttribute.*`) antes de invocar outra ferramenta.
## Dicas de configuração
+ **O nome do aplicativo ** e o nome da ** ferramenta ** podem ser definidos de forma dinâmica e manual.
+ Os resultados síncronos são limitados a 32 KB. Respostas maiores usam a ** ramificação ** Error.
## Exemplo
Uma campanha externa adapta sua mensagem ao nível de gasto de cada cliente. Depois de integrar o Amazon Bedrock AgentCore e uma integração de terceiros que expõe o nível de gastos de cada conta, o fluxo usa um ** bloco de ferramentas ** externas para ler o nível do aplicativo de terceiros e, em seguida, ramifica-se para a mensagem correspondente.
## Configured
Depois de configurar o bloco, ele mostra as ** ramificações ** Sucesso ** e ** Erro. Para uma ** ação de resultado da ferramenta ** Carregar, ela também mostra a ** ramificação ** Em andamento.
