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 ](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) Amazon Connect y solo en determinadas regiones. Para ver la lista de regiones, consulte[Herramienta externa](regions.md#externaltool_region).
## 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](create-contact-flow.md#contact-flow-types):
+ 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. ](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate) Para configurar la integración:
1. Abra la consola de Connect Customer.
1. Agregue una nueva integración y seleccione el servidor ** MCP ** como tipo de integración.
1. 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](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate).
1. 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.
1. 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](wait.md) 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.InvocationId`contiene 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 ** = `ExternalTool` y ** 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.
