View a markdown version of this page

Integra applicazioni di terze parti nell'area di lavoro degli agenti - Cliente Amazon Connect

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à.

Integra applicazioni di terze parti nell'area di lavoro degli agenti

L'area di lavoro degli agenti Connect Customer offre agli agenti gli strumenti e le indicazioni dettagliate per risolvere rapidamente i problemi e fornire migliori esperienze ai clienti con meno formazione richiesta. L'area di lavoro degli agenti include applicazioni native di prima parte, come Customer Profiles, Cases e Agent Assist. È inoltre possibile integrare applicazioni di terze parti.

Nota

Third-party le applicazioni sono supportate solo nell'area di lavoro degli agenti di Connect Customer; non sono supportate nei desktop con agenti personalizzati.

Ad esempio, è possibile integrare un sistema di prenotazione proprietario o una dashboard del sistema di gestione dei sinistri di terze parti nell'area di lavoro degli agenti.

Se sei uno sviluppatore interessato a creare un’applicazione di terze parti, consulta la Guida per gli sviluppatori di Agent Workspace.

Tipi di integrazione

Un'integrazione collega qualcosa esterno a Connect Customer alla tua istanza. Crei un'integrazione una volta per un AWS account e una regione, la associ a una o più istanze e le concedi le autorizzazioni. Scegli un tipo di integrazione nella pagina Aggiungi integrazione. Il tipo determina la configurazione e il modo in cui Connect Customer raggiunge l'integrazione.

  • Applicazione standard: un'applicazione web che Connect Customer esegue il rendering in un iframe nell'area di lavoro dell'agente. Gli agenti la aprono dal launcher delle app. Fornisci un URL di accesso, le autorizzazioni iframe e un ambito di contatto che viene impostato quando l'applicazione si aggiorna. Utilizza questo tipo per un'applicazione in cui lavorano i tuoi agenti, ad esempio uno strumento di ricerca degli ordini o un'app di pianificazione.

  • Servizio: un'applicazione headless creata dall'utente e che viene eseguita in background nell'area di lavoro degli agenti. Un servizio viene avviato quando lo spazio di lavoro dell'agente viene caricato e rimane attivo per il resto della sessione. Non ha un'interfaccia da aprire per un agente. Utilizza questo tipo per attività che vengono eseguite autonomamente, ad esempio per reagire a eventi di contatto come connessione, disconnessione e post-contatto, aprire un'applicazione quando viene soddisfatta una condizione o completare un flusso di autenticazione non appena inizia la sessione. Per ulteriori informazioni, consulta Creazione di servizi di terze parti nella Agent Workspace Developer Guide.

  • Server MCP: un server Model Context Protocol che fornisce agli agenti AI di Connect Customer una serie di strumenti da chiamare. Lo connetti tramite un AgentCore gateway Bedrock anziché un URL di accesso e ogni gateway serve un server MCP. Per la procedura completa, consulta Integra un server MCP con Connect Customer.

I passaggi seguenti descrivono come aggiungere un'applicazione standard.

Autorizzazioni IAM richieste

Se utilizzi policy IAM personalizzate per gestire l'accesso ad applicazioni di terze parti, i tuoi utenti necessitano di autorizzazioni IAM aggiuntive. InoltreAmazonConnect_FullAccess, gli utenti hanno bisogno di quanto segue:

JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": [ "app-integrations:CreateApplication", "app-integrations:GetApplication", "iam:GetRolePolicy", "iam:PutRolePolicy", "iam:DeleteRolePolicy" ], "Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*", "Effect": "Allow" } ] }

Aggiungere un'applicazione di terze parti

Nota

