View a markdown version of this page

Aggiorna i modelli per i prompt e gli agenti AI - Cliente Amazon Connect
PrerequisitiQuando effettuare l'aggiornamentoCome funziona la risoluzione dei modelliScenario 1: agente AI personalizzato con prompt AI personalizzatiScenario 2: agente AI personalizzato senza modifiche ai promptScenario 3: aggiornamento delle configurazioni predefinite dell'agente AIRiepilogoConsiderazioni importanti

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

Aggiorna i modelli per i prompt e gli agenti AI

Quando personalizzi i prompt AI o gli agenti AI in Amazon Connect, il modello associato a ciascun prompt AI determina quale modello di linguaggio di grandi dimensioni (LLM) elabora le istruzioni. Nel tempo, diventano disponibili modelli più nuovi e più efficienti. Questo argomento descrive come aggiornare i modelli in alcuni scenari comuni.

  • Hai un agente AI personalizzato con uno o più prompt AI personalizzati che utilizza un modello obsoleto

  • Hai un agente AI personalizzato senza interruzioni dei prompt

  • Stai utilizzando versioni precedenti di System AI Agents.

Prerequisiti

Prima di aggiornare i modelli, assicurati di disporre di quanto segue:

Quando effettuare l'aggiornamento

Amazon Connect ti avvisa quando è prevista l'obsolescenza di un modello. Amazon Connect reindirizza automaticamente l'inferenza LLM a un modello supportato dopo che un modello ha superato la data di obsolescenza, in modo che non si verifichino interruzioni del servizio. Tuttavia, l'aggiornamento manuale prima della data di obsolescenza consente di scegliere il modello sostitutivo e testarlo nel proprio ambiente. Utilizzate i seguenti passaggi per determinare quali scenari si applicano al vostro caso.

