初期構築時の注意

利用者のログを残したければ、App Insightsを有効にして作成する。
FAQチャットボットを運用する場合、ログが無いと何も改善できないので、有効にするのが良いと思われる。

ナレッジベース初回登録時の注意

ナレッジベースに初めて登録する質問＋回答で、Search Serviceの言語が決まる。後からの変更はできないので、QnA Makerを作り直さなければいけない。

参考：下記記事のQ1
QnA Maker API V4 (一般公開版) のよくあるご質問 – Japan Cognitive Services Support Blog

質問と全く同じ文を入力しても答えが返ってこない場合、この状態に陥っている可能性がある。

QnA Maker構築時に作られるApp Serviceについて

QnA Makerを作成して出来るApp Serviceは、ナレッジベースのメンテ等APIの提供に使われているっぽいので、いじってしまうとAPIが動作しなくなったりしてしまう。

Q&Aのログを参照する

QnA Maker作成時にApp Insightsを有効にしていれば、App Insightsにログがたまる。
https://docs.microsoft.com/ja-jp/azure/cognitive-services/qnamaker/how-to/get-analytics-knowledge-base

同義語を登録する

「パソコン」であれば、「PC」や「コンピュータ」など、同義語を登録してQ&Aのヒット率を向上させることができる。同義語についてはAPIしか用意されていないため、PowerShellなどを使って登録＆更新する必要がある。

Alterations (Azure Cognitive Services) | Microsoft Docs

APIの実行に必要な Endpoint と Key は、Azureポータルの Cognitive Service のページから取得できる。

同義語の登録は置換式なので、一度登録済みの内容を取得してから同義語を追加し、登録するのが良い。

以下、同義語の取得＆登録ができるPowerShellのサンプル。

Param($func)

$endpoint = "https://westus.api.cognitive.microsoft.com/qnamaker/v4.0"
$key = "Azureポータルで取得したキー"

$headers = @{"Ocp-Apim-Subscription-Key" = $key}

$filename = "alterations.json"

<#
    同義語を取得する
#>
function GetAlterations() {
    $url = "${endpoint}/alterations"

    $rc = Invoke-WebRequest -Uri $url -Headers $headers -OutFile $filename -PassThru
}

<#
    同義語を登録する
#>
function PutAlterations() {
    $url = "${endpoint}/alterations"

    $rc = Invoke-WebRequest -Uri $url -Headers $headers -Method Put -InFile $filename
}

if ($func -eq "get") {
    GetAlterations
} elseif ($func -eq "put") {
    PutAlterations
}

コンソールから.\alterations.ps1 "get"と実行すると登録済みの同義語の取得、.\alterations.ps1 "put"と実行すると同義語の登録ができる。同義語のファイルは、スクリプトと同じフォルダにalterations.jsonというファイル名で保存される。

次のステップ

Bot Serviceを作る (ナレッジ←→UIの中間部分)