Extensão do Google Machine Learning Engine

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X.
informações

Versão 1.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 existente.

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 Extension callout. Na configuração da política, especifique o modelo e a versão do modelo a serem usados, assim 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 fornece 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:

  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 da chave resultante ao adicionar e configurar a extensão usando 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. Hospede modelos treinados no Cloud ML Engine para enviar solicitações de previsão e gerenciar modelos e jobs usando os serviços do GCP.

Ações

predict

Executa 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
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.
instances As instâncias para as quais você receberá previsões. A forma dos itens nesse valor dependerá das expectativas do modelo que você está usando 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 ExtensionChamada.

{
  "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 esta extensão para uso em proxies de API. Para ver as etapas para 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ões

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 esta extensão. Nenhum. Sim.
credenciais Quando inserido no console do Apigee Edge, este é 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.