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 Amazon Connect e somente em determinadas regiões. Para ver a lista de regiões, consulteFerramenta externa.
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
$.ExternalToolnamespace.
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 |
Sim |
Tipos de fluxo
É possível usar esse bloco nos seguintes tipos de fluxo:
-
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 MCP. Para configurar a integração:
-
Abra o console Connect Customer.
-
Adicione uma nova integração e selecione o servidor MCP como o tipo de integração.
-
Selecione um AgentCore gateway Bedrock para se conectar à sua instância. Se não existir nenhum gateway, crie AgentCore primeiro um no Bedrock.
-
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.
-
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 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.InvocationIdconté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 =
ExternalToole 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.
