Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Bereitstellen einer Amazon Personalize Personalize-Lösungsversion mit einer Kampagne

Wenn Sie Empfehlungen in Echtzeit mit benutzerdefinierten Ressourcen erhalten möchtenManuelles Erstellen einer Lösungsversion, können Sie nach Abschluss des Vorgangs Ihre Lösungsversion mit einer Kampagne bereitstellen.

Bei einer Kampagne wird eine Lösungsversion (trainiertes Modell) mit einer bereitgestellten Transaktionskapazität zur Generierung von Empfehlungen in Echtzeit bereitgestellt. Nachdem Sie eine Kampagne erstellt haben, verwenden Sie die GetPersonalizedRanking API Operationen GetRecommendations oder, um Empfehlungen zu erhalten. Wenn Sie mehrere Artikelempfehlungen oder Benutzersegmente erhalten, müssen Sie keine Kampagne erstellen. Weitere Informationen finden Sie unter Empfehlungen für Batch-Artikel abrufen oder Benutzersegmente im Batch-Modus abrufen.

Wenn Sie eine Kampagne erstellen, können Sie Folgendes konfigurieren:

Sie können eine Kampagne mit der Amazon Personalize Personalize-Konsole, AWS Command Line Interface (AWS CLI) oder AWS SDKs erstellen. Wenn Sie die Einstellungen einer bestehenden Kampagne ändern möchten, z. B. die Aktivierung von Metadaten in Empfehlungen, müssen Sie Ihre Kampagne aktualisieren. Weitere Informationen finden Sie unter Konfiguration einer Amazon Personalize Personalize-Kampagne aktualisieren.

Während die Kampagne aktiv ist, fallen für Sie Kampagnenkosten an. Um unnötige Kosten zu vermeiden, stellen Sie sicher, dass Sie die Kampagne löschen, wenn Sie fertig sind. Informationen zu den Kampagnenkosten finden Sie unter Amazon Personalize Personalize-Preise.

Automatische Kampagnen-Updates

Wenn Sie eine Kampagne erstellen, können Sie automatische Kampagnenaktualisierungen aktivieren. Bei automatischen Updates wird die Kampagne automatisch aktualisiert, sodass die neueste automatisch oder manuell trainierte Lösungsversion Ihrer Lösung bereitgestellt wird. Dies erleichtert es Ihnen, Ihre Kampagne auf dem neuesten Stand zu halten.

Wenn Ihre Lösung beispielsweise automatische Schulungen verwendet, um alle sieben Tage eine neue Lösungsversion zu erstellen, wird Ihre Kampagne automatisch aktualisiert, sodass für jede wöchentliche Schulung die neueste Lösungsversion verwendet wird. Wenn Sie keine automatischen Kampagnen-Updates verwenden, müssen Sie die Kampagne manuell aktualisieren, um das neueste trainierte Modell bereitzustellen.

Minimale Anzahl bereitgestellter Transaktionen pro Sekunde und auto-scaling

Wenn Sie eine Amazon Personalize Personalize-Kampagne erstellen, können Sie die Mindestanzahl an bereitgestellten Transaktionen pro Sekunde (minProvisionedTPS) für die Kampagne angeben. Dies ist der grundlegende Transaktionsdurchsatz für die von Amazon Personalize bereitgestellte Kampagne. Es legt die Mindestabrechnungsgebühr für die Kampagne fest, solange sie aktiv ist. Eine Transaktion ist eine einzelne GetRecommendations oder eine GetPersonalizedRanking Anfrage. Die Standardeinstellung minProvisionedTPS ist 1.

Wenn Ihre TPS Erhöhung über den Wert hinausgehtminProvisionedTPS, skaliert Amazon Personalize die bereitgestellte Kapazität automatisch nach oben und unten, aber niemals nach unten. minProvisionedTPS Bei der Erhöhung der Kapazität kommt es zu einer kurzen Zeitverzögerung, die zum Verlust von Transaktionen führen kann. Wenn Ihr Traffic abnimmt, kehrt die Kapazität auf die zurückminProvisionedTPS.

Ihnen wird der bereitgestellte Mindestbetrag TPS oder, falls Ihre Anfragen diesen Wert überschreitenminProvisionedTPS, der tatsächliche TPS Betrag in Rechnung gestellt. Der tatsächliche Wert TPS ist die Gesamtzahl der von Ihnen gestellten Empfehlungsanfragen. Wir empfehlen, mit einem niedrigen Wert zu beginnenminProvisionedTPS, Ihre Nutzung anhand von CloudWatch Amazon-Metriken zu verfolgen und den Wert dann bei minProvisionedTPS Bedarf zu erhöhen.

Weitere Informationen zu den Kampagnenkosten finden Sie unter Amazon Personalize Personalize-Preise.

Artikelmetadaten in Empfehlungen

Wenn Sie Empfehlungen erhalten, können Sie Amazon Personalize veranlassen, Artikelmetadaten in die Empfehlungsergebnisse aufzunehmen. In Ihrer Anfrage können Sie die Spalten aus Ihrem Artikeldatensatz auswählen, die aufgenommen werden sollen. Amazon Personalize gibt diese Daten für jeden Artikel in der Empfehlungsantwort zurück.

