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à.
# Crea, personalizza e distribuisci agenti di chat basati sull'intelligenza artificiale in Amazon Quick
Gli agenti di chat di Amazon Quick aiutano gli utenti a esplorare dati, analizzare informazioni e intraprendere azioni. Gli utenti possono interagire con gli agenti di chat utilizzando l'interfaccia di chat rapida. Gli agenti di chat forniscono assistenza attraverso conversazioni aperte supportate da obiettivi specifici, fonti di conoscenza e qualsiasi strumento connesso. Gli agenti di chat possono evolversi da semplici interfacce per rispondere a domande a funzioni più avanzate che orchestrano flussi di lavoro complessi.
Puoi utilizzare gli agenti di chat per:
+ Generare contenuti e fornire risposte tramite conversazioni in linguaggio naturale
+ Analizza e riepiloga le informazioni provenienti da spazi connessi, dashboard, argomenti, set di dati e file caricati
+ Invoca azioni per eseguire passaggi predefiniti per risultati coerenti e ripetibili
**Nota**
Per ulteriori informazioni sulle chat con gli agenti di chat, consulta [Usare Amazon Quick chat](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html).
**Topics**
+ [Tipi di agenti di chat](#agent-types)
+ [Interazione utente Amazon Quick con gli agenti di chat](#user-agent-actions)
+ [Autorizzazioni utente Amazon Quick per gli agenti di chat](#user-agent-permissions)
+ [Autorizzazioni personalizzate per gli agenti di chat](#custom-permissions-chat-agents)
+ [Agente di chat di sistema](default-assistant.md)
+ [Agenti di chat personalizzati](custom-agents.md)
+ [Fonti contestuali e best practice per gli agenti di chat](agent-knowledge-sources-best-practices.md)
+ [Usa un agente di chat](use-agents.md)
## Tipi di agenti di chat
Amazon Quick supporta due tipi di agenti di chat:
+ **Agente di chat di sistema**: questo agente di chat («Il mio assistente») è automaticamente disponibile per tutti gli utenti per impostazione predefinita. L'agente di chat di sistema funge da pianificatore di base senza dati o azioni intrinseche: accede dinamicamente alle risorse disponibili per ciascun utente durante la chat, consentendone la personalizzazione in base alle autorizzazioni dei singoli utenti e ai contenuti disponibili. Gli utenti amministratori controllano le impostazioni dell'agente di chat di sistema assegnando utenti specifici come proprietari in modo che possano personalizzare il suo personaggio e altre impostazioni.
L'agente di chat di sistema è dotato di tutte le funzionalità di chat, tra cui la funzionalità di caricamento dei file, l'accesso alle conoscenze LLM, la tossicità e altri limiti e la ricerca sul web. Include anche meccanismi di analisi dei dati delle chat che forniscono accesso a spazi, argomenti, dashboard, knowledge base e azioni basate sulle autorizzazioni degli utenti.
+ **Agenti di chat personalizzati**: questi agenti di chat possono essere creati e personalizzati in base a casi d'uso specifici da utenti con funzionalità di creazione di agenti di chat in Amazon Quick e condivisi con chiunque. Gli amministratori possono scegliere di impedire a utenti e gruppi specifici di creare agenti di chat personalizzati, pur consentendo agli utenti di utilizzare agenti di chat tramite chat. Gli agenti di chat restituiscono risposte mirate ai contenuti per i quali gli utenti che effettuano la chiamata dispongono delle autorizzazioni.
Gli agenti di chat personalizzati possono interagire con le risorse Amazon Quick nei seguenti modi:
+ **Preconfigurati con risorse**: questi agenti di chat utilizzano solo le risorse configurate (ad esempio, gli spazi come fonti di conoscenza, i connettori di azione come strumenti) quando cercano risposte o orchestrano azioni come comportamento predefinito. Durante la chat, gli utenti possono allegare risorse aggiuntive in base alle proprie esigenze o invocare azioni direttamente. Ad esempio, gli agenti di chat configurati solo con spazi contenenti file non possono intraprendere azioni per impostazione predefinita a meno che gli utenti non li richiamino esplicitamente. Allo stesso modo, gli agenti di chat configurati solo con azioni si basano sulle conoscenze LLM a meno che gli utenti non alleghino uno spazio o una dashboard per le risposte specifiche dell'azienda. Tuttavia, gli utenti possono aggiungere spazi aggiuntivi o richiamare direttamente altre azioni a cui possono avere accesso all'interno dell'interfaccia di chat.
+ **Non ostinati in fase di compilazione**: questi agenti di chat non sono inizialmente configurati con risorse al momento della creazione (spazi, connettori di azione o entrambi). La chat determina il limite delle risorse per l'agente di chat. Ad esempio, se non è configurato nessuno spazio per l'agente di chat, la chat utilizzerà per impostazione predefinita tutti gli spazi o la conoscenza LLM fino a quando l'utente non apporterà una modifica. Se non è configurato alcun connettore di azione per l'agente di chat, durante la chat tutte le azioni a cui un utente ha accesso saranno disponibili per l'agente finché l'utente non effettuerà una selezione di risorse che non includa azioni.
La selezione delle risorse dell'utente durante la chat influisce sul comportamento dell'agente di chat. Se un utente seleziona uno spazio, l'agente di chat risponderà solo con i dati all'interno di quello spazio e intraprenderà le azioni disponibili all'interno di quello spazio (se non è opinione condivisa in fase di compilazione). Se un utente seleziona una dashboard, un argomento o una knowledge base, l'agente di chat risponderà solo da quella fonte e non intraprenderà alcuna azione poiché l'attenzione viene spostata su una fonte di dati specifica. Gli utenti sono tenuti a selezionare tutte le risorse pertinenti all'interno della chat per un'assistenza completa.
**Nota**
L'agente di chat di sistema è un agente di chat senza opinioni fin dall'inizio. Se desideri che gli agenti di chat accedano a tutte le azioni indipendentemente dal focus sui dati, configura gli agenti di chat con i connettori di azione.
## Interazione utente Amazon Quick con gli agenti di chat
La tabella seguente mostra cosa puoi fare con gli agenti di chat nella console di amministrazione rispetto a come utente Amazon Quick. Per ulteriori informazioni su quali ruoli possono accedere a queste funzionalità, consulta il documento [sui prezzi di Amazon Quick](https://aws.amazon.com/quicksuite/pricing/).
| Livello di accesso | Funzionalità |
| --- | --- |
| Console di amministrazione | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
| Utente Amazon Quick | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
## Autorizzazioni utente Amazon Quick per gli agenti di chat
Ciò che puoi fare con un agente di chat dipende anche dalle autorizzazioni che ti vengono assegnate. È possibile assegnare agli utenti due tipi di autorizzazione:
+ **Proprietario**: i proprietari possono modificare, condividere ed eliminare l'agente di chat.
+ **Visualizzatore**: gli spettatori possono visualizzare e utilizzare l'agente di chat.
**Nota**
Se non hai accesso a una risorsa collegata come visualizzatore o proprietario, le risorse aggiunte all'agente di chat da un altro proprietario vengono visualizzate come «Risorsa non disponibile». Puoi eliminare queste risorse come proprietario, ma non puoi elencarle o aggiungerle perché è richiesta la condivisione a livello di risorsa.
Gli amministratori di Quick devono concedere agli utenti l'autorizzazione a creare agenti di chat. Per informazioni su quali ruoli possono creare agenti di chat, consulta la documentazione [sui prezzi di Amazon Quick](https://aws.amazon.com/quicksuite/pricing/). Per informazioni su come fornire l'accesso a queste funzionalità, consulta [Autorizzazioni personalizzate](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) nella Guida rapida per l'amministratore.
La tabella seguente illustra come le autorizzazioni utente determinano cosa puoi fare con un agente di chat Amazon Quick:
| Tipo di autorizzazioni | Permissions |
| --- | --- |
| Proprietari | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
| Spettatori | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
## Autorizzazioni personalizzate per gli agenti di chat
Per impostazione predefinita, Amazon Quick abilita tutte le nuove funzionalità disponibili per l'account Amazon Quick, in modo che gli utenti possano accedervi immediatamente in base al loro abbonamento. Puoi utilizzare [autorizzazioni personalizzate](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) per limitare funzionalità specifiche. In qualità di amministratore, quando crei un profilo di autorizzazioni personalizzato, puoi creare due tipi di restrizioni per gli agenti di chat:
+ Puoi disattivare completamente tutte le funzionalità degli agenti di chat per gli utenti, tra cui la chat con l'agente predefinito, la chat con gli agenti personalizzati e la creazione di nuovi agenti. Ciò può essere fatto limitando la funzionalità dell'agente di **chat**.
+ Puoi anche limitare in modo specifico la possibilità di creare agenti senza influire sulla chat con gli agenti. Questo può essere fatto creando un profilo di autorizzazione personalizzato e limitando solo la funzione **Crea agenti di chat**.
**Nota**
Se desideri che i tuoi utenti possano chattare utilizzando l'agente di sistema ma non vuoi che creino agenti di chat, limita solo le loro capacità di creazione di agenti di chat.
Le autorizzazioni degli agenti in Amazon Quick possono essere configurate in varie combinazioni per soddisfare le esigenze della tua organizzazione. Per aiutarti a capire come configurare le autorizzazioni, la sezione seguente fornisce un approccio basato sui casi d'uso che raggruppa scenari comuni:
| Scenari di casi d'uso | Cosa possono fare gli utenti |
| --- | --- |
| Agente con tutte le funzionalità(Nessuna restrizione su agenti di chat, spazi, knowledge base, azioni o flussi) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
| Accesso agli agenti solo tramite chat(Funzionalità degli agenti abilitate, ma la creazione di agenti di chat è limitata) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
| Accesso limitato ad altre funzionalità(Agenti di chat abilitati, ma funzionalità specifiche limitate) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
| Nessun accesso all'agente di chat(Le funzionalità dell'agente sono completamente limitate) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/working-with-agents.html) |
# Agente di chat di sistema
L'agente di chat del sistema Amazon Quick viene creato automaticamente quando ti registri a Quick. Funge da interfaccia principale per tutti gli utenti per interagire con i propri dati ed eseguire varie attività all'interno dell'ambiente Quick. È dotato di guardrail predefiniti.
La proprietà dell'agente di chat di sistema è gestita dall'amministratore di Quick. [Gli amministratori possono disabilitare la chat con gli agenti di chat, incluso l'agente di chat di sistema, utilizzando autorizzazioni personalizzate.](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) Se abilitato, gli utenti con ruoli non amministrativi (autori e lettori) possono visualizzare, elencare, richiamare e utilizzare l'agente di chat Quick. Le sue risposte vengono filtrate in base alle autorizzazioni degli utenti alle risorse.
L'agente di chat di sistema Quick è impostato per utilizzare tutte le funzionalità di chat preconfigurate con una personalizzazione minima richiesta. Sebbene queste funzionalità siano disponibili anche per gli agenti di chat personalizzati, devono essere configurate durante la creazione di agenti di chat. L'agente di chat di sistema include:
+ Personaggio predefinito come Assistente rapido, con tono e stile di risposta professionali
+ La funzionalità di caricamento dei file in chat è abilitata
+ Chat conoscitiva con modello di linguaggio di grandi dimensioni (LLM) abilitata
+ Utilizza i guardrail predefiniti configurati per la chat nella console di amministrazione
+ Accesso a tutti gli spazi, gli argomenti, le dashboard, le knowledge base e le azioni in base alle autorizzazioni degli utenti
+ Funzionalità di ricerca sul Web
Per informazioni su come personalizzare un agente di chat di sistema in qualità di amministratore, vedi [Gestione della personalizzazione dell'agente di chat](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-agent.html). Per informazioni su come controllare l'accesso all'agente di chat di sistema, consulta [Gestire le risorse](https://docs.aws.amazon.com/quicksuite/latest/userguide/manage-qs-assets.html).
# Agenti di chat personalizzati
Gli agenti di chat personalizzati consentono agli utenti di Amazon Quick di creare interfacce di conversazione personalizzate per esigenze aziendali specifiche. A differenza dell'agente di chat di sistema, che per impostazione predefinita è disponibile per tutti gli utenti con autorizzazioni di chat, gli agenti di chat personalizzati possono essere condivisi e configurati in modo selettivo da utenti autorizzati.
Gli utenti con funzionalità di creazione di agenti di chat possono personalizzare la personalità, lo stile di risposta e le capacità dell'agente di chat tramite un'interfaccia in linguaggio naturale o tramite il flusso di configurazione di Agent Builder. Questi utenti possono anche configurare questi agenti di chat con fonti di conoscenza (come gli spazi) e flussi di lavoro (come le azioni) specifici, mantenendo il controllo sulla condivisione e sulle autorizzazioni di accesso per ciascuna di queste risorse separatamente. In alternativa, gli agenti di chat possono essere lasciati scollegati per un uso generico, che consente agli utenti finali di utilizzare l'agente con tutte o alcune delle proprie risorse.
Gli amministratori di Quick devono concedere agli utenti l'autorizzazione a creare agenti di chat. Per informazioni su quali ruoli possono creare agenti di chat, consulta la documentazione [sui prezzi di Amazon Quick](https://aws.amazon.com/quicksuite/pricing/). Per informazioni su come fornire o limitare l'accesso a queste funzionalità, consulta [Autorizzazioni personalizzate](https://docs.aws.amazon.com/quicksuite/latest/userguide/create-custom-permissions-profile.html) nella Guida rapida per l'amministratore.
**Topics**
+ [Crea e visualizza in anteprima agenti di chat personalizzati](#create-custom-agents)
+ [Condividi agenti di chat personalizzati](#share-custom-agents)
+ [Incorpora agenti di chat personalizzati](#embed-custom-agents)
+ [Aggiorna agenti di chat personalizzati](#update-custom-agents)
+ [Gestisci l'accesso a un agente di chat personalizzato](#remove-access-custom-agents)
+ [Visualizza gli agenti di chat](#view-agents)
+ [Visualizza i dettagli degli agenti di chat](#view-agent-details)
+ [Agenti di chat personalizzati duplicati](#duplicate-agents)
+ [Elimina gli agenti di chat](#delete-agents)
## Crea e visualizza in anteprima agenti di chat personalizzati
Puoi creare agenti di chat personalizzati in Amazon Quick dal menu **Agenti di chat** nella home page di Amazon Quick. Puoi visualizzare in anteprima e testare il tuo agente di chat mentre lo crei. Quando crei un agente di chat personalizzato, per impostazione predefinita vieni assegnato come proprietario. La procedura seguente illustra come creare un agente di chat personalizzato.
------
#### [ Using natural language ]
**Per creare un agente di chat personalizzato utilizzando un prompt in linguaggio naturale**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**, quindi seleziona **Crea agente di chat**.
1. In **Nuovo agente di chat**, procedi come segue:
1. Nella casella di immissione del testo, inserisci una descrizione in linguaggio naturale per il tipo di agente di chat che desideri creare. Questa è la richiesta che Amazon Quick utilizzerà per creare il tuo agente di chat. Puoi utilizzare le istruzioni di esempio suggerite nella pagina anche per creare il tuo agente di chat.
1. Quindi, seleziona **Genera**. La selezione di **Genera** prende le istruzioni o gli obiettivi forniti e li espande nelle istruzioni e nelle configurazioni degli agenti di chat. Inoltre, analizza le risorse disponibili dell'utente (spazi e connettori di azione) e trova le corrispondenze più pertinenti in base all'intento fornito dall'agente di chat. L'interfaccia utente ampliata del builder viene aperta con queste configurazioni per consentire all'utente di rivederla, personalizzarla, testarla e avviarla.
1. Nella pagina **Configura l'agente di chat**, assicurati che il tuo agente di chat abbia le impostazioni corrette e personalizza ulteriormente il tuo agente di chat. Fai clic su **Aggiorna anteprima** per assicurarti che tutte le modifiche vengano salvate prima di provare l'agente di chat in anteprima.
1. Quando sei pronto, seleziona **Launch chat agent** per pubblicare il tuo agente di chat personalizzato nella libreria degli agenti di chat e utilizzarlo in chat.
**Nota**
Finché non selezioni **Launch chat agent**, il tuo agente di chat non è disponibile nella libreria degli agenti di chat. Se esci dal processo di creazione senza avviarlo, la versione di anteprima verrà eliminata e l'agente di chat non verrà salvato.
Quando avvii un agente di chat, questo rimane privato per impostazione predefinita. L'agente di chat diventa disponibile nelle librerie degli altri utenti solo dopo averlo condiviso. Una volta condivisa, le modifiche e gli avvii successivi pubblicheranno le modifiche allo stesso agente di chat per tutti gli utenti che hanno accesso.
------
#### [ Using builder view directly ]
**Per creare un agente di chat personalizzato utilizzando la modalità builder**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**, quindi seleziona **Crea agente di chat**.
1. In **Agent Creator**, seleziona **Ignora**. Si apre la pagina di configurazione dell'agente di chat da cui puoi creare e personalizzare il tuo agente di chat.
1. Aggiungi un nome per il tuo agente di chat personalizzato. Questo è il nome con cui verrà identificato il tuo agente di chat.
1. (Facoltativo) Aggiungi una descrizione per il tuo agente di chat personalizzato che aiuti gli utenti a comprendere lo scopo dell'agente di chat.
1. (Facoltativo) Seleziona un'icona per il tuo agente di chat.
1. In **Configura l'agente di chat**, personalizza le seguenti sezioni:
1. In **AGENT PERSONA**, configura la personalità, l'identità, il tono e lo stile di risposta del tuo agente di chat:
+ Per **l'identità dell'agente**: definisci l'identità del tuo agente di chat. Ad esempio, puoi dargli istruzioni sul nome e sulla personalità. Amazon Quick utilizzerà le impostazioni predefinite se lasciato vuoto.
+ Per **istruzioni su Persona**: aggiungi istruzioni su come il tuo agente di chat interagisce con gli utenti durante la chat. Ad esempio, puoi definire quali sono le attività principali del tuo agente di chat. Amazon Quick li utilizza per personalizzare il personaggio del tuo agente di chat.
1. In **Stile di comunicazione**, per **Scegli uno stile di risposta predefinito**: scegli uno stile di risposta. Puoi scegliere tra i seguenti preset di stile di risposta o aggiungere istruzioni personalizzate:
+ **Executive**: ottimizzato per comunicazioni aziendali di alto livello e approfondimenti strategici.
+ **Tecnico**: ottimizzato per spiegazioni tecniche dettagliate e risoluzione di problemi tecnici.
+ **Creativo**: configurazione standard per interazioni generiche.
Ogni preimpostazione ha le seguenti impostazioni:
+ For **Tone**: aggiungi un prompt in linguaggio naturale per definire il tono dell'agente. Amazon Quick lo utilizzerà per personalizzare la personalità del tuo agente di chat.
+ Per il **formato di risposta**: aggiungi un prompt in linguaggio naturale per definire lo stile di risposta del tuo agente di chat. Amazon Quick lo utilizzerà per personalizzare lo stile di risposta del tuo agente di chat. Definisci il formato delle risposte del tuo agente di chat, ad esempio: «Usa i bullet point per elenchi più lunghi di 3 elementi».
+ Per la **lunghezza**: specifica la durata delle risposte del tuo agente di chat. Definisci la lunghezza delle risposte del tuo agente di chat, ad esempio: «Mantieni le risposte al di sotto delle 100 parole».
Quando scegli una preimpostazione da utilizzare, Amazon Quick compila automaticamente le istruzioni relative al **tono**, **al formato di risposta** e alla **lunghezza** per le risposte del tuo operatore di chat in base allo stile scelto. Puoi personalizzare ulteriormente i prompt esistenti utilizzando il linguaggio naturale o crearne di nuovi.
1. Nei **documenti di riferimento**, carica i file che rimangono attivi nella memoria del tuo agente di chat per guidare tutte le interazioni. Per ulteriori informazioni su come i documenti di riferimento funzionano con altri tipi di contesto, vedi [Tipi di contesto dell'agente](quicksuite/latest/userguide/agent-knowledge-sources-best-practices.html).
+ Seleziona **Carica file** o trascina i documenti per allegare file che guideranno le risposte del tuo agente di chat.
+ Puoi allegare documenti in formato.pdf, .txt, .html, .md, .csv, .doc o .docx. Dai documenti caricati verranno estratti e accettati fino a 100.000 caratteri di testo.
1. (Facoltativo) In **Knowledge sources**, scegli tra le seguenti opzioni:
+ Continua senza collegare le fonti di conoscenza
+ Il tuo agente di chat genererà risposte basandosi sulla conoscenza del Large Language Model (LLM) e su tutte le risorse Amazon Quick a cui l'utente che interagisce ha accesso. Puoi scegliere di selezionare una fonte di conoscenza specifica su cui concentrarti durante la chat. Scegli questa opzione se desideri creare un agente di chat generico.
+ Per collegare spazi specifici esistenti
+ Seleziona **Link**.
+ Nella modalità **Link spaces**, seleziona gli spazi che desideri collegare al tuo agente di chat, quindi seleziona **Collega**.
Il sistema visualizza un messaggio di successo per indicare che il collegamento è riuscito.
Se colleghi un agente di chat a una fonte di conoscenza, il tuo agente di chat genererà risposte basandosi sulle conoscenze dei Large Language Model (LLM) e sui dati provenienti esclusivamente da risorse collegate. Puoi aggiungere fino a un'altra fonte di conoscenza a questo agente di chat come contesto temporaneo durante la chat.
+ Per creare e collegare un nuovo spazio
+ Seleziona **Crea**.
+ Nella finestra **Crea spazio** che si apre, seleziona le risorse che desideri aggiungere allo spazio, quindi seleziona **Crea**.
Se colleghi un agente di chat a una fonte di conoscenza, il tuo agente di chat genererà risposte basandosi sulle conoscenze e sui dati dei Large Language Model (LLM) solo da risorse collegate. Puoi aggiungere fino a un'altra fonte di conoscenza a questo agente di chat come contesto temporaneo durante la chat.
**Nota**
Per ulteriori informazioni sulla creazione e l'uso degli spazi, consulta [Lavorare con gli spazi in Amazon Quick](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-spaces.html).
Il sistema visualizza un messaggio di successo per indicare che la creazione dello spazio è riuscita. Torna alla finestra di creazione dell'agente di chat.
+ Nella finestra di creazione dell'agente di chat, da **Knowledge sources** seleziona **Link**.
+ Dalla modalità **Link spaces**, seleziona lo spazio appena creato, quindi seleziona **Link**.
Il sistema visualizza un messaggio di successo per indicare che il collegamento è riuscito.
1. (Facoltativo) In **Azioni**, per **Azioni**: scegliete tra le seguenti opzioni:
+ Per collegare azioni specifiche esistenti
+ Seleziona **Link**.
+ Dalla modalità **Link action connectors**, seleziona i connettori di azione che desideri collegare al tuo agente di chat, quindi seleziona **Avanti**.
+ In **Azioni**, seleziona le azioni che desideri aggiungere, quindi seleziona **Link**.
Il sistema visualizza un messaggio di successo per indicare che il collegamento è riuscito.
+ Per creare un connettore di azione e collegare nuove azioni
+ Seleziona **Crea**.
+ Dalla home page **Azioni**, seleziona **Nuova azione**.
+ Nella finestra **Nuova azione**, per **Sorgenti** seleziona il connettore di azione che desideri aggiungere, quindi seleziona **Avanti**.
+ In **Azioni** esamina le azioni disponibili, quindi seleziona **Avanti**.
+ In **Dettagli di connessione**, inserisci i dettagli di connessione necessari e seleziona **Aggiungi**.
**Nota**
Per ulteriori informazioni sulla creazione e l'utilizzo di Action Connector, consulta [Azioni in Amazon Quick](https://docs.aws.amazon.com/quicksuite/latest/userguide/qbs-actions.html).
Il sistema visualizza un messaggio di successo per indicare che l'azione è stata aggiunta con successo. Torna alla finestra di creazione dell'agente di chat.
+ Nella finestra di creazione dell'agente di chat, da **Azioni** seleziona **Link**.
+ Dalla modalità **Link action connectors**, seleziona il connettore di azione che hai appena creato, quindi seleziona **Link**.
Il sistema visualizza un messaggio di successo per indicare che il collegamento è riuscito.
1. In **Personalizzazione, effettuate** le seguenti operazioni:
1. Per **messaggio di benvenuto**: aggiungi un messaggio di benvenuto che il tuo agente di chat possa mostrare all'utente finale.
1. Per i **suggerimenti suggeriti: aggiungi istruzioni** di esempio per avviare una conversazione per informare gli utenti finali delle funzionalità degli agenti di chat.
1. Seleziona **Launch chat agent per creare il tuo agente** di chat personalizzato.
**Nota**
Finché non selezioni **Launch chat agent**, il tuo agente di chat non è disponibile nella libreria dell'agente di chat. Se esci dal processo di creazione senza avviarlo, la versione di anteprima verrà eliminata e l'agente di chat non verrà salvato.
Quando avvii un agente di chat, questo rimane privato per impostazione predefinita. L'agente di chat diventa disponibile nelle librerie degli altri utenti solo dopo averlo condiviso. Una volta condivisa, le modifiche e gli avvii successivi pubblicheranno le modifiche allo stesso agente di chat per tutti gli utenti che hanno accesso.
------
## Condividi agenti di chat personalizzati
Quando crei un agente di chat, per impostazione predefinita ti viene assegnato il ruolo di proprietario. Puoi scegliere di condividere un agente di chat di tua proprietà con altri utenti Amazon Quick utilizzando le seguenti autorizzazioni:
+ Autorizzazioni *del proprietario*: l'utente può modificare, condividere, utilizzare ed eliminare l'agente di chat.
+ Autorizzazioni di *visualizzazione*: l'utente può visualizzare e utilizzare l'agente di chat.
Puoi anche definire le autorizzazioni di accesso per un agente di chat a livello globale, concedendo a tutti gli utenti l'accesso a un agente di chat e quindi definendo autorizzazioni di accesso più granulari per utenti e gruppi specifici.
La procedura seguente mostra come condividere e assegnare autorizzazioni agli agenti di chat.
**Per condividere agenti di chat personalizzati**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Quindi, nella colonna **Azioni** relativa all'agente di chat che desideri condividere, seleziona l'icona del menu, quindi seleziona **Condividi**.
1. Nella finestra di **dialogo Condividi agente di chat** che si apre, inserisci il nome dell'utente o del gruppo con cui desideri condividere l'agente di chat. Quando viene visualizzato il nome dell'utente o del gruppo, selezionalo. Ripeti l'azione per tutti i gruppi o gli utenti con cui desideri condividere l'agente di chat. La modalità mostra gli utenti e i gruppi che stai aggiungendo.
1. Assegna le autorizzazioni e le informazioni di accesso a ogni utente o gruppo con cui condividi il tuo agente di chat utilizzando il menu a discesa accanto al nome dell'utente o del gruppo. Puoi assegnare uno dei due ruoli:
+ **Proprietario**: l'utente può modificare, condividere ed eliminare l'agente di chat.
+ **Visualizzatore**: l'utente può visualizzare e utilizzare l'agente di chat.
1. Seleziona **Condividi**.
## Incorpora agenti di chat personalizzati
Puoi incorporare un agente di chat personalizzato in un sito Web o un'applicazione esterna in modo che gli utenti possano interagire con esso al di fuori della console Amazon Quick. Per incorporare un agente di chat, devi prima consentire il dominio di hosting nelle impostazioni di amministrazione di Amazon Quick, quindi generare il codice di incorporamento dalle opzioni di condivisione dell'agente di chat.
L'incorporamento di un agente di chat prevede due passaggi:
1. **Consenti il dominio di hosting**: un amministratore di Amazon Quick deve aggiungere il dominio (e facoltativamente i relativi sottodomini) in cui l'agente di chat incorporato sarà ospitato all'elenco dei domini consentiti.
1. **Genera il codice di incorporamento**: il proprietario dell'agente di chat o un utente autorizzato genera il codice di incorporamento dalle opzioni di condivisione dell'agente di chat.
### Consenti un dominio per gli agenti di chat incorporati
Prima di poter incorporare un agente di chat su un sito Web esterno, un amministratore di Amazon Quick deve aggiungere il dominio di hosting all'elenco degli account consentiti. Devi essere un amministratore di Amazon Quick per completare questa procedura. Ciò garantisce che solo i domini approvati possano ospitare agenti di chat incorporati.
**Per consentire l'incorporamento di un dominio**
1. Accedi alla console Amazon Quick.
1. Scegli l'icona del profilo.
1. Scegli **Gestisci account**.
1. Nel riquadro di navigazione sotto **Sicurezza**, scegli **Gestisci domini**.
1. Nel campo **Dominio**, inserisci il nome di dominio in cui desideri ospitare l'agente di chat incorporato (ad esempio,`https://example.com`).
1. (Facoltativo) Seleziona **Includi sottodomini** per consentire gli agenti di chat incorporati su tutti i sottodomini del dominio specificato.
1. Scegliere **Aggiungi**.
Il dominio ora appare nell'elenco dei domini consentiti. Puoi modificare o eliminare i domini esistenti scegliendo le icone di modifica o eliminazione accanto a ciascun dominio nell'elenco.
### Genera il codice di incorporamento per un agente di chat
Dopo aver autorizzato il dominio di hosting, puoi generare il codice di incorporamento per un agente di chat.
**Per generare il codice di incorporamento per un agente di chat**
1. Accedi alla console Amazon Quick.
1. Dal pannello di navigazione, scegli **Agenti di chat**.
1. Nella colonna **Azioni** relativa all'agente di chat che desideri incorporare, scegli l'icona del menu, quindi scegli **Modifica**.
1. Nell'editor dell'agente di chat, scegli **Condividi**.
1. Nelle opzioni di condivisione, scegli **Condividi tramite incorporamento**.
1. Copia il codice di incorporamento fornito e incollalo nell'HTML del tuo sito Web o dell'applicazione in cui desideri che appaia l'agente di chat.
L'agente di chat integrato è ora disponibile sul tuo sito web. Gli utenti che visitano la pagina possono interagire direttamente con l'agente di chat.
## Aggiorna agenti di chat personalizzati
Puoi aggiornare agenti di chat personalizzati in Amazon Quick dal menu **Agenti** nella home page di Amazon Quick. La procedura seguente illustra come eseguire questa operazione.
**Nota**
Puoi vedere in anteprima come si comportano gli aggiornamenti delle personalizzazioni dell'agente di chat, durante la configurazione dell'agente di chat, nell'interfaccia di anteprima della chat. Assicurati di selezionare **Aggiorna anteprima** prima di testare una modifica. Una volta che tutte le modifiche sono state testate in anteprima, seleziona **Avvia** per pubblicare le modifiche all'agente di chat attualmente in uso.
**Per aggiornare un agente di chat personalizzato**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Quindi, nella colonna **Azioni** relativa all'agente di chat che desideri condividere, seleziona l'icona del menu, quindi seleziona **Modifica**. In questo modo viene creata una versione di anteprima del tuo agente di chat da aggiornare e testare prima della pubblicazione.
1. In **Modifica agente**, aggiorna le impostazioni del tuo agente di chat, quindi seleziona **Avvia**.
## Gestisci l'accesso a un agente di chat personalizzato
Se sei il proprietario di un agente di chat, puoi scegliere di modificare le autorizzazioni di accesso degli utenti per un agente di chat. Puoi anche rimuovere l'accesso di utenti e gruppi a un agente di chat. La procedura seguente mostra come procedere.
**Per gestire l'accesso agli agenti di chat personalizzati**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Quindi, nella colonna **Azioni** relativa all'agente di chat che desideri condividere, seleziona l'icona del menu, quindi seleziona **Condividi**.
1. Nella **modalità Condividi agente di chat** che si apre, seleziona l'utente e il gruppo per cui desideri modificare le autorizzazioni. Quando viene visualizzato il nome dell'utente o del gruppo, selezionalo e modifica le autorizzazioni. Ripeti l'azione per tutti i gruppi o gli utenti per cui desideri modificare le autorizzazioni. La modalità mostra le autorizzazioni degli utenti e dei gruppi che stai modificando. Puoi eseguire le tre azioni seguenti:
+ Passa a **proprietario**: l'utente può modificare, condividere ed eliminare l'agente di chat.
+ Passa a **visualizzatore**: l'utente può visualizzare e utilizzare l'agente di chat.
+ **Rimuovi accesso**: rimuove l'accesso di utenti o gruppi a un agente di chat.
**Nota**
Puoi anche definire le autorizzazioni di accesso a un agente di chat a livello globale, concedendo a tutti gli utenti l'accesso a un agente di chat e quindi definendo autorizzazioni di accesso più granulari per utenti e gruppi specifici. A tale scopo, scegli **Impostazioni** e quindi utilizza **Impostazioni globali** per attivare o disattivare questa funzionalità.
1. Seleziona **Condividi**.
## Visualizza gli agenti di chat
Puoi visualizzare un elenco degli agenti di chat che hai creato o a cui hai accesso. La procedura seguente mostra come procedere.
**Per visualizzare agenti di chat personalizzati**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Gli agenti di chat che hai creato o a cui hai accesso verranno visualizzati nella home page **degli agenti di chat**.
## Visualizza i dettagli degli agenti di chat
Puoi visualizzare i dettagli degli agenti di chat creati da te o condivisi con te, inclusi tutti gli spazi e le azioni associati a ciascun agente di chat.
**Per visualizzare i dettagli degli agenti di chat**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Quindi, dall'elenco degli agenti di chat, nella colonna **Nome**, fai clic sul nome dell'agente di chat di cui desideri visualizzare i dettagli. Si aprirà una finestra modale dettagliata.
**Nota**
Puoi anche visualizzare i dettagli dell'agente di chat accedendo alla colonna **Azioni** relativa all'agente di chat che desideri condividere, selezionando l'icona del menu e quindi selezionando **Visualizza i dettagli dell'agente di chat**.
1. Nella finestra di dialogo con i dettagli dell'agente di chat che si apre, vedrai i seguenti dettagli:
1. **Descrizione**: la descrizione dell'agente di chat.
1. **Riepilogo delle istruzioni**: un riepilogo delle istruzioni definite per l'agente di chat.
1. **Creato da**: indica se l'agente di chat è stato creato da te o da qualcun altro.
1. **Ultima modifica**: l'ora dell'ultima modifica apportata all'agente di chat.
1. In **Funzionalità**:
+ **Conoscenza**: le fonti di conoscenza a cui l'operatore di chat è collegato o a cui ha accesso. Se il tuo agente di chat è collegato a uno spazio, potrai vedere a quale spazio è collegato.
+ **Azioni**: le azioni a cui l'agente di chat è collegato o a cui ha accesso. Puoi anche visualizzarlo facendo clic sulle **informazioni** accanto al nome dell'agente nel selettore degli agenti dell'interfaccia utente della chat.
## Agenti di chat personalizzati duplicati
Puoi duplicare gli agenti di chat personalizzati esistenti senza creare un agente di chat da zero. Gli utenti possono duplicare gli agenti di chat dalla pagina dell'elenco utilizzando il pulsante di **azione Duplica.** Quando duplichi un agente di chat, Amazon Quick crea un nuovo agente di chat con il formato del nome «[Nome originale] (copia)», che puoi modificare. Tutti i campi e le configurazioni dell'agente di chat originale vengono copiati nella nuova versione dell'agente di chat. Una volta duplicato, puoi assegnare autorizzazioni di accesso utente personalizzate all'agente di chat duplicato e condividerlo.
La procedura seguente descrive come duplicare gli agenti di chat.
**Per duplicare agenti di chat personalizzati**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Quindi, nella colonna **Azioni** relativa all'agente di chat che desideri condividere, seleziona l'icona del menu, quindi seleziona **Duplica**.
Verrai reindirizzato a una modalità di duplicazione dell'agente di chat con campi precompilati.
1. Apporta le modifiche necessarie, tra cui l'aggiunta delle autorizzazioni corrette per utenti e gruppi e il collegamento alle risorse che desideri, quindi seleziona **Avvia per avviare** il tuo agente di chat duplicato.
## Elimina gli agenti di chat
Puoi eliminare un agente di chat Amazon Quick di tua proprietà. La procedura seguente mostra come.
**Per eliminare un agente di chat personalizzato**
1. Accedi alla console Amazon Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Quindi, nella colonna **Azioni** relativa all'agente di chat che desideri condividere, seleziona l'icona del menu, quindi seleziona **Elimina**.
# Fonti contestuali e best practice per gli agenti di chat
Quando crei agenti di chat personalizzati in Amazon Quick, hai diverse opzioni per influenzare il comportamento degli agenti di chat e inquadrare i flussi di lavoro degli agenti di chat. Il modo in cui configuri il contesto e le istruzioni dell'agente di chat influisce in modo significativo sulle prestazioni e sulla risposta dell'agente di chat alle interazioni con gli utenti. Capire quando utilizzare le istruzioni, i documenti di riferimento e gli spazi è fondamentale per creare agenti di chat efficaci che soddisfino le esigenze aziendali specifiche e forniscano risultati coerenti e affidabili. Le sezioni seguenti descrivono come utilizzare al meglio il contesto e le conoscenze degli agenti di chat per il proprio caso d'uso.
**Topics**
+ [Tipi di contesto dell'agente](#knowledge-source-types)
## Tipi di contesto dell'agente
Amazon Quick offre tre metodi distinti per configurare il comportamento degli agenti di chat, ognuno dei quali serve a scopi diversi nello sviluppo degli agenti di chat. La comprensione di come ciascun metodo elabora i contenuti e quando utilizzarli costituisce la base per una configurazione efficace degli agenti di chat.
I tre tipi di contesto disponibili in Amazon Quick sono:
+ **Istruzioni personali**: linee guida di alto livello che Amazon Quick migliora utilizzando strumenti generativi AI
+ **Documenti di riferimento**: documenti che forniscono istruzioni precise e rimangono attivi nella memoria dell'operatore di chat
+ **Spaces**: raccolte di risorse e documenti Amazon Quick ricercabili da cui gli agenti di chat recuperano informazioni per rispondere alle domande
La sezione seguente descrive in dettaglio cosa sono e le migliori pratiche per utilizzarli.
**Topics**
+ [Istruzioni personali per l'agente di chat](#agent-instructions)
+ [Documenti di riferimento per gli agenti di chat](#in-context-files)
+ [Agenti e spazi di chat](#spaces)
### Istruzioni personali per l'agente di chat
Fornisci le istruzioni relative alla persona dell'agente di chat nel campo **Istruzioni Persona** quando crei il tuo agente di chat personalizzato. Queste istruzioni personali vengono perfezionate utilizzando l'intelligenza artificiale generativa per garantire che funzioni con tutte le funzionalità di chat e le risorse configurate per l'agente di chat. Questo approccio è ideale quando si desidera che il sistema si basi sulla propria direzione fondamentale. Quando usi le istruzioni personali, Amazon Quick utilizza la tecnologia generativa AI per interpretare ed espandere le istruzioni personali nel backend, arricchire le linee guida semplici con contesto e funzionalità aggiuntivi, ottimizzare i prompt per migliorare le prestazioni degli agenti di chat e aumentare l'efficacia attraverso miglioramenti guidati. AI
**Usa le istruzioni personali per:**
+ Fornisci linee guida di alto livello su comportamento e obiettivi, migliorate da Amazon Quick AI per personalizzare le risposte degli agenti
+ Scopri come utilizzare i documenti di riferimento per interazioni dettagliate
+ Fornisce una guida generale sull'uso degli spazi e dei connettori di azione nelle sue risposte
Questo approccio funziona meglio per gli agenti di chat generici e per i casi d'uso esplorativi in cui si desidera trarre vantaggio dall'AIassistenza nella progettazione degli agenti di chat.
**Nota**
Il processo di AI miglioramento può modificare la formulazione e la struttura originali per migliorare le prestazioni degli agenti di chat. Le linee guida fondamentali che devono rimanere invariate dovrebbero invece essere inserite nei documenti di riferimento.
### Documenti di riferimento per gli agenti di chat
I documenti di riferimento forniscono modelli di processo e risposta specifici che gli agenti di chat devono seguire. Questi documenti di riferimento fanno parte del contesto permanente dell'agente di chat e sono hand-in-hand accompagnati da istruzioni personali e da uno stile di risposta che ne determinano il comportamento generale.
I documenti di riferimento forniscono il controllo completo sul comportamento degli agenti di chat, preservando i contenuti esattamente come sono scritti. Questo approccio è essenziale quando la precisione e la coerenza sono fondamentali. Quando carichi documenti di riferimento, Amazon Quick conserva una formulazione precisa e istruzioni specifiche, mantiene la formattazione e la struttura esatte, fornisce il controllo diretto sul comportamento degli agenti di chat e garantisce la coerenza in tutte le interazioni.
**Usa i documenti di riferimento quando hai bisogno di:**
+ Controllo esatto in cui è necessario preservare la formulazione precisa e le istruzioni specifiche
+ Coerenza del marchio con toni, terminologia o formati di risposta specifici
+ Flussi di lavoro complessi con processi in più fasi che devono seguire sequenze esatte
+ Comportamento prevedibile con risposte coerenti in tutte le interazioni
**Formati di file supportati:**
+ `.pdf`,`.txt`,`.html`, `.md` — Istruzioni, modelli e linee guida
+ `.csv`— Dati di riferimento, tabelle di ricerca ed esempi
+ `.doc`, `.docx` — Documentazione dettagliata del processo
È possibile allegare fino a 10 file della dimensione totale di 50 MB come documenti di riferimento. Amazon Quick estrae il testo da questi documenti e applica un limite di 100.000 caratteri dopo l'elaborazione.
**Assegnazione di priorità e comportamento dei file**
I framework comportamentali e i dati di riferimento dei file rimangono attivi anche quando gli utenti allegano contenuti alternativi.
I modelli di risposta possono essere temporaneamente modificati se gli utenti forniscono istruzioni di formattazione contrastanti.
I documenti di riferimento fungono da manuale operativo dell'agente di chat e forniscono il quadro comportamentale che rimane costante in tutte le interazioni dell'utente con l'agente di chat.
### Agenti e spazi di chat
Gli spazi forniscono archivi di conoscenze dinamici e ricercabili che gli agenti di chat interrogano durante le conversazioni per recuperare informazioni specifiche. Quando colleghi gli spazi agli agenti di chat, gli agenti di chat di Amazon Quick cercano le risposte all'interno dello spazio per generare risposte. Spaces eccelle nella gestione delle conoscenze organizzative che si evolvono nel tempo, consentendo a più membri del team di contribuire e aggiornare le informazioni mantenendo al contempo i limiti di sicurezza appropriati attraverso il sistema di autorizzazione di Amazon Quick.
Usa gli spazi con gli agenti di chat per:
+ Consentire agli agenti di chat di cercare e recuperare i dati aziendali correnti
+ Fornire agli agenti di chat l'accesso agli archivi di conoscenze organizzative
+ Consentire agli agenti di chat di rispettare i limiti di autorizzazione esistenti
+ Connettere gli agenti di chat a raccolte di documenti collaborative
+ Consentire agli agenti di chat di accedere a informazioni regolarmente aggiornate
+ Consentire agli agenti di chat di interrogare dashboard e set di dati in tempo reale
Spaces funge da livello di conoscenza dinamico dell'agente di chat, che consente l'accesso in tempo reale alle informazioni organizzative mantenendo i limiti di sicurezza e i flussi di lavoro collaborativi.
# Usa un agente di chat
Puoi utilizzare un agente di chat di Amazon Quick per porre domande e svolgere le tue attività. Quando fai una domanda, l'agente di chat analizza gli ultimi dati approvati condivisi con te per generare una risposta completa.
Puoi porre domande complesse in un linguaggio semplice e ottenere una risposta dettagliata. Puoi anche utilizzare un agente di chat rapida per eseguire attività al posto tuo, come redigere un messaggio e-mail, creare un ticket o utilizzare i flussi.
**Per utilizzare agenti di chat personalizzati**
1. Accedi alla console Quick.
1. Dal menu di navigazione a sinistra, seleziona **Agenti di chat**
1. Quindi, nella colonna **Azioni** relativa all'agente di chat che desideri condividere, seleziona l'icona del menu, quindi seleziona **Chat**.
Si aprirà un'interfaccia di chat che utilizzerai per interagire con il tuo agente di chat.
Puoi interagire con un agente di chat nei seguenti modi:
+ Visualizza e accedi a esempi di istruzioni per illustrare possibili domande e attività
+ Ottieni risposte contestuali da fonti di dati organizzative
+ Continua o avvia nuove conversazioni
+ Analizza i dati, inclusi il riepilogo e l'analisi comparativa
+ Intraprendi azioni come la pianificazione di riunioni e la creazione di ticket
+ Visualizza le citazioni delle fonti alle risposte con riferimenti numerati cliccabili
+ Carica file
+ Visualizza la cronologia delle conversazioni
**Suggerimento**
Puoi anche utilizzare i tuoi agenti di chat mentre automatizzi le tue attività di routine con Quick Flows. Per ulteriori informazioni, consulta [Agente di chat](ai-response-steps.md#chat-agent-step).
Per ulteriori informazioni sulle chat con gli agenti di chat, consulta [Usare Amazon Quick chat](https://docs.aws.amazon.com/quicksuite/latest/userguide/using-quick-chat.html).