Extensão do Google Machine Learning Engine

Você está lendo 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 disponibilizar 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, especifique o modelo e a versão dele a serem usados, bem como os dados de instância que você quer que o modelo use para fazer previsões.

Para começar a usar o Cloud ML Engine, consulte Introdução ao Cloud ML Engine.

Pré-requisitos

Este conteúdo fornece 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:

  1. Verifique se você tem um modelo.

    Para saber mais sobre modelos do Cloud ML Engine e outros conceitos, consulte Projetos, modelos, versões e jobs.

  2. Use o console do Google Cloud para gerar uma chave para a conta de serviço.

  3. 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

É possível usar o Cloud Machine Learning Engine para treinar modelos de machine learning usando os recursos do Google Cloud. É 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 Google Cloud.

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. O formato 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 o seguinte ao configurar e implantar essa extensão para uso em proxies de API. Para saber como configurar uma extensão usando o console do Apigee, consulte Adicionar e configurar uma extensão.

Propriedades comuns de extensão

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 dessa extensão.

Propriedade Descrição Padrão Obrigatório
projectId ID do projeto do Google Cloud que contém os modelos treinados usados por esta extensão. Nenhum. Sim.
credenciais Quando inserido no console do Apigee Edge, esse é o conteúdo do seu arquivo de chave da conta de serviço. Quando enviado usando a API Management, é um valor codificado em base64 gerado do arquivo de chave da conta de serviço. Nenhum. Sim.