Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Blocco di flusso in Connect Customer: strumento esterno
Questo argomento definisce il blocco di flusso per richiamare uno strumento da un'applicazione esterna direttamente da un flusso.
**Nota**
Il ** blocco ** External Tool è disponibile solo nelle [ istanze dei clienti ](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) Amazon Connect e solo in determinate regioni. Per l'elenco delle regioni, consulta[Strumento esterno](regions.md#externaltool_region).
## Description
+ Richiama uno strumento da un'applicazione esterna, come Salesforce o ServiceNow, integrata con l'istanza Connect Customer tramite un gateway Amazon AgentCore Bedrock. Il tuo flusso può inviare e leggere dati da applicazioni di terze parti senza mantenere funzioni Lambda personalizzate.
+ Esegue uno strumento in modo sincrono, dove il flusso si interrompe fino al ritorno dello strumento, o in modo asincrono, dove il flusso continua. Per una chiamata asincrona, aggiungete un secondo ** blocco ** External Tool impostato su Carica il risultato dello strumento per recuperare il risultato. ** **
+ Memorizza il risultato nel namespace. `$.ExternalTool`
## Canali supportati
La tabella seguente elenca il modo in cui questo blocco instrada un contatto che utilizza il canale specificato.
| Canale | Supportato? |
| --- | --- |
| Voce | Sì |
| Chat | Sì |
| Operazione | Sì |
| Email | Sì |
## Tipi di flusso
È possibile utilizzare questo blocco nei seguenti [tipi di flusso](create-contact-flow.md#contact-flow-types):
+ Tutti i flussi
## Prerequisiti e dipendenze
Prima di poter utilizzare questo blocco, è necessario [ integrare un'applicazione esterna con l'istanza Connect Customer come server MCP. ](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate) Per configurare l'integrazione:
1. Apri la console Connect Customer.
1. Aggiungi una nuova integrazione e seleziona il server ** MCP ** come tipo di integrazione.
1. Seleziona un AgentCore gateway Bedrock per connetterti alla tua istanza. Se non esiste un gateway, [ creane prima uno in Bedrock AgentCore](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps-mcp-server.html#3p-apps-mcp-server-how-to-integrate).
1. Nella configurazione dell'identità in entrata del gateway, aggiungi l'ID del gateway al campo ** Audiences ** consentito. L'ID del gateway è necessario affinché le chiamate allo strumento abbiano esito positivo.
1. Associa la tua istanza Connect Customer all'integrazione selezionando l'istanza configurata con l'URL di scoperta del gateway.
Una volta completata l'integrazione, l'applicazione viene visualizzata nel ** blocco Strumenti ** esterni e può essere selezionata per nome.
## Properties
Il blocco supporta le seguenti azioni. Seleziona un'azione usando ** Seleziona un'azione**. L'impostazione predefinita è lo strumento ** ** Invoke.
### Strumento Invoke
Le immagini seguenti mostrano la configurazione dell'azione dello strumento Invoke nelle proprietà del blocco External Tool.
+ **Nome dell'applicazione ** (obbligatorio): l'applicazione esterna da chiamare. È possibile impostarlo manualmente o dinamicamente. Vengono visualizzate solo le applicazioni associate alla tua istanza.
+ **Nome dello strumento ** (obbligatorio): lo strumento da richiamare all'interno dell'applicazione. È possibile impostarlo manualmente o dinamicamente; l'elenco manuale viene aggiornato in base all'applicazione. I campi di input vengono generati dallo schema dello strumento e gli input dello strumento possono essere forniti manualmente, dinamicamente o come JSON non elaborato.
+ **Modalità di esecuzione**:
+ **Sincrono**: il contatto viene indirizzato al blocco successivo solo dopo il completamento dell'invocazione dello strumento esterno.
+ **Asincrono**: il contatto viene indirizzato al blocco successivo senza attendere il completamento dell'invocazione dello strumento esterno. È possibile configurare un [Attendi](wait.md) blocco in modo che attenda che uno strumento esterno venga richiamato in modalità di esecuzione asincrona.
+ **Timeout**: quanto tempo aspettare prima che scada il timeout per l'invocazione dello strumento esterno. Il massimo è 8 secondi per la modalità ** sincrona e 60 secondi per ** la modalità asincrona. ** **
+ Se la chiamata a uno strumento esterno viene limitata o si verifica un errore generale del servizio (errore 500), la richiesta viene ritentata.
+ Quando una chiamata a uno strumento esterno restituisce un errore, Connect Customer riprova fino a tre volte, fino al timeout specificato. Dopodiché, il contatto viene instradato al ramo **Error (Errore)**.
+ Filiali: ** successo ed errore. ** ** **
### Carica il risultato dello strumento
L'immagine seguente mostra la configurazione dell'azione Carica risultato dello strumento nelle proprietà del blocco Strumento esterno.
+ **ID di richiamo dello strumento esterno**: l'ID di richiamo dello strumento esterno eseguito in modalità asincrona. ** ** `$.ExternalTool.InvocationId`contiene l'ID di chiamata dello strumento esterno eseguito in modo asincrono più recente.
+ Per l'**azione ** Load tool result, impostate ** Namespace ** = e Key = Invocation ID. `ExternalTool` ** ** ** **
+ Filiali: ** Operazione completata**, ** In corso ** ed Errore. ** **
## Namespace
Il ** blocco ** External Tool scrive i risultati nei seguenti percorsi di namespace:
+ `$.ExternalTool.InvocationId`— l'ID di chiamata corrente.
+ `$.ExternalTool.ResultData`— il risultato dello strumento (fino a 32 KB).
Ogni nuova chiamata sovrascrive il risultato precedente. `$.ExternalTool` Per conservare un risultato, copiatelo in un attributo contact (`$.Attributes.*`) o in un attributo flow (`$.FlowAttribute.*`) prima di richiamare un altro strumento.
## Consigli per la configurazione
+ **Il nome dell'applicazione ** e il nome ** dello strumento ** possono essere impostati sia dinamicamente che manualmente.
+ I risultati sincroni sono limitati a 32 KB. Le risposte più ampie utilizzano il ramo ** Error**.
## Esempio
Una campagna in uscita adatta il messaggio al livello di spesa di ciascun cliente. Dopo aver integrato Amazon Bedrock AgentCore e un'integrazione di terze parti che espone il livello di spesa di ciascun account, il flusso utilizza un ** blocco di strumenti ** esterni per leggere il livello dall'applicazione di terze parti e quindi si dirama al messaggio corrispondente.
## Configurato
Dopo aver configurato il blocco, vengono visualizzati i rami ** Success ** ed ** Error. ** Per l'**azione dei risultati dello strumento ** Carica, mostra anche il ** ramo ** In corso.
