View a markdown version of this page

GetActionRecommendations - Amazon Personalize
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

GetActionRecommendations

Gibt eine Liste der empfohlenen Aktionen zurück, sortiert in absteigender Reihenfolge nach dem Prognosewert. Verwenden Sie die GetActionRecommendations API, wenn Sie eine benutzerdefinierte Kampagne haben, die eine Lösungsversion bereitstellt, die mit einem PERSONALIZED_ACTIONS-Rezept trainiert wurde.

Weitere Informationen zu PERSONALIZED_ACTIONS-Rezepten finden Sie unter PERSONALIZED_ACTIONS-Rezepte. https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html Weitere Informationen zum Abrufen von Handlungsempfehlungen finden Sie unter Abrufen von Handlungsempfehlungen. https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html

Anforderungssyntax

POST /action-recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "numResults": number,
   "userId": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

campaignArn

Der Amazon-Ressourcenname (ARN) der Kampagne, die zum Abrufen von Handlungsempfehlungen verwendet werden soll. Diese Kampagne muss eine Lösungsversion bereitstellen, die mit einem PERSONALIZED_ACTIONS-Rezept trainiert wurde.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

Erforderlich: Nein

filterArn

Der ARN des Filters, der auf die zurückgegebenen Empfehlungen angewendet werden soll. Weitere Informationen finden Sie unter Filtern von Empfehlungen.

Wenn Sie diesen Parameter verwenden, stellen Sie sicher, dass die Filterressource ACTIVE

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

Erforderlich: Nein

filterValues

Die Werte, die beim Filtern von Empfehlungen verwendet werden sollen. Geben Sie für jeden Platzhalterparameter in Ihrem Filterausdruck den Parameternamen (in passender Groß- und Kleinschreibung) als Schlüssel und die Filterwerte als entsprechenden Wert an. Trennen Sie mehrere Werte für einen Parameter durch ein Komma.

Für Filterausdrücke, die ein INCLUDE Element verwenden, um Aktionen einzuschließen, müssen Sie Werte für alle Parameter angeben, die im Ausdruck definiert sind. Bei Filtern mit Ausdrücken, die ein EXCLUDE Element verwenden, um Aktionen auszuschließen, können Sie das filter-values weglassen. In diesem Fall verwendet Amazon Personalize diesen Teil des Ausdrucks nicht, um Empfehlungen zu filtern.

Weitere Informationen finden Sie unter Empfehlungen und Benutzersegmente https://docs.aws.amazon.com/personalize/latest/dg/filter.html filtern.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Karteneinträge: Maximale Anzahl von 25 Elementen.

Einschränkungen der Schlüssellänge: Die maximale Länge beträgt 50.

Schlüssel-Muster: [A-Za-z0-9_]+

Beschränkungen der Wertelänge: Die maximale Länge beträgt 1000.

Erforderlich: Nein

numResults

Die Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 5. Das Maximum ist 100.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 0.

Erforderlich: Nein

userId

Die Benutzer-ID des Benutzers, für den Handlungsempfehlungen abgegeben werden sollen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

actionList

Eine Liste von Handlungsempfehlungen, sortiert in absteigender Reihenfolge nach dem Prognosewert. Die Liste kann maximal 100 Aktionen enthalten. Informationen zur Bewertung von Aktionen finden Sie unter So funktioniert die Bewertung von Handlungsempfehlungen.

Typ: Array von PredictedAction-Objekten

recommendationId

Die ID der Empfehlung.

Typ: Zeichenfolge

Fehler

InvalidInputException

Geben Sie einen gültigen Wert für das Feld oder den Parameter an.

HTTP-Statuscode: 400

ResourceNotFoundException

Die angegebene Ressource ist nicht vorhanden.

HTTP-Statuscode: 404

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: