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 Amazon Connect e solo in determinate regioni. Per l'elenco delle regioni, consultaStrumento esterno.
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ì |
Sì |
Tipi di flusso
È possibile utilizzare questo blocco nei seguenti tipi di flusso:
-
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. Per configurare l'integrazione:
-
Apri la console Connect Customer.
-
Aggiungi una nuova integrazione e seleziona il server MCP come tipo di integrazione.
-
Seleziona un AgentCore gateway Bedrock per connetterti alla tua istanza. Se non esiste un gateway, creane prima uno in Bedrock AgentCore.
-
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.
-
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 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.InvocationIdcontiene 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.