Passaggio 1: verifica la presenza di agenti AI personalizzati. Nel sito Web di amministrazione, accedi a AI agent designer, AI agent. Guarda la colonna Tipo. Visualizzazione degli agenti di sistema: Sistema dopo il nome del tipo (ad esempio, «Raccomandazione di risposta - Sistema»). Gli agenti senza questo suffisso sono agenti personalizzati creati dall'utente.

  • Se disponi di un agente AI personalizzato a cui sono assegnati uno o più prompt AI personalizzati → Scenario 1 (se hai ignorato solo alcuni tipi di prompt, il comando unset richiede l'aggiornamento automatico; devi solo aggiornare i prompt personalizzati)

  • Se disponi di un agente AI personalizzato senza modifiche ai prompt → Scenario 2 (richiede l'aggiornamento automatico, non è necessaria alcuna azione)

  • Se non disponi di agenti AI personalizzati, vai alla Fase 2.

Passaggio 2: verifica le configurazioni predefinite dell'agente AI. Nella stessa pagina degli agenti AI, scorri fino alla sezione Configurazioni predefinite degli agenti AI. Se un caso d'uso è associato a una versione specifica (non impostato su Più recente), puoi aggiornarlo → Scenario 3. Questo vale per tutti i clienti, anche se non hai agenti doganali.

Come funziona la risoluzione dei modelli

Quando configuri un singolo agente AI, hai la possibilità di lasciare che Connect scelga quale LLM utilizzare per ogni prompt, scelga il modello che desideri venga utilizzato da ogni prompt o scegli una combinazione delle due opzioni.

  • Ogni prompt AI ha una proprietà del modello che specifica quale LLM utilizzare.

  • Ogni agente AI fa riferimento a una o più versioni del prompt AI. Una versione è un'istantanea immutabile del prompt, inclusa la selezione del modello.

  • Quando crei un agente AI personalizzato e sostituisci solo alcuni dei prompt associati all'agente, i tipi rimanenti vengono compilati in base alle impostazioni predefinite del sistema in fase di esecuzione. I prompt impostati in modo esplicito vengono aggiunti alla versione scelta. I prompt compilati dal sistema utilizzano le impostazioni predefinite di sistema più recenti. Questa risoluzione per tipo di prompt si applica ai tipi di agenti AI non agenti come Answer Recommendation, Manual Search e Self Service. Non-Agentic

  • I modelli disponibili dipendono dalla regione AWS dell'istanza Amazon Connect. Per un elenco dei modelli supportati per regione, consultaModelli supportati per i prompt system/custom.

Scenario 1: agente AI personalizzato con prompt AI personalizzati

In questo scenario, hai creato un agente AI personalizzato e gli hai assegnato uno o più prompt AI personalizzati. I prompt personalizzati vengono aggiunti al modello selezionato al momento della pubblicazione.

I prompt personalizzati non ricevono automaticamente gli aggiornamenti del modello. È necessario aggiornare manualmente il modello, pubblicare una nuova versione del prompt e aggiornare l'agente AI.

Se hai ignorato solo alcuni tipi di prompt

Alcuni tipi di agenti AI supportano più tipi di prompt. Ad esempio, un agente AI di Answer Recommendation supporta tre tipi di prompt: generazione di etichettatura degli intenti, riformulazione delle query e generazione di risposte. Se ne imposti solo alcuni su prompt personalizzati e lasci il resto non impostato, si applica quanto segue:

  • I tipi di prompt impostati in modo esplicito (tramite il sito Web di amministrazione o la CLI) vengono aggiunti alla versione specifica del prompt scelta. Non cambiano a meno che non li aggiorni. Segui i passaggi di aggiornamento seguenti per ogni richiesta personalizzata.

  • I tipi di prompt che non hai impostato non vengono memorizzati nella configurazione dell'agente AI. In fase di esecuzione, Amazon Connect li risolve dalle impostazioni predefinite di sistema correnti. Questi tipi utilizzano sempre le versioni più recenti del prompt di sistema, inclusi eventuali aggiornamenti del modello. Non è richiesta alcuna azione per annullare l'impostazione dei tipi di prompt.

Effettua l'aggiornamento utilizzando il sito Web di amministrazione

Fase 1: Creare una nuova versione richiesta con il modello aggiornato

  1. Accedi al sito Web di amministrazione di Amazon Connect.

  2. Nel menu di navigazione, scegli AI agent designer, AI prompt.

  3. Dall'elenco dei prompt, seleziona il prompt AI personalizzato che desideri aggiornare.

  4. Scegli Modifica in AI Prompt Builder (in alto a destra).

  5. Il menu a discesa in alto a destra mostra Ultimo: Bozza. Questa è la copia di lavoro che modificherai.

  6. Nella sezione Modelli, utilizza il menu a discesa per selezionare il nuovo modello.

  7. Seleziona Pubblica. Questo crea una nuova versione del prompt con il nuovo modello.

  8. Scorri verso il basso fino alla sezione Versioni nella stessa pagina. Puoi confermare che la nuova versione è stata creata.

  9. Per verificare la nuova versione, torna a AI Agent Designer, AI prompt. Seleziona la richiesta dall'elenco, quindi utilizza il menu a discesa della versione (in alto a destra) per selezionare la nuova versione. La sezione Panoramica mostra l'ID del modello aggiornato.

Fase 2: Aggiorna l'agente AI per utilizzare la nuova versione del prompt

  1. Passa a AI agent designer, AI agent.

  2. Scegli l'agente AI personalizzato che fa riferimento a questo prompt.

  3. Scegli Modifica in AI Agent Builder per aprire la pagina Agent Builder.

  4. Scegli Aggiungi richiesta. Viene visualizzato un popup con i prompt disponibili.

  5. Seleziona la nuova versione del prompt, quindi scegli Aggiungi. Il popup si chiude e il prompt viene aggiunto all'agente.

  6. Seleziona Pubblica. Questo crea una nuova versione dell'agente AI utilizzando il prompt personalizzato con il modello aggiornato.

  7. Scorri verso il basso fino alla sezione Versioni per confermare che venga visualizzata la nuova versione dell'agente AI.

  8. Facoltativamente, seleziona la versione più recente dal menu a discesa in alto a destra. La sezione Richieste mostra la nuova versione del prompt.

Passaggio 3: imposta la nuova versione dell'agente AI come predefinita

  1. Passa a AI agent designer, AI agent.

  2. Nella sezione Configurazioni predefinite dell'agente AI, trova il caso d'uso che utilizza l'agente AI personalizzato e aggiornalo alla nuova versione.

  3. Scegli l'icona del segno di spunta (✓) per salvare.

  4. Per evitare di aggiornare manualmente la versione ogni volta, seleziona Più recente dal menu a discesa della versione. Questo utilizza automaticamente la versione pubblicata più di recente dell'agente AI.

Esegui l'upgrade tramite l'interfaccia a riga di comando di AWS

Aggiorna il prompt AI con il nuovo modello:

aws qconnect update-ai-prompt \
  --assistant-id assistant-id \
  --ai-prompt-id custom-prompt-id \
  --model-id new-model-id

Pubblica una nuova versione del prompt:

aws qconnect create-ai-prompt-version \
  --assistant-id assistant-id \
  --ai-prompt-id custom-prompt-id

Aggiorna l'agente AI in modo che faccia riferimento alla nuova versione del prompt:

aws qconnect update-ai-agent \
  --assistant-id assistant-id \
  --ai-agent-id custom-agent-id \
  --configuration '{
    "agentTypeConfiguration": {
      "promptTypeAIPromptId": "custom-prompt-id:new-version-number"
    }
  }'

Pubblica una nuova versione dell'agente AI:

aws qconnect create-ai-agent-version \
  --assistant-id assistant-id \
  --ai-agent-id custom-agent-id

Imposta la nuova versione dell'agente AI come predefinita:

aws qconnect update-assistant-ai-agent \
  --assistant-id assistant-id \
  --ai-agent-type AGENT_TYPE \
  --configuration '{
    "aiAgentId": "custom-agent-id:new-version-number"
  }'

