Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Bloc de flux dans Connect Customer : outil externe
Cette rubrique définit le bloc de flux permettant d'appeler un outil depuis une application externe directement depuis un flux.
**Note**
Le ** bloc d'outils ** externes n'est disponible que dans les [ instances client ](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) Amazon Connect et uniquement dans certaines régions. Pour la liste des régions, voir[Outil externe](regions.md#externaltool_region).
## Description
+ Invoque un outil provenant d'une application externe, telle que Salesforce ou ServiceNow, qui est intégrée à votre instance Connect Customer via une passerelle Amazon AgentCore Bedrock. Votre flux peut envoyer des données à des applications tierces et en lire des données sans gérer les fonctions Lambda personnalisées.
+ Exécute un outil de manière synchrone, où le flux s'arrête jusqu'à ce que l'outil revienne, ou de manière asynchrone, lorsque le flux se poursuit. Pour une invocation asynchrone, ajoutez un deuxième ** bloc d'outils ** externes défini sur ** Charger le résultat de l'outil ** pour récupérer le résultat.
+ Stocke le résultat dans l'espace de `$.ExternalTool` noms.
## Canaux pris en charge
Le tableau suivant indique comment ce bloc achemine un contact qui utilise le canal spécifié.
| Canal | Pris en charge ? |
| --- | --- |
| Voix | Oui |
| Chat | Oui |
| Sous-tâche | Oui |
| E-mail | Oui |
## Types de flux
Vous pouvez utiliser ce bloc dans les [types de flux](create-contact-flow.md#contact-flow-types) suivants :
+ Tous les flux
## Prérequis et dépendances
Avant de pouvoir utiliser ce bloc, vous devez [ intégrer une application externe à votre instance Connect Customer en tant que serveur ](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate) MCP. Pour configurer l'intégration :
1. Ouvrez la console Connect Customer.
1. Ajoutez une nouvelle intégration et sélectionnez le serveur ** MCP ** comme type d'intégration.
1. Sélectionnez une AgentCore passerelle Bedrock pour vous connecter à votre instance. S'il n'existe aucune passerelle, [ créez-en d' AgentCore](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate)abord une dans Bedrock.
1. Dans la configuration de l'identité entrante de la passerelle, ajoutez l'ID de la passerelle au ** champ Audiences ** autorisées. L'ID de passerelle est requis pour que les appels à l'outil aboutissent.
1. Associez votre instance Connect Customer à l'intégration en sélectionnant l'instance configurée avec l'URL de découverte de la passerelle.
Une fois l'intégration terminée, l'application apparaît dans le ** bloc Outil ** externe et peut être sélectionnée par son nom.
## Propriétés
Le bloc prend en charge les actions suivantes. Sélectionnez une action à l'aide de l'**option Sélectionner une action**. La valeur par défaut est l'outil ** ** Invoke.
### Outil Invoke
Les images suivantes montrent la configuration de l'action de l'outil Invoke dans les propriétés du bloc External Tool.
+ **Nom de l'application ** (obligatoire) : application externe à appeler. Vous pouvez le régler manuellement ou dynamiquement. Seules les applications associées à votre instance apparaissent.
+ **Nom de l'outil ** (obligatoire) : outil à invoquer dans l'application. Vous pouvez le définir manuellement ou dynamiquement ; la liste manuelle est mise à jour par application. Les champs de saisie sont générés à partir du schéma de l'outil et les entrées d'outil peuvent être fournies manuellement, dynamiquement ou au format JSON brut.
+ **Mode d’exécution** :
+ **Synchrone ** : le contact est acheminé vers le bloc suivant uniquement une fois l'appel de l'outil externe terminé.
+ **Asynchrone ** : le contact est acheminé vers le bloc suivant sans attendre la fin de l'appel de l'outil externe. Vous pouvez configurer un [Attente](wait.md) bloc pour attendre qu'un outil externe soit invoqué en mode d'exécution asynchrone.
+ **Délai d'attente ** : durée d'attente avant l'expiration de l'appel de l'outil externe. Le maximum est de 8 secondes pour le ** mode ** synchrone et de 60 secondes pour le mode ** asynchrone**.
+ Si l'appel d'un outil externe est limité ou si une défaillance générale du service (erreur 500) se produit, la demande est réessayée.
+ Lorsqu'un appel à un outil externe renvoie une erreur, Connect Customer réessaie jusqu'à trois fois, jusqu'au délai spécifié. À ce stade, le contact est acheminé vers la branche **Erreur**.
+ Branches : ** succès ** et ** erreur**.
### Résultat de l'outil de chargement
L'image suivante montre la configuration de l'action de résultat de l'outil Charger dans les propriétés du bloc Outil externe.
+ **ID d'appel de l'outil externe ** : ID d'appel de l'outil externe qui a été exécuté en ** mode asynchrone**. `$.ExternalTool.InvocationId`contient l'ID d'appel du dernier outil externe exécuté de manière asynchrone.
+ Pour l'**action ** Load tool result, définissez ** Namespace ** = `ExternalTool` et ** Key ** = ID d'**invocation. **
+ Branches : ** Succès**, ** En cours ** et ** Erreur**.
## Namespace
Le ** bloc ** External Tool écrit les résultats dans les chemins d'espace de noms suivants :
+ `$.ExternalTool.InvocationId`— l'identifiant d'invocation actuel.
+ `$.ExternalTool.ResultData`— le résultat de l'outil (jusqu'à 32 Ko).
Chaque nouvelle invocation remplace le résultat précédent`$.ExternalTool`. Pour conserver un résultat, copiez-le dans un attribut de contact (`$.Attributes.*`) ou un attribut de flux (`$.FlowAttribute.*`) avant d'appeler un autre outil.
## Conseils de configuration
+ **Le nom de l'application ** et le nom de l'**outil ** peuvent être définis dynamiquement ou manuellement.
+ Les résultats synchrones sont plafonnés à 32 Ko. Les réponses plus grandes prennent la ** branche ** Error.
## Exemple
Une campagne sortante adapte son message au niveau de dépenses de chaque client. Après avoir intégré Amazon Bedrock AgentCore et une intégration tierce qui expose le niveau de dépenses de chaque compte, le flux utilise un ** bloc d'outils ** externes pour lire le niveau depuis l'application tierce, puis se branche vers le message correspondant.
## Configured
Une fois que vous avez configuré le bloc, les ** branches ** Success ** et ** Error s'affichent. Pour une ** action de résultat de l'outil ** Charger, la ** branche ** En cours est également affichée.