Per aggiungere un'integrazione alle tue istanze, assicurati che l'istanza utilizzi un Service-Linked Role (SLR). Se la tua istanza attualmente non utilizza una SLR ma desideri aggiungere un'integrazione, dovrai migrare a una SLR. L'integrazione può essere aggiunta solo alle istanze che utilizzano una SLR. Per ulteriori informazioni, consulta Per le istanze create prima di ottobre 2018.

  1. Apri la console Connect Customer ()https://console.aws.amazon.com/connect/.

  2. Nel riquadro di navigazione, scegli Integrazioni. Se non vedi questo menu, significa che le app 3P non sono disponibili nella tua AWS regione. Per verificare dove sono disponibili le app 3P, consulta. Disponibilità di Connect Customer caratteristiche per regione

  3. Nella pagina Integrazioni, scegli Aggiungi integrazione.

    La pagina Integrazioni sulla console Connect Customer.
  4. Nella pagina Aggiungi integrazione, completa i campi relativi alle informazioni sull'integrazione:

    • Nome visualizzato: un nome descrittivo per l'app 3P. Il nome viene visualizzato nei profili di sicurezza e nella scheda nell'area di lavoro dell'agente. È possibile modificarlo in un secondo momento.

    • Descrizione (opzionale): una descrizione dell'app 3P. Gli agenti non vedono la descrizione.

    • Tipo di integrazione: indica se l'integrazione è un'applicazione web standard (app 3P), un servizio (servizio 3P) o un server MCP. Il tipo determina il modo in cui gli agenti interagiscono con l'integrazione.

    • Identificatore di integrazione: un nome univoco per le integrazioni di tipo applicazione o servizio standard. Se disponi di una sola applicazione per URL di accesso, è consigliabile utilizzare l'origine dell'URL di accesso. Non puoi cambiare questo nome.

    Compila i campi relativi ai dettagli dell'integrazione:

    • Ambito di contatto: indica se l'applicazione web si aggiorna per ogni contatto o solo per ogni nuova sessione del browser. Questa impostazione influisce sulla frequenza con cui l’applicazione aggiorna i propri dati.

    • Timeout di inizializzazione: il tempo massimo, in millisecondi, per stabilire una connessione con l'area di lavoro. Questa impostazione consente di gestire i problemi di connessione e garantisce l’avvio tempestivo dell’applicazione.

    Compila i campi di accesso:

    • URL di accesso: l'URL in cui è ospitata l'applicazione. L'URL deve iniziare conhttps, a meno che non si tratti di un host locale. Non tutti gli URL possono essere racchiusi in iframe. Per ulteriori informazioni, consulta Verifica se un URL può essere inserito in iframe.

    • Origini approvate (opzionale): URL aggiuntivi da consentire, se diversi dall'URL di accesso. Ogni URL deve iniziare conhttps, a meno che non si tratti di un host locale.

    Aggiungi le autorizzazioni agli eventi e alle richieste e imposta la configurazione dell'Iframe. Entrambi sono opzionali.

    In Associazione di istanze, scegli le istanze che possono utilizzare l'applicazione:

    • Puoi concedere a qualsiasi istanza di questo AWS account e della regione l'accesso all'applicazione.

    • L'associazione dell'integrazione a un'istanza è facoltativa, ma non puoi utilizzare l'applicazione finché non lo fai.

      Nota

      Per i server MCP, è possibile scegliere solo l'istanza configurata con l'URL di rilevamento del gateway selezionato.

  5. Scegli Aggiungi integrazione.

  6. Se l'integrazione viene creata correttamente, la pagina dei dettagli dell'integrazione viene visualizzata con un banner di successo.

    La pagina dei dettagli dell'integrazione con un banner di successo.

    Puoi modificare alcuni attributi di un'integrazione esistente, come il nome visualizzato, l'URL di accesso e le autorizzazioni.

    Se si verifica un errore durante la creazione dell'integrazione o l'associazione a un'istanza, viene visualizzato un messaggio di errore. Segui il messaggio per correggere il problema.

Verifica se un URL può essere inserito in iframe

