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à.
GetActionRecommendations
Restituisce un elenco di azioni consigliate ordinate in ordine decrescente in base al punteggio di previsione. Utilizza l'GetActionRecommendationsAPI se hai una campagna personalizzata che implementa una versione della soluzione addestrata con una ricetta PERSONALIZED_ACTIONS.
Per ulteriori informazioni sulle ricette PERSONALIZED_ACTIONS, consulta le ricette PERSONALIZED_ACTIONS. https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html Per ulteriori informazioni su come ottenere consigli sulle azioni, consulta Ottenere consigli sulle azioni. https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html
Sintassi della richiesta
POST /action-recommendations HTTP/1.1
Content-type: application/json
{
"campaignArn": "string",
"filterArn": "string",
"filterValues": {
"string" : "string"
},
"numResults": number,
"userId": "string"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- campaignArn
-
L'Amazon Resource Name (ARN) della campagna da utilizzare per ottenere consigli sulle azioni da intraprendere. Questa campagna deve implementare una versione della soluzione addestrata con una ricetta PERSONALIZED_ACTIONS.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: no
- filterArn
-
L'ARN del filtro da applicare ai consigli restituiti. Per ulteriori informazioni, consulta la pagina con le indicazioni per filtrare le raccomandazioni.
Quando usi questo parametro, assicurati che la risorsa del filtro sia
ACTIVE.Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: no
- filterValues
-
I valori da utilizzare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione del filtro, fornisci il nome del parametro (in maiuscole e minuscole) come chiave e i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.
Per le espressioni di filtro che utilizzano un
INCLUDEelemento per includere azioni, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano unEXCLUDEelemento per escludere azioni, puoi omettere ilfilter-values. In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.Per ulteriori informazioni, consulta Filtrare consigli e segmenti di utenti.
Tipo: mappatura stringa a stringa
Voci della mappa: numero massimo di 25 elementi.
Vincoli di lunghezza chiave: lunghezza massima di 50.
Modello di chiave:
[A-Za-z0-9_]+Vincoli di lunghezza del valore: lunghezza massima di 1000.
Obbligatorio: no
- numResults
-
Il numero di risultati da restituire. Il predefinito è 5. Il massimo è 100.
Tipo: numero intero
Intervallo valido: valore minimo di 0.
Obbligatorio: no
- userId
-
L'ID utente per il quale fornire consigli sulle azioni da intraprendere.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"actionList": [
{
"actionId": "string",
"score": number
}
],
"recommendationId": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- actionList
-
Un elenco di raccomandazioni sulle azioni ordinate in ordine decrescente in base al punteggio di previsione. L'elenco può contenere un massimo di 100 azioni. Per informazioni sui punteggi delle azioni, vedi Come funziona il punteggio delle azioni consigliate.
Tipo: matrice di oggetti PredictedAction
- recommendationId
-
L'ID della raccomandazione.
Tipo: stringa
Errori
- InvalidInputException
-
Fornisci un valore valido per il campo o il parametro.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
La risorsa specificata non esiste.
Codice di stato HTTP: 404
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
