Esta é a documentação do Apigee Edge.
Acesse
Documentação da Apigee X. informações
Versão 1.2.1
Solicite previsões do Cloud Machine Learning Engine. Com a ação predict
, é possível solicitar e exibir previsões de um modelo treinado existente.
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 Extension callout. Na configuração da política, especifique o modelo e a versão do modelo a serem usados, assim como os dados da instância que você quer que o modelo use para previsão.
Para começar a usar o Cloud ML Engine, consulte Introdução ao Cloud ML Engine.
Pré-requisitos
Este conteúdo fornece referência para configurar e usar essa extensão. Antes de usar a extensão de um proxy de API com a política Extension callout, 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 da chave resultante ao adicionar e configurar a extensão usando a referência de configuração.
Sobre o Google Cloud Machine Learning Engine
Você pode usar o Cloud Machine Learning Engine para treinar modelos de machine learning usando os recursos do Google Cloud Platform. Hospede modelos treinados no Cloud ML Engine para enviar solicitações de previsão e gerenciar modelos e jobs usando os serviços do GCP.
Ações
predict
Executa previsões nos dados da instância especificada 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. |
instances | As instâncias para as quais você receberá previsões. A forma dos itens nesse valor dependerá das expectativas do modelo que você está usando para prever. Para mais informações, consulte Prever detalhes da solicitação. | Matriz | Nenhum. | Sim. |
Resposta
Uma matriz predictions
que inclui dados de previsão retornados pelo modelo especificado na configuração da política ExtensionChamada.
{
"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 o seguinte ao configurar e implantar esta extensão para uso em proxies de API. Para ver as etapas para configurar uma extensão usando o console da Apigee, consulte Como 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ões
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 esta extensão. | Nenhum. | Sim. |
credenciais | Quando inserido no console do Apigee Edge, este é 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. |