Scenario 2: agente AI personalizzato senza modifiche ai prompt

In questo scenario, hai creato un agente AI personalizzato per personalizzare impostazioni come la configurazione locale o della knowledge base, ma non hai ignorato alcun tipo di prompt. Tutti i prompt vengono risolti dalle impostazioni predefinite del sistema.

Aggiornamenti automatici

Quando Amazon Connect pubblica nuove versioni di agente AI e prompt di sistema con modelli aggiornati, il tuo agente AI personalizzato rileva automaticamente le versioni più recenti del prompt di sistema. Nessuna operazione richiesta.

Questo perché i tipi di prompt non impostati vengono risolti in fase di esecuzione a partire dalle impostazioni predefinite di sistema correnti, che rimandano sempre alle versioni più recenti dei prompt di sistema.

Forza un modello specifico prima di aggiornare il sistema

Se desideri utilizzare un modello più recente prima che Amazon Connect lo distribuisca come impostazione predefinita di sistema:

  1. Crea un prompt AI personalizzato copiando il prompt di sistema che desideri aggiornare.

  2. Cambia il modello con il modello più recente desiderato.

  3. Pubblica il prompt personalizzato.

  4. Modifica il tuo agente AI personalizzato e aggiungi il prompt personalizzato al tipo desiderato.

  5. Pubblica l'agente AI.

Questo converte quel tipo di prompt in una configurazione dello Scenario 1.

Scenario 3: aggiornamento delle configurazioni predefinite dell'agente AI

La sezione Configurazioni predefinite degli agenti AI nella pagina di panoramica degli agenti AI controlla quale versione dell'agente AI è attiva per ogni caso d'uso (Answer Recommendation, Manual Search, Self Service, ecc.).

