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 1.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 do Google Cloud e as credenciais, 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 a serem usados, bem como os dados da instância que você quer que o modelo use para prever.

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 usando a política ExtensionCallout, você precisa:

  1. Ter um modelo.

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

  2. Usar o console do GCP para gerar uma chave para a conta de serviço.

  3. Usar 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 machine learning usando os recursos do Google Cloud Platform. Você pode hospedar seus 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

Realize 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 conferir as etapas de configuração de uma extensão usando o console da 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 GCP que contém modelos treinados usados por essa extensão. Nenhum. Sim.
credenciais Quando inserido no console do Apigee Edge, esse é o conteúdo do arquivo de chave da conta de serviço . Quando enviado pela API Management, é um valor codificado em Base64 gerado no arquivo de chave da conta de serviço. Nenhum. Sim.