Microsoft-Decision-1とは？ Jevと同じ形の判定専用AIをAzureで試す【C#実践アプリ開発ラボ】

{
  "model": "decision-1",
  "state": "勤怠管理クラウドのサポート窓口に、問い合わせフォームから次の本文が届きました。\n\n解約を考えています。今月分の料金は日割りになりますか？",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "この問い合わせを担当する窓口を選んでください。",
      "criteria": {
        "請求": "請求書・支払い・料金の計算",
        "技術": "ログイン・操作方法・不具合・データの出力",
        "契約": "プランの変更・解約・契約内容",
        "その他": "どれにも当てはまらない（営業や宣伝の売り込みを含む）、または本文から担当を決められない"
      }
    }
  }
}

{
  "answers": {
    "team": {
      "choice": "請求",
      "probabilities": { "請求": 0.73, "契約": 0.27, "技術": 0.00, "その他": 0.00 }
    }
  }
}

{
  "team": {
    "type": "choice",
    "instructions": "この問い合わせを担当する窓口を選んでください。",
    "criteria": {
      "請求": "請求書・支払い・料金の計算",
      "技術": "ログイン・操作方法・不具合・データの出力",
      "契約": "プランの変更・解約・契約内容",
      "その他": "どれにも当てはまらない（営業や宣伝の売り込みを含む）、または本文から担当を決められない"
    }
  },
  "urgency": {
    "type": "score",
    "instructions": "この問い合わせの緊急度を評価してください。",
    "criteria": ["低", "中", "高"]
  },
  "complaint": {
    "type": "noul",
    "instructions": "この問い合わせは、当社への不満や苦情を伝えていますか？"
  }
}

namespace InquiryRouter;

// 問い合わせフォームから届いた1件。判定に使うのは本文だけ
record Inquiry(int Id, string Body)
{
    // Decision-1 に渡す state。どこに届いた本文かを前に書く。会社名・氏名・メールは判定に要らないので入れない
    public string ToState() =>
        $"勤怠管理クラウドのサポート窓口に、問い合わせフォームから次の本文が届きました。\n\n{Body}";
}

using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Encodings.Web;
using System.Text.Json;
using System.Text.Json.Nodes;
using Azure.Core;

namespace InquiryRouter;

// Decision-1 を呼ぶ。state に状況、questions に問いを入れて送り、答えの JSON を返す
sealed class DecisionClient(string endpoint, string deployment, TokenCredential credential)
{
    static readonly HttpClient http = new() { Timeout = TimeSpan.FromSeconds(60) };
    public static readonly JsonSerializerOptions Json = new(JsonSerializerDefaults.Web) {
        Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping
    };

    AccessToken token;

    public async Task<JsonObject> AskAsync(string state, JsonObject questions)
    {
        // アクセストークン（認証の通行証）の取得は1〜2秒かかるので、期限が近づくまで使い回す（順に呼ぶ前提の簡易な作り）
        if (token.ExpiresOn < DateTimeOffset.UtcNow.AddMinutes(5))
            token = await credential.GetTokenAsync(
                new TokenRequestContext(["https://cognitiveservices.azure.com/.default"]), default);
        using var request = new HttpRequestMessage(HttpMethod.Post,
            endpoint.TrimEnd('/') + "/providers/microsoft/v1/systemone");
        request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token.Token);
        // JsonContent はContent-Lengthを付けずに送るため、Decision-1 に 400 で断られる。文字列にしてから送る
        request.Content = new StringContent(JsonSerializer.Serialize(new { model = deployment, state, questions }, Json),
            System.Text.Encoding.UTF8, "application/json");

        using var response = await http.SendAsync(request);
        if (!response.IsSuccessStatusCode) // 400 のときは、問いの書き方の誤りが本文に書かれている
            throw new HttpRequestException($"{(int)response.StatusCode}: {await response.Content.ReadAsStringAsync()}");
        return (await response.Content.ReadFromJsonAsync<JsonObject>())!;
    }
}

勤怠管理クラウドのサポート窓口に、問い合わせフォームから次の本文が届きました。

解約を考えています。今月分の料金は日割りになりますか？

{
  "model": "microsoft-decision-1",
  "answers": {
    "complaint": {
      "noul": 0.0075772716733891144,
      "type": "noul"
    },
    "team": {
      "choice": "請求",
      "confidence": 0.7025085586777275,
      "probabilities": {
        "その他": 0.00042968088067333216,
        "契約": 0.22258025977083654,
        "技術": 0.0001086403401944728,
        "請求": 0.7768814190082957
      },
      "type": "choice"
    },
    "urgency": {
      "confidence": 0.9899083973989802,
      "legend": {
        "0": "低",
        "1": "中",
        "2": "高"
      },
      "probabilities": {
        "0": 0.9932722649326535,
        "1": 0.006692615428002947,
        "2": 0.00003511963934343569
      },
      "score": 0.006762854706689818,
      "type": "score"
    }
  },
  "usage": {
    "input_tokens": 169,
    "output_tokens": 3
  }
}

using System.Text.Json.Nodes;

namespace InquiryRouter;

// Decision-1 の答えから、振り分けに使う値を取り出したもの
sealed record Judgment(string Team, double TeamProbability, double Urgency, double Complaint)
{
    public static Judgment From(JsonObject response)
    {
        var answers = response["answers"]!;

        // choice：選ばれた選択肢と、選択肢ごとの確率
        var team = answers["team"]!["choice"]!.GetValue<string>();
        var teamProbability = answers["team"]!["probabilities"]![team]!.GetValue<double>();

        // score：段階の番号（低=0・中=1・高=2）を確率で重み付けした平均
        var urgency = answers["urgency"]!["score"]!.GetValue<double>();

        // noul：問いに「はい」と答える確率
        var complaint = answers["complaint"]!["noul"]!.GetValue<double>();

        return new(team, teamProbability, urgency, complaint);
    }

    public override string ToString() =>
        $"担当={Team}({TeamProbability:P0}) 緊急度={Urgency:F2} 不満={Complaint:P0}";
}

namespace InquiryRouter;

// 判定から振り分け先を決める
static class Router
{
    // しきい値は7件の実測を見て置いた例の値。自社の問い合わせで決める
    const double TeamThreshold = 0.9;
    const double ComplaintThreshold = 0.5;

    public static string Route(Judgment judgment)
    {
        // 担当が「その他」か、担当の確率が低ければ人が振り分ける
        var destination = judgment.Team == "その他" || judgment.TeamProbability < TeamThreshold
            ? "人が振り分ける"
            : $"{judgment.Team}の受付箱";

        // 不満が強ければ、上長にも知らせる
        return judgment.Complaint >= ComplaintThreshold
            ? $"{destination}＋上長に知らせる"
            : destination;
    }
}