Quando viene creata un'istanza Amazon Connect, ogni caso d'uso viene configurato automaticamente con una versione specifica dell'agente AI del sistema. Queste versioni sono bloccate: non si aggiornano automaticamente quando Amazon Connect pubblica nuove versioni di agenti AI di sistema o quando pubblichi nuove versioni di agenti AI personalizzate. Devi selezionare manualmente la nuova versione.

Effettua l'aggiornamento utilizzando il sito Web di amministrazione

  1. Passa a AI agent designer, AI agent.

  2. Nella sezione Configurazioni predefinite degli agenti AI, trova il caso d'uso che desideri aggiornare (ad esempio, Answer Recommendation).

  3. Dal menu a discesa della versione, seleziona la nuova versione dell'agente AI.

  4. Scegli Save (Salva).

  5. Per evitare di aggiornare manualmente la versione ogni volta, seleziona Più recente dal menu a discesa della versione. Questo utilizza automaticamente la versione pubblicata più di recente dell'agente AI.

Esegui l'upgrade tramite l'interfaccia a riga di comando di AWS

aws qconnect update-assistant-ai-agent \
  --assistant-id assistant-id \
  --ai-agent-type AGENT_TYPE \
  --configuration '{
    "aiAgentId": "ai-agent-id:new-version-number"
  }'

Sostituisci AGENT_TYPE con il tipo di caso d'uso (ad esempioANSWER_RECOMMENDATION,MANUAL_SEARCH,SELF_SERVICE).

Riepilogo

# Scenario Auto-upgrades? Operazione richiesta
1 Agente AI personalizzato con istruzioni AI personalizzate Istruzioni personalizzate: no. Richieste non impostate: Sì Richiesta di modifica, modifica modello, richiesta di pubblicazione, agente di aggiornamento, agente di pubblicazione. Unset richiede l'aggiornamento automatico.
2 Agente AI personalizzato senza interruzioni dei prompt Sì Non è necessaria alcuna azione
3 Aggiornamento delle configurazioni predefinite degli agenti AI Casi d'uso non impostati: Sì. Impostato esplicitamente: No Versioni bloccate in modo esplicito: seleziona una nuova versione e salva

Considerazioni importanti

  • Test: prova gli aggiornamenti del modello in un ambiente non di produzione prima di implementare le modifiche su larga scala. Utilizza l'update-sessionAPI per impostare le versioni degli agenti AI per sessioni specifiche.

  • Infrastruttura come codice: se gestisci i prompt di intelligenza artificiale e gli agenti di intelligenza artificiale tramite CloudFormation o AWS CDK, aggiorna le proprietà delle risorse nel modello (ad esempio, ModelId onAWS::Wisdom::AIPrompt) e distribuisci lo stack. Il comportamento del tipo di prompt descritto in questo argomento si applica allo stesso modo: in fase di esecuzione, annulla i tipi di prompt in AWS::Wisdom::AIAgent Resolve dai valori predefiniti del sistema.

  • Disponibilità regionale: la disponibilità del modello varia in base alla regione AWS. Controlla la tabella dei modelli supportati prima di selezionare un modello. Per ulteriori informazioni, consulta Modelli supportati per i prompt system/custom.

  • Session-level sostituzioni: le versioni degli agenti AI impostate nelle sessioni hanno la precedenza sulle impostazioni predefinite a livello di assistente, che hanno la precedenza sulle impostazioni predefinite del sistema. Se imposti le versioni degli agenti AI a livello di sessione, devi aggiornare anche tali riferimenti.

  • Ripristino delle impostazioni predefinite di sistema: per ripristinare un caso d'uso all'agente AI di sistema utilizzando il sito Web di amministrazione, accedi a AI agent designer, AI Agents. Nella sezione Configurazioni predefinite dell'agente AI, trova il caso d'uso, seleziona l'agente AI di sistema dal menu a discesa dell'agente, scegli la versione desiderata o Più recente e scegli Salva. Utilizzando la CLI, esegui list-ai-agents --origin SYSTEM per trovare l'ID agente AI di sistema per il tipo di caso d'uso, quindi impostalo utilizzando. update-assistant-ai-agent