As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
GetActionRecommendations
Exibe uma lista de ações recomendadas em ordem decrescente por pontuação de previsão. Use a API GetActionRecommendations se você tiver uma campanha personalizada que implante uma versão da solução treinada com uma fórmula PERSONALIZED_ACTIONS.
Para obter mais informações sobre fórmulas PERSONALIZED_ACTIONS, consulte PERSONALIZED_ACTIONS recipes. Para obter mais informações sobre como obter recomendações de ações, consulte Obter recomendações de ações.
Sintaxe da Solicitação
POST /action-recommendations HTTP/1.1
Content-type: application/json
{
"campaignArn": "string",
"filterArn": "string",
"filterValues": {
"string" : "string"
},
"numResults": number,
"userId": "string"
}Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- campaignArn
-
O nome do recurso da Amazon (ARN) da campanha a ser usada para obter recomendações de ações. Essa campanha deve implantar uma versão da solução treinada com uma fórmula PERSONALIZED_ACTIONS.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Obrigatório: não
- filterArn
-
O ARN do filtro a ser aplicado às recomendações retornadas. Para obter mais informações, consulte Filtrar recomendações.
Ao usar esse parâmetro, verifique se o recurso de filtro é
ACTIVE.Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Obrigatório: não
- filterValues
-
Os valores a serem usados ao filtrar as recomendações. Para cada parâmetro de espaço reservado em sua expressão de filtro, forneça o nome do parâmetro (em maiúsculas e minúsculas) como uma chave e os valores do filtro como o valor correspondente. Separe vários valores para um parâmetro com uma vírgula.
Para expressões de filtros que usem um elemento
INCLUDEpara incluir ações, é necessário fornecer valores para todos os parâmetros definidos na expressão. Para filtros com expressões que usem um elementoEXCLUDEpara excluir ações, é possível omitir osfilter-values. Nesse caso, o Amazon Personalize não usa essa parte da expressão para filtrar recomendações.Para obter mais informações, consulte Filtrar recomendações e segmentos de usuários.
Tipo: mapa de string para string
Entradas do mapa: número máximo de 25 itens.
Restrições de tamanhos de chave: tamanho máximo de 50.
Padrão da chave:
[A-Za-z0-9_]+Restrições de tamanho de valor: tamanho máximo de 1.000.
Obrigatório: não
- numResults
-
o número máximo de resultados a serem retornados. O padrão é 5. O máximo é cem.
Tipo: inteiro
Intervalo válido: valor mínimo de 0.
Obrigatório: não
- userId
-
O ID do usuário para o qual fornecer recomendações de ações.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Obrigatório: Não
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"actionList": [
{
"actionId": "string",
"score": number
}
],
"recommendationId": "string"
}Elementos de Resposta
Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- actionList
-
Uma lista de recomendações de ações em ordem decrescente por pontuação de previsão. Pode haver, no máximo, cem ações na lista. Para obter informações sobre pontuações de ações, consulte How action recommendation scoring works.
Tipo: matriz de objetos PredictedAction
- recommendationId
-
O ID da recomendação.
Tipo: string
Erros
- InvalidInputException
-
Forneça um valor válido para o campo ou parâmetro.
Código de Status HTTP: 400
- ResourceNotFoundException
-
O recurso especificado não existe.
Código de Status HTTP: 404
Consulte Também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte:
