Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
Versão 2.0.0
Solicite previsões do Cloud Machine Learning Engine. Com a ação predict
, é possível solicitar e exibir previsões de um modelo treinado.
Depois de configurar essa extensão com o ID do projeto e as credenciais do Google Cloud, faça chamadas de um proxy de API usando a política ExtensionCallout. Na configuração da política, você especifica o modelo e a versão do modelo a serem usados, além dos dados de instância que o modelo vai usar para fazer a previsão.
Para começar a usar o Cloud ML Engine, consulte Introdução ao Cloud ML Engine.
Pré-requisitos
Este conteúdo oferece uma referência para configurar e usar essa extensão. Antes de usar a extensão de um proxy de API com a política ExtensionCallout, você precisa:
Verifique se você tem um modelo.
Para saber mais sobre os modelos do Cloud ML Engine e outros conceitos, consulte Projetos, modelos, versões e jobs.
Use o Console do GCP para gerar uma chave para a conta de serviço.
Use o conteúdo do arquivo JSON de chave resultante ao adicionar e configurar a extensão usando a referência de configuração.
Sobre o Google Cloud Machine Learning Engine
É possível usar o Cloud Machine Learning Engine para treinar modelos de aprendizado de máquina usando os recursos do Google Cloud Platform. É possível hospedar os modelos treinados no Cloud ML Engine para enviar solicitações de previsão e gerenciar seus modelos e jobs usando os serviços do GCP.
Ações
predict
Faça previsões nos dados de instância especificados usando o modelo especificado.
Sintaxe
<Action>predict</Action>
<Input><![CDATA[{
"model" : model-for-prediction,
"version" : model-version,
"instances" : data-to-use-for-making-prediction
}]]></Input>
Exemplo
<Action>predict</Action>
<Input><![CDATA[{
"model" : mymodel,
"version" : version4,
"instances" : {"instances": ["the quick brown fox", "la bruja le dio"]}
}]]></Input>
Parâmetros de solicitação
Parâmetro | Descrição | Tipo | Padrão | Obrigatório |
---|---|---|---|---|
modelo | O modelo a ser usado para previsões. | String | Nenhum. | Sim. |
version | A versão de uma solução de ML a ser usada para previsões. | String | Nenhum. | Sim. |
instâncias | As instâncias para receber previsões. A forma dos itens nesse valor depende das expectativas do modelo que você está usando para prever. Para mais informações, consulte Detalhes da solicitação de previsão. | Matriz | Nenhum. | Sim. |
Resposta
Uma matriz predictions
que inclui dados de previsão retornados pelo modelo especificado na configuração da política ExtensionCallout.
{
"predictions": [
{
"probabilities": [
0.9435398578643799,
0.05646015331149101
],
"logits": [
-2.816103458404541
],
"classes": [
"0"
],
"class_ids": [
0
],
"logistic": [
0.056460149586200714
]
},
{
"probabilities": [
0.9271764755249023,
0.07282354682683945
],
"logits": [
-2.54410457611084
],
"classes": [
"0"
],
"class_ids": [
0
],
"logistic": [
0.07282353937625885
]
}
]
}
Referência de configuração
Use as informações a seguir ao configurar e implantar essa extensão para uso em proxies de API. Para saber como configurar uma extensão usando o console da Apigee, consulte Adicionar e configurar uma extensão.
Propriedades de extensão comuns
As propriedades a seguir estão presentes para cada extensão.
Propriedade | Descrição | Padrão | Obrigatório |
---|---|---|---|
name |
Nome que será dado a esta configuração da extensão. | Nenhum | Sim |
packageName |
Nome do pacote de extensão fornecido pelo Apigee Edge. | Nenhum | Sim |
version |
Número da versão do pacote de extensão a partir do qual você está configurando uma extensão. | Nenhum | Sim |
configuration |
Valor de configuração específico da extensão que você está adicionando. Consulte Propriedades para este pacote de extensão. | Nenhum | Sim |
Propriedades deste pacote de extensão
Especifique valores para as seguintes propriedades de configuração específicas desta extensão.
Propriedade | Descrição | Padrão | Obrigatório |
---|---|---|---|
projectId | ID do projeto do GCP que contém os modelos treinados usados por essa extensão. | Nenhum. | Sim. |
credenciais | Quando inserido no console da Apigee Edge, esse é o conteúdo do arquivo de chave da conta de serviço. Quando enviado pela API de gerenciamento, é um valor codificado em base64 gerado a partir do arquivo de chave da conta de serviço. | Nenhum. | Sim. |