Extensão do Google Machine Learning Engine

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:

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

  2. Use o Console do GCP para gerar uma chave para a conta de serviço.

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