Sie können Metadaten verwenden, um Empfehlungen in Ihrer Benutzeroberfläche zu erweitern, z. B. um Genres für Filme zu Karussells hinzuzufügen. Oder Sie können sie verwenden, um die Qualität der Empfehlungen visuell zu beurteilen. Wenn Sie generative KI in Ihrer App verwenden, können Sie die Metadaten in KI-Eingabeaufforderungen einfügen, um relevantere Inhalte zu generieren. Weitere Informationen zur Verwendung von Amazon Personalize mit generativer KI finden Sie unterAmazon Personalize und generative KI.

Metadaten aktivieren

Um Metadaten zu Empfehlungen hinzufügen zu können, benötigen Sie einen Artikel-Datensatz mit einer Spalte mit Metadaten. Sie müssen die Metadaten nicht im Training verwenden. Hinweise zum Erstellen eines Datensatzes finden Sie unterErstellen eines Schemas und eines Datensatzes. Informationen zum Aktualisieren von Daten finden Sie unterAktualisierung von Daten in Datensätzen nach dem Training.

Wenn Sie das Rezept User-Personalization-v 2 oder Personalized-Ranking-v 2 verwenden, haben neue Kampagnen automatisch die Möglichkeit, Artikelmetadaten in die Empfehlungsergebnisse einzubeziehen. Sie müssen Metadaten für Ihre Kampagne nicht manuell aktivieren. Für alle anderen Rezepte und Domain-Anwendungsfälle müssen Sie die Metadatenoption aktivieren:

Eine Kampagne erstellen (Konsole)

Sobald der Status Ihrer Lösungsversion Aktiv lautet, können Sie sie mit einer Amazon Personalize bereitstellen.

Eine Kampagne erstellen ()AWS CLI

Sobald Ihre Lösungsversion aktiv ist, können Sie sie mit einer Amazon Personalize bereitstellen. Um eine Kampagne mit dem zu erstellen AWS CLI, verwenden Sie den create-campaign Befehl.

Das folgende Codebeispiel zeigt Ihnen, wie Sie eine Kampagne erstellen. Es stellt die neueste Lösungsversion einer Lösung bereit, die das Rezept für Benutzerpersonalisierung verwendet. Die Kampagne, die es erstellt, wird automatisch aktualisiert, um future Lösungsversionen zu verwenden. Der Code verwendet die folgende Konfiguration:

Eine vollständige Liste aller Parameter finden Sie unterCreateCampaign.

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

Die Kampagne ist bereit, wenn ihr Status lautetACTIVE. Um den aktuellen Status zu erhalten, rufen Sie DescribeCampaign auf und überprüfen Sie, ob das Feld status auf ACTIVE eingestellt ist.

Wenn Sie Ihre Lösungsversion neu trainieren und Ihre Kampagne nicht automatisch auf die neueste Lösungsversion aktualisiert wird, oder wenn Sie Ihre Kampagneneinstellungen ändern möchten, müssen Sie Ihre Kampagne aktualisieren. Weitere Informationen finden Sie unter Konfiguration einer Amazon Personalize Personalize-Kampagne aktualisieren.

Amazon Personalize bietet Ihnen Funktionen zur Verwaltung von Kampagnen, z. B. ListCampaigns zum Auflisten der von Ihnen erstellten Kampagnen. Sie können eine Kampagne durch Aufrufen von DeleteCampaign löschen. Wenn Sie eine Kampagne löschen, werden die Lösungsvarianten, die Teil der Kampagne sind, nicht gelöscht.

Nachdem Sie Ihre Kampagne erstellt haben, können Sie sie verwenden, um Empfehlungen abzugeben. Weitere Informationen finden Sie unter Empfehlungen von Amazon Personalize erhalten.

Eine Kampagne erstellen (AWS SDKs)

Sobald Ihre Lösungsversion aktiv ist, können Sie sie mit einer Amazon Personalize bereitstellen. Um eine Kampagne mit zu erstellen AWS SDKs, verwenden Sie den CreateCampaign API Vorgang.

Das folgende Codebeispiel zeigt Ihnen, wie Sie eine Kampagne erstellen. Der Code stellt die neueste Lösungsversion einer Lösung bereit, die das Rezept für Benutzerpersonalisierung verwendet. Die Kampagne, die es erstellt, wird automatisch aktualisiert, um future Lösungsversionen zu verwenden. Der Code verwendet die folgende Konfiguration:

Eine vollständige Liste aller Parameter finden Sie unterCreateCampaign.

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();

Die Kampagne ist bereit, wenn ihr Status lautetACTIVE. Um den aktuellen Status zu erfahren, rufen Sie an DescribeCampaign und überprüfen Sie, ob das status Feld aktiviert istACTIVE.

Wenn Sie Ihre Lösungsversion manuell neu trainieren oder Ihre Kampagneneinstellungen ändern möchten, müssen Sie Ihre Kampagne aktualisieren. Weitere Informationen finden Sie unter Konfiguration einer Amazon Personalize Personalize-Kampagne aktualisieren.

Amazon Personalize bietet Ihnen Funktionen zur Verwaltung von Kampagnen, z. B. ListCampaigns zum Auflisten der von Ihnen erstellten Kampagnen. Sie können eine Kampagne durch Aufrufen von DeleteCampaign löschen. Wenn Sie eine Kampagne löschen, werden die Lösungsvarianten, die Teil der Kampagne sind, nicht gelöscht.

Nachdem Sie Ihre Kampagne erstellt haben, können Sie damit Empfehlungen abgeben. Weitere Informationen finden Sie unter Empfehlungen von Amazon Personalize erhalten.