Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Bloque de flujo en Connect Customer: herramienta externa
En este tema se define el bloque de flujo para invocar una herramienta desde una aplicación externa directamente desde un flujo.
nota
El bloque de herramientas externas solo está disponible en las instancias de clientes de Amazon Connect y solo en determinadas regiones. Para ver la lista de regiones, consulteHerramienta externa.
Description (Descripción)
-
Invoca una herramienta desde una aplicación externa, como Salesforce o ServiceNow, que está integrada con tu instancia de Connect Customer a través de una puerta de enlace de Amazon Bedrock AgentCore . Su flujo puede enviar datos a aplicaciones de terceros y leerlos desde ellas sin tener que mantener las funciones personalizadas de Lambda.
-
Ejecuta una herramienta de forma sincrónica, donde el flujo se detiene hasta que la herramienta regresa, o de forma asincrónica, cuando el flujo continúa. En el caso de una invocación asincrónica, añada un segundo bloque de herramientas externo establecido en Cargar el resultado de la herramienta para recuperar el resultado.
-
Almacena el resultado en el espacio de nombres.
$.ExternalTool
Canales compatibles
En la siguiente tabla se enumera cómo enruta este bloque a un contacto que está utilizando el canal especificado.
| Canal | ¿Se admite? |
|---|---|
Voz |
Sí |
Chat |
Sí |
Tarea |
Sí |
Correo electrónico |
Sí |
Tipos de flujo
Puede utilizar este bloque en los siguientes tipos de flujo:
-
Todos los flujos
Requisitos previos y dependencias
Antes de poder usar este bloque, debe integrar una aplicación externa en su instancia de Connect Customer como un servidor MCP. Para configurar la integración:
-
Abra la consola de Connect Customer.
-
Agregue una nueva integración y seleccione el servidor MCP como tipo de integración.
-
Seleccione una AgentCore puerta de enlace de Bedrock para conectarse con su instancia. Si no existe ninguna puerta de enlace, primero cree una en Bedrock AgentCore.
-
En la configuración de identidad entrante de la puerta de enlace, añada el ID de la puerta de enlace al campo Audiencias permitidas. El ID de la puerta de enlace es necesario para que las invocaciones de la herramienta se realicen correctamente.
-
Asocie su instancia de Connect Customer a la integración seleccionando la instancia que está configurada con la URL de descubrimiento de la puerta de enlace.
Una vez completada la integración, la aplicación aparece en el bloque de herramientas externas y se puede seleccionar por su nombre.
Propiedades
El bloque admite las siguientes acciones. Seleccione una acción mediante Seleccionar una acción. El valor predeterminado es la herramienta Invoke.
Herramienta de invocación
Las siguientes imágenes muestran la configuración de la acción de la herramienta Invocar en las propiedades del bloque de herramientas externo.
-
Nombre de la aplicación (obligatorio): la aplicación externa a la que se va a llamar. Puede configurarlo de forma manual o dinámica. Solo aparecen las aplicaciones asociadas a tu instancia.
-
Nombre de la herramienta (obligatorio): la herramienta que se va a invocar en la aplicación. Puede configurarlo manual o dinámicamente; la lista manual se actualiza según la aplicación. Los campos de entrada se generan a partir del esquema de la herramienta y las entradas de la herramienta se pueden proporcionar de forma manual, dinámica o como JSON sin procesar.
-
Modo de ejecución:
-
Sincrónico: el contacto se redirige al siguiente bloque solo después de que se complete la invocación de la herramienta externa.
-
Asincrónico: el contacto se redirige al siguiente bloque sin esperar a que finalice la invocación de la herramienta externa. Puedes configurar un Wait bloque para que espere a que una herramienta externa se invoque en modo de ejecución asincrónica.
-
-
Tiempo de espera: cuánto tiempo debe transcurrir antes de que se agote el tiempo de espera de la invocación de la herramienta externa. El máximo es de 8 segundos para el modo sincrónico y 60 segundos para el modo asincrónico.
-
Si se limita la invocación de una herramienta externa o se produce un error en el servicio general (error 500), se vuelve a intentar la solicitud.
-
Cuando la invocación de una herramienta externa arroja un error, Connect Customer lo vuelve a intentar hasta tres veces, hasta que se agote el tiempo de espera especificado. En ese momento, el contacto baja por la ramificación Error.
-
-
Ramas: éxito y error.
Cargar el resultado de la herramienta
La siguiente imagen muestra la configuración de la acción resultante de la herramienta Cargar en las propiedades del bloque de herramientas externo.
-
ID de invocación de la herramienta externa: el ID de invocación de la herramienta externa que se ejecutó en modo asincrónico.
$.ExternalTool.InvocationIdcontiene el identificador de invocación de la herramienta externa ejecutada de forma asincrónica más reciente. -
Para la acción de resultado de la herramienta Cargar, defina Namespace =
ExternalTooly Key = ID de invocación. -
Ramas: Éxito, En curso y Error.
Namespace
El bloque de herramientas externas escribe los resultados en las siguientes rutas de espacio de nombres:
-
$.ExternalTool.InvocationId— el ID de invocación actual. -
$.ExternalTool.ResultData— el resultado de la herramienta (hasta 32 KB).
Cada nueva invocación sobrescribe el resultado anterior$.ExternalTool. Para conservar un resultado, cópielo en un atributo de contacto ($.Attributes.*) o un atributo de flujo ($.FlowAttribute.*) antes de invocar otra herramienta.
Sugerencias de configuración
-
El nombre de la aplicación y el nombre de la herramienta se pueden configurar de forma dinámica y manual.
-
Los resultados sincrónicos tienen un límite de 32 KB. Las respuestas más grandes toman la rama de error.
Ejemplo
Una campaña saliente adapta su mensaje al nivel de gasto de cada cliente. Tras integrar Amazon Bedrock AgentCore y una integración de terceros que muestre el nivel de gasto de cada cuenta, el flujo utiliza un bloque de herramientas externas para leer el nivel desde la aplicación de terceros y, a continuación, se ramifica hasta el mensaje correspondiente.
Configured
Tras configurar el bloque, se muestran las ramas de éxito y error. En el caso de una acción de resultado de la herramienta Cargar, también muestra la rama En curso.
