Extensão do Google Machine Learning Engine

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Versão 1.2.1

solicitar previsões do Cloud Machine Learning Engine; Por meio da ação predict, é possível solicitar e exibir previsões de um modelo treinado atual.

Depois de configurar essa extensão com o ID e as credenciais do seu projeto do Google Cloud, faça chamadas de um proxy de API usando a política Extension callout. Na configuração da política, você especifica o modelo e a versão a serem usados, bem 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 oferece 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 fazer o seguinte:

  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 GCP 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 com 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. 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

Realizar 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
model 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 sobre as quais você quer receber previsões. A forma dos itens nesse valor depende das expectativas do modelo que você usa 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 Extension callout.

{
  "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 código a seguir ao configurar e implantar a extensão para uso em proxies de API. Para saber como 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ão

Especifique valores para as propriedades de configuração a seguir 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, esse é o conteúdo do arquivo de chave da conta de serviço. Quando enviado pela API Management, ele é um valor codificado em base64 gerado no arquivo de chave da conta de serviço. Nenhum. Sim.