Connessione alle integrazioni nelle app in Quick

Puoi connettere le tue app nelle app Quick a servizi e fonti di dati esterne tramite il framework di integrazione di Amazon Quick. Lo stesso modello di integrazione utilizzato altrove in Quick si applica alle app in Quick. L'agente registra le integrazioni sulla tua app e tu e i tuoi utenti le autorizzate. Per ulteriori informazioni sulle integrazioni, consulta la pagina Lavora con le integrazioni in Amazon Quick.

Prerequisiti

Prima di connettere le integrazioni, conferma quanto segue:

• Hai un account Amazon Quick attivo con accesso Author Pro o superiore.

• L'amministratore ha abilitato i connettori che intendi utilizzare.

Tipi di integrazione

Quick organizza le integrazioni in due categorie:

• Integrazioni della conoscenza: connettiti a fonti di dati su cui il sistema può cercare e ragionare. Nelle app in Quick, si tratta in genere di uno spazio Amazon Quick utilizzato come knowledge base per un'esperienza di chat integrata.

• Integrazioni di azioni: connettiti ad applicazioni e servizi esterni in cui l'app può leggere dati, scrivere dati o eseguire operazioni. Gli esempi includono Microsoft Outlook SharePoint, OneDrive, Slack, Jira e Asana. Quick fornisce oltre 100 connettori Action predefiniti. Puoi anche creare connettori personalizzati utilizzando le specifiche REST API, OpenAPI o MCP.

Modelli di autenticazione

Le integrazioni Action supportano due modelli di autenticazione:

• Autenticazione utente: l'integrazione utilizza le credenziali del singolo utente finale. Ogni utente deve avere il proprio accesso alla risorsa connessa.

• Autenticazione del servizio: l'integrazione utilizza una credenziale a livello di servizio configurata da un amministratore. Tutti gli utenti dell'app condividono tale accesso. Non tutti i connettori supportano l'autenticazione del servizio.

Aggiungere un'integrazione alla tua app

Non è necessario configurare le integrazioni manualmente. Per aggiungere un'integrazione:

1. Chiedi all'agente di utilizzare un servizio specifico nelle tue istruzioni. Ad esempio: «Connettiti al mio calendario di Outlook e visualizza le mie riunioni di questa settimana».

2. Autorizza l'integrazione quando l'agente te lo richiede.

3. Verificate che l'integrazione sia visualizzata nella vista Risorse.

Quando altri utenti aprono l'app pubblicata, autorizzano le proprie credenziali per ogni integrazione registrata al primo utilizzo.

In che modo le app di Quick interagiscono con altre funzionalità di Quick

Le app in Quick si connettono a diverse altre funzionalità di Amazon Quick:

• Amazon Quick spaces: un'app può leggere file da uno spazio, scrivervi nuovi file e utilizzare uno spazio come base di conoscenza per un'esperienza di chat integrata. Per ulteriori informazioni, consulta Organizza, collabora e condividi risorse con gli spazi in Amazon Quick.

• Amazon Quick Flows: non esiste un'integrazione diretta tra le app in Quick e Quick Flows. Utilizza invece uno spazio come livello di dati condiviso. Un flusso elabora i dati e ne salva l'output in uno spazio. L'app legge da quello spazio e visualizza i risultati. Per ulteriori informazioni, consulta Utilizzo delle automazioni Amazon Quick.

Suggerimenti per l'integrazione

• Outlook e OneDrive: questi connettori non risolvono in modo affidabile l'mealias nelle chiamate API. Chiedi all'agente di utilizzare invece l'API di identità dell'utente per recuperare le informazioni dell'utente corrente.

• Slack: lo schema API del connettore Slack non include tutte le operazioni API Slack disponibili. Fornisci dettagli specifici sulle operazioni dell'API Slack di cui hai bisogno, come l'ID del canale e il formato del messaggio.

• Rimozione dell'integrazione: attualmente non puoi rimuovere un'integrazione registrata da un'app tramite l'interfaccia utente delle impostazioni. Come soluzione alternativa, chiedi all'agente di rimuovere i riferimenti all'integrazione nel codice dell'app.