Non tutti gli URL possono essere racchiusi in iframe. Esistono due modi per verificare se un URL può essere inserito in iframe:

  • Utilizzate lo strumento di terze parti Iframe Tester per verificare se un URL può essere iframato.

    • Se un URL può essere modificato in iframe, la pagina visualizza un'anteprima.

    • Se un URL non può essere convertito in iframe, la pagina mostra un errore nell'anteprima. Il sito Web potrebbe mostrare un errore anche se l'app può ancora essere inserita in iframe nell'area di lavoro dell'agente. Uno sviluppatore di app può limitare la propria app in modo che possa essere incorporata solo nell'area di lavoro dell'agente. Se hai ricevuto l'app da uno sviluppatore di app, prova comunque a integrarla nell'area di lavoro dell'agente.

  • Per utenti tecnici: controlla il contenuto della politica di sicurezza dell'applicazione che desideri integrare.

    • Firefox: apri il menu a forma di hamburger, quindi scegli Altri strumenti, Strumenti per sviluppatori Web, Rete.

    • Chrome: apri il menu a tre punti, quindi scegli Altri strumenti, Strumenti per sviluppatori, Rete.

    • Altri browser: trova le impostazioni di rete negli strumenti per sviluppatori.

    La Content-Security-Policy frame-ancestors direttiva dovrebbe esserehttps://your-instance.my.connect.aws. Se la direttiva è same origin odeny, Connect Customer non può iframe dell'URL.

Ecco cosa puoi fare se l'app non può essere modificata in iframe:

  • Se controlli l'app o l'URL, aggiorna la politica di sicurezza dei contenuti dell'app. Per informazioni, consulta Raccomandazioni e best practice nella Agent Workspace Developer Guide.

  • Se non controlli l'app o l'URL, chiedi allo sviluppatore dell'app di aggiornare la politica di sicurezza dei contenuti dell'app.

Esempio: aggiungere un'applicazione e assegnare le autorizzazioni

L'esempio seguente mostra come eseguire l'onboarding di una nuova applicazione e assegnarle le autorizzazioni nel. Console di gestione AWS In questo esempio, si assegnano sei autorizzazioni all'applicazione.

Informazioni di base e dettagli di accesso

La pagina Aggiungi integrazione che mostra le informazioni di base e i campi di accesso.

Autorizzazioni per l'integrazione dei dati nell'area di lavoro

La sezione delle autorizzazioni della pagina Aggiungi integrazione.

Configurazione di iframe

La sezione di configurazione iframe della pagina Aggiungi integrazione.

Elimina le integrazioni

Se non hai più bisogno di un'integrazione, puoi eliminarla. Per interrompere temporaneamente l'utilizzo di un'integrazione, dissociala invece dall'istanza. La dissociazione evita di dover aggiungere nuovamente l'integrazione. Per eliminare un'integrazione, apri Console di gestione AWS, scegli l'integrazione, quindi scegli Elimina.

Risoluzione dei problemi

  • L'eliminazione non riesce se l'integrazione è ancora associata a un'istanza. Dissocia l'integrazione da ogni istanza e quindi eliminala.

Suggerimento

Se hai creato un'integrazione prima del 15 dicembre 2023, potresti avere problemi ad aggiornarne l'associazione con le istanze. Devi prima aggiornare la tua policy IAM.

Errore IAM durante il tentativo di eliminare un'integrazione a causa di autorizzazioni insufficienti.

Aggiorna la tua policy IAM per includere le seguenti autorizzazioni:

  • app-integrations:CreateApplicationAssociation

  • app-integrations:DeleteApplicationAssociation

JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": [ "app-integrations:CreateApplication", "app-integrations:GetApplication" ], "Resource": "arn:aws:app-integrations:us-east-1:111122223333:application/*", "Effect": "Allow" }, { "Action": [ "app-integrations:CreateApplicationAssociation", "app-integrations:DeleteApplicationAssociation" ], "Resource": "arn:aws:app-integrations:us-east-1:111122223333:application-association/*", "Effect": "Allow" }, { "Action": [ "iam:GetRolePolicy", "iam:PutRolePolicy", "iam:DeleteRolePolicy" ], "Resource": "arn:aws:iam::111122223333:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_*", "Effect": "Allow" } ] }