Korzystanie z interfejsów API ONNX w usłudze Windows ML

Usługa Windows Machine Learning (ML) zawiera udostępnioną kopię środowiska uruchomieniowego ONNX, w tym jego interfejsy API. Oznacza to, że podczas instalowania uczenia maszynowego systemu Windows za pośrednictwem zestawu SDK aplikacji systemu Windows aplikacja będzie miała dostęp do pełnej powierzchni interfejsu API ONNX.

Aby sprawdzić, jaka wersja środowiska uruchomieniowego ONNX jest uwzględniona w określonych wersjach uczenia maszynowego systemu Windows, zobacz wersje środowiska uruchomieniowego ONNX dostarczane w usłudze Windows ML.

Na tej stronie opisano sposób używania interfejsów API ONNX zawartych w usłudze Windows ML.

Wymagania wstępne

• Wykonaj wszystkie kroki opisane w temacie Wprowadzenie do uczenia maszynowego z systemem Windows.

Przestrzenie nazw/nagłówki

Przestrzenie nazw/nagłówki interfejsów API ONNX w usłudze Windows ML są następujące:

C#

W języku C# przestrzenie nazw interfejsów API ONNX są takie same jak w przypadku bezpośredniego używania środowiska uruchomieniowego ONNX.

using Microsoft.ML.OnnxRuntime;

C++

W języku C++nagłówki środowiska uruchomieniowego ONNX są zawarte w winml/ katalogu, aby uniknąć konfliktów z innymi wersjami środowiska uruchomieniowego ONNX.

#include <winml/onnxruntime_cxx_api.h>

Jeśli masz istniejący kod, który używa nagłówków ONNX i nie chcesz aktualizować swoich dołączeń, możesz nakazać WinML udostępnić nagłówki bez prefiksu winml/, ustawiając właściwość WinMLEnableDefaultOrtHeaderIncludePath w projekcie.

<PropertyGroup>
  <WinMLEnableDefaultOrtHeaderIncludePath>true</WinMLEnableDefaultOrtHeaderIncludePath>
</PropertyGroup>

Następnie nagłówki będą takie same jak autonomiczne środowisko uruchomieniowe ONNX:

#include <onnxruntime_cxx_api.h>

Uwaga / Notatka

W wersjach wstępnych przed GA systemu Windows ML nagłówki środowiska uruchomieniowego ONNX w języku C++ były poprzedzone prefiksem win_, a nie umieszczone w podkatalogu winml/, oraz właściwość WinMLEnableDefaultOrtHeaderIncludePath nie istniała.

Pyton

W języku Python nazwa modułu środowiska uruchomieniowego ONNX jest taka sama jak w przypadku bezpośredniego używania środowiska uruchomieniowego ONNX.

import onnxruntime as ort

API-e

Interfejsy API ONNX są takie same jak w przypadku bezpośredniego korzystania ze środowiska uruchomieniowego ONNX. Aby na przykład utworzyć sesję wnioskowania:

C#

// Create inference session using compiled model
using InferenceSession session = new(compiledModelPath, sessionOptions);

C++

// Create inference session using compiled model
Ort::Session session(env, compiledModelPath.c_str(), sessionOptions);

Pyton

# Create inference session using compiled model
session = ort.InferenceSession(output_model_path, sess_options=options)

Zalecamy przeczytanie dokumentacji środowiska uruchomieniowego ONNX , aby uzyskać więcej informacji na temat używania interfejsów API środowiska uruchomieniowego ONNX w usłudze Windows ML.

Zobacz także

• Wersje środowiska uruchomieniowego ONNX dostarczane w usłudze Windows ML
• Wybieranie dostawców wykonywania
• Uruchamianie modeli ONNX
• Dystrybuowanie aplikacji korzystającej z uczenia maszynowego systemu Windows