Język

Podejmuj decyzje za pomocą zadań Windows ML

Important

Zadanie decyzyjne jest eksperymentalne, nie jest obsługiwane w środowiskach produkcyjnych i wymaga Windows ML 2.9 Experimental lub nowszej wersji.

Zadanie decyzyjne ocenia stan, taki jak komunikat, bilet pomocy technicznej lub serializowany dokument, w odniesieniu do pytań określonych typem. Dla każdego pytania zwraca prawdopodobieństwo dla każdej opcji, wybranej opcji, pewności i zalecenia dotyczącego działania lub eskalacji. Decyzja jest pojedynczą oceną dla każdego pytania, więc zadanie nie generuje tekstu.

Zadanie decyzyjne przyjmuje opublikowany folder modelu decyzyjnego jako model, a Windows ML kompiluje model dla procesora GPU z zapleczem CGC. Na razie użyj Laya, zweryfikowanego modelu decyzyjnego w zalecanych modelach. Wymaga ona docelowego wykonania procesora GPU, a docelowy CPU zwraca wartość HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED). Aby uzyskać informacje o sposobie uruchamiania modeli przez zadania, zobacz Wybierz, jak zadanie uruchamia model.

Rodzaje pytań

Rodzaj Opcje
Wybór Co najmniej jeden. Każda z nich ma unikatową etykietę i opcjonalny opis.
Score Co najmniej jeden. Opcja i to poziom i, a jej opis określa kryterium dla tego poziomu.
Tak/Nie Brak, co oznacza użycie domyślnego opisu modelu dla obu odpowiedzi, lub dokładnie dwóch (false, a następnie true).

Pytanie może ustawić próg act w zakresie od 0 do 1. Zalecana jest odpowiedź ACT, gdy jej poziom pewności osiągnie próg, a ESCALATE w przeciwnym razie. Bez progu zalecenie jest ACT wtedy, gdy prawdopodobieństwo działania modelu wynosi co najmniej 0,5.

Zdecyduj

Załaduj folder modelu za pomocą polecenia LoadModelFromPath, utwórz Task za pomocą polecenia CreateDecisionTaskFromModel, utwórz sesję i wywołaj metodę Decide ze stanem i jego pytaniami. Tokenizator jest opcjonalny: za pomocą nullptr Task tworzy własny tokenizer modelu z folderu modelu.

// Temporary: WinMLRuntime and the other wrapper types in the WinMLSamples.Runtime
// namespaces aren't in the Windows ML package yet. Copy the wrapper files from
// https://github.com/microsoft/WindowsML/tree/main/Samples/Runtime/shared/csharp
// into your project. A future update will include the C# APIs natively.
using WinMLSamples.Runtime;
using WinMLSamples.Runtime.Tasks;

// Load the decision model and create the task on a GPU target.
using WinMLRuntime runtime = WinMLRuntime.Create();
using ExecutionTarget target = runtime.CreateExecutionTarget(
    ExecutionTargetKind.Gpu, ExecutionTargetPreference.Performance);
using Model model = runtime.LoadModelFromPath(modelFolder);
using WinMLTasks tasks = WinMLTasks.Create(runtime);
using DecisionTask task = tasks.Decision.CreateDecisionTaskFromModel(target, model);

// Describe a choice question and evaluate a state against it.
DecisionOption[] options =
[
    new("billing", "A question about an invoice or payment"),
    new("technical", "A problem using the product"),
];
DecisionQuestion question = new()
{
    Kind = DecisionQuestionKind.Choice,
    Instructions = "Which team should handle this support ticket?",
    Options = options,
};
DecisionRequest request = new()
{
    State = "I was charged twice for my subscription.",
    Questions = [question],
};

// A Decider keeps the session on a thread of its own.
await using Decider decider = await Decider.CreateAsync(tasks, task);
using DecisionResult result = await decider.DecideAsync(request, CancellationToken.None);

// Closing the session reports a failure that disposing it would not.
await decider.CloseAsync();

DecisionAnswer answer = result.GetAnswer(0);
float[] probabilities = new float[options.Length];
result.GetProbabilities(0, probabilities);

Przeczytaj odpowiedź

Pole Meaning
selectedOption Najbardziej prawdopodobna opcja. W przypadku pytań tak/nie, 1 oznacza wartość true.
confidence Prawdopodobieństwo wybranej opcji.
distributionConfidence 1 minus znormalizowana entropia rozkładu: 1, gdy całe prawdopodobieństwo znajduje się przy jednej opcji, 0, gdy rozkład jest jednolity. Nie jest to skalibrowane prawdopodobieństwo.
expectedScore W przypadku pytań punktowych: oczekiwany poziom.
actProbability Oszacowanie modelu, że na podstawie odpowiedzi można podjąć działanie.
recommendation ACT lub ESCALATE.

Stan dłuższy niż miejsce, które pytanie pozostawia w sekwencji modelu, jest obcięty na końcu. Przekaż stan ustrukturyzowany w postaci tekstu serializowanego.

Zachowaj skompilowane programy

Podobnie jak w przypadku innych zadań korzystających z zaplecza CGC, pierwsza sesja kompiluje programy dla GPU. Ustaw compiledProgramDirectory w opcjach modelu, aby używać ich ponownie w późniejszych procesach. Zobacz Buforowanie skompilowanych programów.

Następne kroki