Tiện ích công cụ học máy của Google

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X.
Thông tin

Phiên bản 2.0.0

Yêu cầu Cloud Machine Learning Engine dự đoán. Thông qua thao tác predict, bạn có thể yêu cầu và phân phát các dự đoán từ một mô hình đã được huấn luyện.

Sau khi định cấu hình tiện ích này bằng mã dự án và thông tin xác thực Google Cloud, bạn sẽ thực hiện các lệnh gọi từ một proxy API bằng cách sử dụng chính sách ExtensionCallout. Trong cấu hình chính sách, bạn chỉ định mô hình và phiên bản mô hình cần sử dụng, cũng như dữ liệu phiên bản mà bạn muốn mô hình sử dụng để dự đoán.

Để bắt đầu sử dụng Cloud ML Engine, hãy xem phần Giới thiệu về Cloud ML Engine.

Điều kiện tiên quyết

Nội dung này cung cấp thông tin tham khảo để định cấu hình và sử dụng tiện ích này. Trước khi sử dụng tiện ích từ một proxy API bằng chính sách ExtensionCallout, bạn phải:

  1. Đảm bảo rằng bạn có một mô hình.

    Để biết thêm về các mô hình Cloud ML Engine và các khái niệm khác, hãy xem bài viết Dự án, Mô hình, Phiên bản và Công việc.

  2. Sử dụng Google Cloud Console để tạo khoá cho tài khoản dịch vụ.

  3. Sử dụng nội dung của tệp JSON khoá thu được khi thêm và định cấu hình tiện ích bằng cách sử dụng tài liệu tham khảo về cấu hình.

Giới thiệu về Google Cloud Machine Learning Engine

Bạn có thể sử dụng Cloud Machine Learning Engine để huấn luyện các mô hình học máy bằng tài nguyên của Google Cloud. Bạn có thể lưu trữ các mô hình đã huấn luyện trên Cloud ML Engine để có thể gửi yêu cầu dự đoán và quản lý các mô hình cũng như công việc của mình bằng các dịch vụ của Google Cloud.

Thao tác

dự đoán

Thực hiện dự đoán trên dữ liệu thực thể được chỉ định bằng mô hình được chỉ định.

Cú pháp

<Action>predict</Action>
<Input><![CDATA[{
  "model" : model-for-prediction,
  "version" : model-version,
  "instances" : data-to-use-for-making-prediction
}]]></Input>

Ví dụ:

<Action>predict</Action>
<Input><![CDATA[{
  "model" : mymodel,
  "version" : version4,
  "instances" : {"instances": ["the quick brown fox", "la bruja le dio"]}
}]]></Input>

Tham số yêu cầu

Tham số Mô tả Loại Mặc định Bắt buộc
kiểu máy Mô hình dùng cho dự đoán. Chuỗi Không có. Có.
version Phiên bản của giải pháp học máy sẽ dùng để dự đoán. Chuỗi Không có. Có.
thực thể Các thực thể để nhận thông tin dự đoán. Hình dạng của các mục trong giá trị này sẽ phụ thuộc vào kỳ vọng của mô hình mà bạn đang sử dụng để dự đoán. Để biết thêm thông tin, hãy xem phần Chi tiết yêu cầu dự đoán. Mảng Không có. Có.

Phản hồi

Một mảng predictions bao gồm dữ liệu dự đoán do mô hình trả về được chỉ định trong cấu hình chính sách 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
      ]
    }
  ]
}

Tài liệu tham khảo về cấu hình

Hãy sử dụng những thông tin sau khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong các proxy API. Để biết các bước định cấu hình một tiện ích bằng bảng điều khiển Apigee, hãy xem phần Thêm và định cấu hình tiện ích.

Thuộc tính mở rộng chung

Các thuộc tính sau có sẵn cho mỗi tiện ích.

Tài sản Mô tả Mặc định Bắt buộc
name Tên mà bạn đang đặt cho cấu hình của tiện ích này. Không có
packageName Tên của gói tiện ích do Apigee Edge cung cấp. Không có
version Số phiên bản của gói tiện ích mà bạn đang định cấu hình tiện ích. Không có
configuration Giá trị cấu hình cụ thể cho tiện ích bạn đang thêm. Xem Thuộc tính cho gói tiện ích này Không có

Các thuộc tính cho gói tiện ích này

Chỉ định các giá trị cho các thuộc tính cấu hình sau đây dành riêng cho tiện ích này.

Thuộc tính Mô tả Mặc định Bắt buộc
projectId Mã nhận dạng của dự án trên Google Cloud có chứa các mô hình đã huấn luyện mà tiện ích này sử dụng. Không có. Có.
thông tin xác thực Khi được nhập vào bảng điều khiển Apigee Edge, đây là nội dung của tệp khoá tài khoản dịch vụ. Khi được gửi bằng API Quản lý, đây là giá trị được mã hoá base64 được tạo từ tệp khoá tài khoản dịch vụ. Không có. Có.