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

Implementazione di una versione della soluzione Amazon Personalize con una campagna

Per ricevere consigli in tempo reale con risorse personalizzate, una volta completata l'operazioneCreazione manuale di una versione della soluzione, sei pronto a distribuire la versione della soluzione con una campagna.

Una campagna implementa una versione della soluzione (modello addestrato) con una capacità di transazione predisposta per generare consigli in tempo reale. Dopo aver creato una campagna, utilizzi le GetPersonalizedRanking API operazioni GetRecommendations or per ottenere consigli. Se ricevi consigli su articoli in batch o segmenti di utenti, non è necessario creare una campagna. Per ulteriori informazioni, consulta Ricevere consigli sugli articoli in batch o Ottenere segmenti di utenti in batch.

Quando crei una campagna, puoi configurare quanto segue:

Puoi creare una campagna con la console Amazon Personalize, AWS Command Line Interface (AWS CLI) o. AWS SDKs Se desideri modificare le impostazioni di una campagna esistente, ad esempio abilitando i metadati nei consigli, devi aggiornare la campagna. Per ulteriori informazioni, consulta Aggiornamento della configurazione di una campagna Amazon Personalize.

I costi della campagna sono a tuo carico mentre la campagna è attiva. Per evitare costi inutili, assicurati di eliminare la campagna quando hai finito. Per informazioni sui costi delle campagne, consulta i prezzi di Amazon Personalize.

Aggiornamenti automatici delle campagne

Quando crei una campagna, puoi abilitare gli aggiornamenti automatici della campagna. Con gli aggiornamenti automatici, la campagna si aggiorna automaticamente per distribuire la versione più recente della soluzione, addestrata automaticamente o manualmente. In questo modo è più facile mantenere aggiornata la campagna.

Ad esempio, se la soluzione utilizza la formazione automatica per creare una nuova versione della soluzione ogni sette giorni, la campagna si aggiornerà automaticamente per utilizzare la versione più recente della soluzione per ogni formazione settimanale. Se non utilizzi gli aggiornamenti automatici della campagna, devi aggiornare manualmente la campagna per implementare il modello addestrato più recente.

Transazioni con provisioning minimo al secondo e auto-scaling

Quando crei una campagna Amazon Personalize, puoi specificare il numero minimo di transazioni assegnate al secondo (minProvisionedTPS) per la campagna. Questo è il throughput di transazione di base per la campagna fornita da Amazon Personalize. Imposta il costo minimo di fatturazione per la campagna mentre è attiva. Una transazione è una singola GetRecommendations GetPersonalizedRanking richiesta. L'impostazione predefinita minProvisionedTPS è 1.

Se i tuoi TPS aumenti superano il limiteminProvisionedTPS, Amazon Personalize ridimensiona automaticamente la capacità assegnata verso l'alto e verso il basso, ma mai al di sotto. minProvisionedTPS Si verifica un breve ritardo nell'aumento della capacità che potrebbe causare la perdita delle transazioni. Quando il traffico diminuisce, la capacità torna aminProvisionedTPS.

Ti viene addebitato il minimo fornito TPS o, se le tue richieste superano ilminProvisionedTPS, quello effettivoTPS. Il numero effettivo TPS è il numero totale di richieste di raccomandazione effettuate. Ti consigliamo di iniziare con un valore minimominProvisionedTPS, di monitorare l'utilizzo utilizzando i CloudWatch parametri di Amazon e quindi di aumentarlo minProvisionedTPS se necessario.

Per ulteriori informazioni sui costi delle campagne, consulta i prezzi di Amazon Personalize.

Metadati degli articoli nei consigli

Quando ricevi consigli, puoi fare in modo che Amazon Personalize includa i metadati degli articoli nei risultati dei consigli. Nella richiesta, puoi scegliere le colonne del set di dati Items da includere. Amazon Personalize restituisce questi dati per ogni articolo nella risposta alla raccomandazione.

Puoi utilizzare i metadati per arricchire i consigli nella tua interfaccia utente, ad esempio per aggiungere i generi dei film ai caroselli. Oppure puoi utilizzarli per valutare visivamente la qualità dei consigli. Se utilizzi l'intelligenza artificiale generativa nella tua app, puoi collegare i metadati ai prompt dell'intelligenza artificiale per generare contenuti più pertinenti. Per ulteriori informazioni sull'utilizzo di Amazon Personalize con l'intelligenza artificiale generativa, consulta. Amazon Personalize e AI generativa

Abilitazione dei metadati

Per aggiungere metadati ai consigli, devi disporre di un set di dati Items con una colonna di metadati. Non è necessario utilizzare i metadati durante la formazione. Per informazioni sulla creazione di un set di dati, consulta. Creazione di uno schema e di un set di dati Per informazioni sull'aggiornamento dei dati, vedereAggiornamento dei dati nei set di dati dopo l'allenamento.

