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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Phiên bản 2.0.0

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

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 của Google Cloud, bạn sẽ thực hiện lệnh gọi từ một proxy API bằ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 thực thể 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 bài viết 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 GCP 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 tệp tham chiếu cấu hình.

Giới thiệu về công cụ học máy trên Google Cloud

Bạn có thể sử dụng Công cụ học máy trên đám mây để huấn luyện các mô hình học máy bằng tài nguyên của Google Cloud Platform. 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 các yêu cầu dự đoán cho các mô hình đó, đồng thời quản lý các mô hình và công việc bằng các dịch vụ của GCP.

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

Thông số Mô tả Loại Mặc định Bắt buộc
kiểu máy Mô hình dùng để 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 cho hoạt động dự đoán. Chuỗi Không có. Có.
thực thể Các thực thể cần 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 về yêu cầu dự đoán. Mảng Không có. Có.

Phản hồi

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 nội dung sau đây khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong proxy API. Để biết các bước định cấu hình 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.

Các thuộc tính mở rộng phổ biến

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ó

Thuộc tính cho gói tiện ích này

Chỉ định 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ã của dự án GCP 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 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 qua API quản lý, đây là một giá trị được mã hoá base64 được tạo từ tệp khoá tài khoản dịch vụ. Không có. Có.