Zintegruj klasyfikator języka naturalnego

Interfejs API NLClassifier biblioteki zadań klasyfikuje tekst wejściowy na różne kategorie i jest wszechstronnym i konfigurowalnym interfejsem API, który obsługuje większość modeli klasyfikacji tekstu.

Kluczowe cechy interfejsu API NLClassifier

  • Pobiera pojedynczy ciąg znaków jako dane wejściowe, dokonuje klasyfikacji na podstawie ciągu znaków i wyników pary jako wyniki klasyfikacji.

  • Opcjonalna tokenizacja Regex dostępna dla tekstu wejściowego.

  • Możliwość konfiguracji w celu dostosowania różnych modeli klasyfikacji.

Obsługiwane modele NLClassifier

Gwarantujemy kompatybilność następujących modeli z interfejsem API NLClassifier .

Uruchom wnioskowanie w Javie

Zobacz aplikację referencyjną do klasyfikacji tekstu , aby zapoznać się z przykładem użycia NLClassifier w aplikacji na Androida.

Krok 1: Zaimportuj zależność Gradle i inne ustawienia

Skopiuj plik modelu .tflite do katalogu zasobów modułu Android, w którym model będzie uruchamiany. Określ, że plik nie powinien być kompresowany i dodaj bibliotekę TensorFlow Lite do pliku build.gradle modułu:

android {
    // Other settings

    // Specify tflite file should not be compressed for the app apk
    aaptOptions {
        noCompress "tflite"
    }

}

dependencies {
    // Other dependencies

    // Import the Task Vision Library dependency (NNAPI is included)
    implementation 'org.tensorflow:tensorflow-lite-task-text:0.4.4'
    // Import the GPU delegate plugin Library for GPU inference
    implementation 'org.tensorflow:tensorflow-lite-gpu-delegate-plugin:0.4.4'
}

Krok 2: Uruchom wnioskowanie za pomocą interfejsu API

// Initialization, use NLClassifierOptions to configure input and output tensors
NLClassifierOptions options =
    NLClassifierOptions.builder()
        .setBaseOptions(BaseOptions.builder().useGpu().build())
        .setInputTensorName(INPUT_TENSOR_NAME)
        .setOutputScoreTensorName(OUTPUT_SCORE_TENSOR_NAME)
        .build();
NLClassifier classifier =
    NLClassifier.createFromFileAndOptions(context, modelFile, options);

// Run inference
List<Category> results = classifier.classify(input);

Zobacz kod źródłowy , aby uzyskać więcej opcji konfiguracji NLClassifier .

Uruchom wnioskowanie w Swift

Krok 1: Zaimportuj CocoaPods

Dodaj pod TensorFlowLiteTaskText w Podfile

target 'MySwiftAppWithTaskAPI' do
  use_frameworks!
  pod 'TensorFlowLiteTaskText', '~> 0.4.4'
end

Krok 2: Uruchom wnioskowanie za pomocą interfejsu API

// Initialization
var modelOptions:TFLNLClassifierOptions = TFLNLClassifierOptions()
modelOptions.inputTensorName = inputTensorName
modelOptions.outputScoreTensorName = outputScoreTensorName
let nlClassifier = TFLNLClassifier.nlClassifier(
      modelPath: modelPath,
      options: modelOptions)

// Run inference
let categories = nlClassifier.classify(text: input)

Więcej szczegółów znajdziesz w kodzie źródłowym .

Uruchom wnioskowanie w C++

// Initialization
NLClassifierOptions options;
options.mutable_base_options()->mutable_model_file()->set_file_name(model_path);
std::unique_ptr<NLClassifier> classifier = NLClassifier::CreateFromOptions(options).value();

// Run inference with your input, `input_text`.
std::vector<core::Category> categories = classifier->Classify(input_text);

Więcej szczegółów znajdziesz w kodzie źródłowym .

Uruchom wnioskowanie w Pythonie

Krok 1: Zainstaluj pakiet pip

pip install tflite-support

Krok 2: Korzystanie z modelu

# Imports
from tflite_support.task import text

# Initialization
classifier = text.NLClassifier.create_from_file(model_path)

# Run inference
text_classification_result = classifier.classify(text)

Zobacz kod źródłowy , aby uzyskać więcej opcji konfiguracji NLClassifier .

Przykładowe wyniki

Oto przykład wyników klasyfikacji modelu recenzji filmowej .

Wpis: „Co za strata mojego czasu”.

Wyjście:

category[0]: 'Negative' : '0.81313'
category[1]: 'Positive' : '0.18687'

Wypróbuj proste narzędzie demonstracyjne CLI dla NLClassifier z własnym modelem i danymi testowymi.

Wymagania dotyczące kompatybilności modelu

W zależności od przypadku użycia interfejs API NLClassifier może załadować model TFLite z metadanymi modelu TFLite lub bez nich. Zobacz przykłady tworzenia metadanych dla klasyfikatorów języka naturalnego przy użyciu interfejsu API narzędzia do zapisywania metadanych TensorFlow Lite .

Kompatybilne modele powinny spełniać następujące wymagania:

  • Tensor wejściowy: (kTfLiteString/kTfLiteInt32)

    • Dane wejściowe modelu powinny być albo surowym ciągiem wejściowym tensora kTfLiteString, albo tensorem kTfLiteInt32 dla indeksów surowego ciągu wejściowego z tokenami wyrażeń regularnych.
    • Jeśli typem danych wejściowych jest kTfLiteString, dla modelu nie są wymagane żadne metadane .
    • Jeśli typem danych wejściowych jest kTfLiteInt32, w metadanych tensora wejściowego należy skonfigurować RegexTokenizer .
  • Tensor wyniku wyjściowego: (kTfLiteUInt8/kTfLiteInt8/kTfLiteInt16/kTfLiteFloat32/kTfLiteFloat64)

    • Obowiązkowy tensor wyjściowy dla wyniku każdej sklasyfikowanej kategorii.

    • Jeśli typ jest jednym z typów Int, zdekwantyzuj go, aby podwoić/przemieścić się na odpowiednie platformy

    • Może mieć opcjonalny powiązany plik w metadanych odpowiadających tensorowi wyjściowemu dla etykiet kategorii, plik powinien być zwykłym plikiem tekstowym z jedną etykietą w wierszu, a liczba etykiet powinna odpowiadać liczbie kategorii podanych w wynikach modelu. Zobacz przykładowy plik etykiety .

  • Tensor etykiety wyjściowej: (kTfLiteString/kTfLiteInt32)

    • Opcjonalny tensor wyjściowy dla etykiety dla każdej kategorii powinien mieć tę samą długość, co tensor wyniku wyjściowego. Jeśli tensor nie jest obecny, interfejs API używa indeksów punktacji jako nazw klas.

    • Zostanie zignorowany, jeśli powiązany plik etykiety znajduje się w metadanych tensora wyniku wyjściowego.