Se utilizzi la ricetta User-Personalization-v 2 o Personalized-Ranking-v 2, le nuove campagne hanno automaticamente la possibilità di includere i metadati degli articoli nei risultati delle raccomandazioni. Non hai abilitato manualmente i metadati per la tua campagna. Per tutte le altre ricette e casi d'uso del dominio, devi abilitare l'opzione dei metadati:

Creazione di una campagna (console)

Una volta che lo stato della versione della soluzione è Attivo, sei pronto per distribuirla con una campagna Amazon Personalize.

Creazione di una campagna ()AWS CLI

Una volta che la versione della soluzione è attiva, sei pronto per distribuirla con una campagna Amazon Personalize. Per creare una campagna con AWS CLI, usa il create-campaign comando.

Il seguente esempio di codice mostra come creare una campagna. Implementa la versione più recente di una soluzione che utilizza la ricetta di personalizzazione degli utenti. La campagna che crea si aggiorna automaticamente per utilizzare le versioni future della soluzione. Il codice utilizza la seguente configurazione:

Per un elenco completo di tutti i parametri, consultaCreateCampaign.

aws personalize create-campaign \
--name campaign-name \
--solution-version-arn solution-arn/\$LATEST \
--min-provisioned-tps 1 \
--campaign-config "{"\"syncWithLatestSolutionVersion"\": "true", "\"enableMetadataWithRecommendations"\": "true"}"

La campagna è pronta quando il suo stato èACTIVE. Per ottenere lo stato corrente, chiamare l'operazione DescribeCampaign e verificare che il campo status sia ACTIVE.

Se riqualifichi la versione della soluzione e la campagna non si aggiorna automaticamente per utilizzare la versione più recente della soluzione o se desideri modificare le impostazioni della campagna, devi aggiornare la campagna. Per ulteriori informazioni, consulta Aggiornamento della configurazione di una campagna Amazon Personalize.

Amazon Personalize ti fornisce le operazioni per la gestione delle campagne, ad esempio ListCampaigns elencare le campagne che hai creato. È possibile eliminare una campagna chiamando l'operazione DeleteCampaign. Se si elimina una campagna, le versioni delle soluzioni che ne fanno parte non vengono eliminate.

Dopo aver creato la tua campagna, puoi usarla per formulare consigli. Per ulteriori informazioni, consulta Ricevere consigli da Amazon Personalize.

Creare una campagna (AWS SDKs)

Una volta che la versione della soluzione è attiva, sei pronto per distribuirla con una campagna Amazon Personalize. Per creare una campagna con AWS SDKs, usi l'CreateCampaignAPIoperazione.

Il seguente esempio di codice mostra come creare una campagna. Il codice implementa la versione più recente di una soluzione che utilizza la ricetta di personalizzazione degli utenti. La campagna che crea si aggiorna automaticamente per utilizzare le versioni future della soluzione. Il codice utilizza la seguente configurazione:

Per un elenco completo di tutti i parametri, consultaCreateCampaign.

SDK for Python (Boto3)

import boto3

personalize = boto3.client('personalize')

response = personalize.create_campaign(
    name = 'campaign name',
    solutionVersionArn = 'solution ARN/$LATEST',
    minProvisionedTPS = 1,
    campaignConfig = {"syncWithLatestSolutionVersion": True, "enableMetadataWithRecommendations": True}
)

arn = response['campaignArn']

description = personalize.describe_campaign(campaignArn = arn)['campaign']
print('Name: ' + description['name'])
print('ARN: ' + description['campaignArn'])
print('Status: ' + description['status'])

SDK for JavaScript v3

// Get service clients module and commands using ES6 syntax.
import { CreateCampaignCommand, PersonalizeClient } from
  "@aws-sdk/client-personalize";

// create personalizeClient
const personalizeClient = new PersonalizeClient({ region: "REGION" });

// set the campaign parameters
export const createCampaignParam = {
  solutionVersionArn: "SOLUTION_ARN/$LATEST" /* required */,
  name: "NAME" /* required */,
  minProvisionedTPS: 1 /* optional */,
  campaignConfig: {   /* optional */
    syncWithLatestSolutionVersion: true,
    enableMetadataWithRecommendations: true,
  },
};

export const run = async () => {
  try {
    const response = await personalizeClient.send(
      new CreateCampaignCommand(createCampaignParam)
    );
    console.log("Success", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

La campagna è pronta quando il suo stato èACTIVE. Per conoscere lo stato attualeDescribeCampaign, chiama e verifica che il status campo siaACTIVE.

Se riqualifichi manualmente la versione della soluzione o se desideri modificare le impostazioni della campagna, devi aggiornare la campagna. Per ulteriori informazioni, consulta Aggiornamento della configurazione di una campagna Amazon Personalize.

Amazon Personalize ti fornisce le operazioni per la gestione delle campagne, ad esempio ListCampaigns elencare le campagne che hai creato. È possibile eliminare una campagna chiamando l'operazione DeleteCampaign. Se si elimina una campagna, le versioni delle soluzioni che ne fanno parte non vengono eliminate.

Una volta creata la campagna, utilizzala per le raccomandazioni. Per ulteriori informazioni, consulta Ricevere consigli da Amazon Personalize.