Você está visualizando a documentação do Apigee Edge.
  Acesse a
      documentação da
      Apigee X. info
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.
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. |