AI-102 HandsOn Azure AI Languageを勉強する

AI-102の勉強のためにGitHubのHandsOnを実施します。

https://github.com/MicrosoftLearning/mslearn-ai-services
https://github.com/MicrosoftLearning/mslearn-ai-vision
https://github.com/MicrosoftLearning/mslearn-ai-language　→　本記事はこれ
https://github.com/MicrosoftLearning/mslearn-ai-document-intelligence
https://github.com/MicrosoftLearning/mslearn-knowledge-mining
https://github.com/MicrosoftLearning/mslearn-openai

MSLearnのドキュメントはこちら。

[Azure AI サービスを使用して自然言語処理のソリューションを開発する](https://learn.microsoft.com/ja-jp/training/paths/develop-language-solutions-azure-ai/)
　
できるのはこんなこと。
- Azure AI Language
    - 概要作成
    - テキストから言語を検出する
    - テキストのセンチメントを分析する
    - キー フレーズ、エンティティ、リンクされたエンティティを抽出する
- Azure AI Translator
    - 翻訳
- Azure AI Speech
    - 音声対応
    
等

基本的にそれぞれのサービスでポータルがあり、そこでトレーニングやモデルのデプロイができる感じ。

# リソース作成 （Language）
- Question AnsweringにはAI Searchが必要。
- Custom Text ClassificationやSummarizationにはStorage Accountが必要。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/14faba0e-b0ee-2202-6312-25dc4582d37d.png)

# Question Answering、質問応答ソリューションの構築
OpenAIを使わないRAGのようなものととらえればよいか。
質問と応答のFAQ集を元に自然言語で回答してくれる。昔のQnAサービスの進化版。

その他にもLUIS(Language Understanding)というのがあるが、LUISはもっと会話寄り。

## Question Answer Pairs
Language Studioからプロジェクトを作成し、例えば、データソースにMicrosoft Learnを設定したFAQボットを作ってみる。

Language studioのCustom question answeringから。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/9ed9b473-6ca9-527e-c01d-396387c38d54.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/8cdbb36e-e24e-301b-df6c-451c30469546.png)

データソースはURL、ファイル、おしゃべり（ChitChat）の3種類を選べる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/bb2311d5-1967-0769-8df8-615a8b6d6666.png)

HandsOnでは、Microsoft LearnのFAQ集をソースに設定してみる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/b3ba1557-80b9-90f6-0874-0586571c4fb6.png)

こんな風に構造化されていれば自動的に取り込んでくれるぽい。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/827ff590-1a2f-d03f-39ad-c855570bd315.png)

おしゃべり、というのはMicrosoftがBotにキャラクターを与えるための事前定義済み質問集を指す。Witty、Enthsiastic、Caringとかを選べる。中身を見てみると、こんな感じ。年齢は？とか家族は？とかなんとなくBotに質問してしまいそうな内容がある。こちらも設定してみたところこんな感じになった。自分専用のキャラクターとかも作れそう。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/c634b6aa-4461-39d5-00c8-677c20691a12.png)

質問は自分でも追加できる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/01a66e7f-6566-463c-25ea-fe235718b6b3.png)

Alternate Questionというので、言い回しが違うけど同じ回答というケースを定義できる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/dff79976-0bf4-1156-4f48-8c839e0b2d32.png)

Follow-up promptで回答に補足をつけることができる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/1d844893-1768-bf6e-a6af-e63243c3998b.png)

Follow-upを作ったらEditorialというのが裏にできていて、そこに保存されていた。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/9d35ba5c-bfe6-d9d4-ba18-963fe2c119cf.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/457f4190-8c38-d721-0059-a1801b122907.png)

## Test
テストをしてみると、Wittyに設定したおしゃべりやFollow-up promptが出てくる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/6a42ec3a-2528-9416-802d-5f1144cbe10d.png)

## Deploy
URLのエンドポイントができる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/7b059676-7c31-74e8-4f72-5e10ee979309.png)

このエンドポイントはカスタムアプリからも呼べるし、又はCreate a botボタンからクリック1つでAzure AI Bot Serviceと連携してWeb Botを簡単に作ることができる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/3e250514-13b4-900a-660c-fc8887baf78e.png)

https://learn.microsoft.com/ja-jp//azure/ai-services/language-service/question-answering/tutorials/bot-service

こんな感じで呼び出せる。
```
curl -X POST "https://{endpoint}.cognitiveservices.azure.com/language/:query-knowledgebases?projectName=LearnFAQ&api-version=2021-10-01&deploymentName=production" 
-H "Ocp-Apim-Subscription-Key: {KEY}" 
-H "Content-Type: application/json" 
-d "{\"top\":3,
\"question\":\"YOUR_QUESTION_HERE\",
\"includeUnstructuredSources\":true,
\"confidenceScoreThreshold\":\"YOUR_SCORE_THRESHOLD_HERE\",
\"answerSpanRequest\":{\"enable\":true,\"topAnswersWithSpan\":1,
\"confidenceScoreThreshold\":\"YOUR_SCORE_THRESHOLD_HERE\"},
\"filters\":{\"metadataFilter\":{\"logicalOperation\":\"YOUR_LOGICAL_OPERATION_HERE\",
\"metadata\":[{\"key\":\"YOUR_ADDITIONAL_PROP_KEY_HERE\",
\"value\":\"YOUR_ADDITIONAL_PROP_VALUE_HERE\"}]}}}"
```


# 会話言語理解モデル (Conversational language understanding model)
## 最初に
AlexaやGoogleHomeのBotみたいに、会話からキーフレーズを抽出するための技術。GPTみたいに汎用的ではないから、会話理解というと言い過ぎな印象を受ける。

こういう流れらしい。GPTでもプロンプトでできそうではあるが、ちゃんとトレーニングできるのがいいところ。

```
1. アプリが、ユーザーから自然言語入力を受け入れます。
2. 言語モデルを使用してセマンティックの意味 (ユーザーの "意図") を特定します。
3. アプリが、適切なアクションを実行します。
```
Conversational language understandingを選択。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/d5f0461f-e7ca-f7d1-ff11-13d11a882a43.png)

## プロジェクト作成
※なんかこの辺でうまくプロジェクトが作成できないときがあったが、Storage AccountありでLanguageリソースを作り直すとうまくいった。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/c2d65f8a-925f-26fa-0144-f40a3ab5ff4e.png)

会話理解には以下の要素がある。
- 入力される会話内容である発話、Utterance

- 実際にやってほしい意図、Intent

- その意図を理解して何を処理してほしいかを定義する、Entity Component

- 実際にトレーニングされたモデル

作業の順番
①Intentを作る
②IntentにEntityを紐づける
③ModelをDeployする
④IntentにUtteranceの例文を紐づける

## Intent
まずはIntentを作成する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/a6ebc34e-81d4-39fc-b424-916bf5ed3211.png)

## Utterance
Data LabelingからIntentを要求する発話の例を定義してやる。（さっきのQnAに似ている）
GetTimeには"what time is it?"のように。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/889cc863-a6f9-af7e-72c8-29fac01be063.png)

## Model
Modelをトレーニングする。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/a4a98f16-ad0e-878f-672a-a748f90e399d.png)

ModelをDeployする。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/9b68cbee-b60b-6203-1fec-8be971224426.png)

Testする。意図を理解してくれるから、Utteranceが少し違ってもちゃんと返ってくる。
```
{
    "query": "What time?\n",
    "prediction": {
        "topIntent": "GetTime",
        "projectKind": "Conversation",
        "intents": [
            {
                "category": "GetTime",
                "confidenceScore": 0.96072626
            },
            {
                "category": "GetDate",
                "confidenceScore": 0.87814885
            },
            {
                "category": "GetDay",
                "confidenceScore": 0.79664844
            },
            {
                "category": "None",
                "confidenceScore": 0
            }
        ],
        "entities": []
    }
}
```

## Entity
上記でちゃんと正しいIntentが選択されることがわかった。それでは実際にEntityを紐づけて、データ抽出的なことができるようにしてみる。
Entityの種類は4種類。
- Learned
- List
- Prebuilt
- Regex

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/1e4192a5-515f-2333-859d-caae23899ba0.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/76728378-bb60-c3af-c62a-c0e2d22787d4.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/b07b34df-99f0-9927-fedd-83b024cd1633.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/2b99c708-e3ef-9196-2de4-4791b3012d81.png)

### Learnedを作ってみる
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/0d5b37f4-8e97-1120-0054-d738f84e8bc5.png)

Data LabelingからGetTimeのIntentに"What time is it in London?" のLondonを選択し、LocationのEntityを追加する。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/ca9e5c92-a351-4133-96fb-346ab47e02c5.png)

### Listを定義する
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/9a9b8460-0170-902a-327a-78cf163793ba.png)

さっきと同じ感じで選択。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/0c46dea6-48b5-af9c-a992-91f5ee8c6896.png)

### Prebuiltを選ぶ
Boolean, DateTime, Email, IPAddress等色々ある。
今回はDateTimeを選択。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/c40ecdb5-fdb7-beb7-4f22-4bc2ed1aeb6c.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/70863084-8b5a-d87a-516d-6a94fc16ed5e.png)

※Microsoft Outlookとかで時間が本文に入っているときに会議を自動的に作る機能とかこういう処理が裏でされているのかなと思ったり。

## 動作確認
Entityを変更した後は、再度トレーニング、再デプロイする。
先ほどのEntityで定義した部分が抽出されている。

```
{
    "query": "what time is it in Tokyo?\n",
    "prediction": {
        "topIntent": "GetTime",
        "projectKind": "Conversation",
        "intents": [
            {
                "category": "GetTime",
                "confidenceScore": 0.87871605
            },
            {
                "category": "GetDay",
                "confidenceScore": 0.71863574
            },
            {
                "category": "GetDate",
                "confidenceScore": 0.7082026
            },
            {
                "category": "None",
                "confidenceScore": 0
            }
        ],
        "entities": [
            {
                "category": "Location ",
                "text": "Tokyo",
                "offset": 19,
                "length": 5,
                "confidenceScore": 1
            }
        ]
    }
}

{
    "query": "what's the date on Weds?",
    "prediction": {
        "topIntent": "GetDate",
        "projectKind": "Conversation",
        "intents": [
            {
                "category": "GetDate",
                "confidenceScore": 0.9679488
            },
            {
                "category": "GetDay",
                "confidenceScore": 0.95016205
            },
            {
                "category": "GetTime",
                "confidenceScore": 0.8293059
            },
            {
                "category": "None",
                "confidenceScore": 0
            }
        ],
        "entities": [
            {
                "category": "Weekday",
                "text": "Weds",
                "offset": 19,
                "length": 4,
                "confidenceScore": 1
            },
            {
                "category": "Date",
                "text": "Weds",
                "offset": 19,
                "length": 4,
                "confidenceScore": 1,
                "resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "XXXX-WXX-3",
                        "value": "2024-04-03"
                    },
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "XXXX-WXX-3",
                        "value": "2024-04-10"
                    }
                ],
                "extraInformation": [
                    {
                        "extraInformationKind": "EntitySubtype",
                        "value": "datetime.date"
                    }
                ]
            }
        ]
    }
}
```

ちょっと面白かったのが、わざとUttenranceやSynonymで定義していない誤字を入れてみてもちゃんと抽出してくれた。ただし、当たり前だけど正しいものに訂正とかはしてくれないみたいだ。
```
{
    "query": "what's the date on Wenedsday?",
    "prediction": {
        "topIntent": "GetDate",
        "projectKind": "Conversation",
        "intents": [
            {
                "category": "GetDate",
                "confidenceScore": 0.9753281
            },
            {
                "category": "GetDay",
                "confidenceScore": 0.96795267
            },
            {
                "category": "GetTime",
                "confidenceScore": 0.8847069
            },
            {
                "category": "None",
                "confidenceScore": 0
            }
        ],
        "entities": [
            {
                "category": "Date",
                "text": "Wenedsday",
                "offset": 19,
                "length": 9,
                "confidenceScore": 1,
                "extraInformation": [
                    {
                        "extraInformationKind": "EntitySubtype",
                        "value": "datetime.date"
                    }
                ]
            }
        ]
    }
}
```

### アプリから呼び出し
HomeBotとかの開発だと、通信にはSDKを使うため詳細は省略。
```
curl -X POST "https://{endpoint}.cognitiveservices.azure.com/language/:analyze-conversations?api-version=2022-10-01-preview" 
-H "Ocp-Apim-Subscription-Key: {Key}"  
-H "Apim-Request-Id: {id}" 
-H "Content-Type: application/json" 
-d "{\"kind\":\"Conversation\",
\"analysisInput\":{
\"conversationItem\":{
\"id\":\"PARTICIPANT_ID_HERE\",
\"text\":\"YOUR_QUERY_HERE\",
\"modality\":\"text\",
\"language\":\"QUERY_LANGUAGE_HERE\",
\"participantId\":\"PARTICIPANT_ID_HERE\"}},
\"parameters\":{\"projectName\":\"Clock\",
\"verbose\":true,
\"deploymentName\":\"production\",
\"stringIndexType\":\"TextElement_V8\"}}"
```

流れ的にはIntentsからConfidenceScoreが一番高いものを選択し、それからEntitiesを抽出し、独自のカスタム処理を実施させていく感じになる。

# テキストを分類する (Text Classification)
## プロジェクト作成
Storage Accountに配置したファイルを分類するため、Storage Accountが必須。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/d68b25bf-3829-98c0-9bec-6581f680358f.png)

分類先をSingle CategoryとMulti Categoryで選べる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/c08db155-6a0e-eb1b-b979-97e7eb40bb7e.png)

## 手動ラベリング
Storage Accountに配置したファイルが表示されるので自分でラベルをつける。この際に、データをテストデータにするかか、トレーニングデータにするかを選べる。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/f426fdb2-994a-e2f6-6a61-4f13962b04da.png)

こちらはまだPreviewのようだが、OpenAIで自動的に分類させることもできるみたい。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/b2564ccb-3c80-0001-eebe-0b50989f58a4.png)

## Training
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/a0597922-3032-1c92-6fd8-6014f641a4f6.png)

モデルの精度が表示される。テストデータを使っていて、100%ではない場合、手動でラベリングしたものとモデルの結果が異なるということ。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/4e3e5eda-2d88-9aa9-119a-04c48cce3eda.png)

```
 正しい分類とは、実際のラベルが x のときに、モデルでラベルが x と予測される場合です。 実際には、分類が正しくない場合のドキュメントのエラーにはさまざまな種類があります。

- 擬陽性 - モデルによる予測は x ですが、ファイルには x というラベルが付けられていません。
- 擬陰性 - モデルによる予測はラベル x ではありませんが、ファイルには実際には x というラベルが付けられています。
これらのメトリックは、Azure AI Language によって提供される 3 つのメジャーに変換されます。

-リコール - すべての実際のラベルのうち、識別された数。ラベル付けされたすべてのものに対する真陽性の割合。
-精度 - 予測されたラベルのうち正しいものの数。識別されたすべての陽性に対する真陽性の割合。
-F1 スコア - 各コンポーネントのバランスを最大化するために 1 つのスコアを提供することを目的とした、"リコール" と "精度" の関数
```

要はリコールは検出率、精度は検出して正確にラベル付けできた割合。

この辺をもとにテストデータを追加して精度を改善していく。

ちなみにTraining後にはStorage Accountにキャッシュ？が作成されていた。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/7864ac7a-34db-2732-1b42-f086b370f9ff.png)


## Deploy
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/7e0e061a-b64f-2499-1b10-d98d917f34b7.png)

```
curl -X POST "https://{endpoint}.cognitiveservices.azure.com/language/analyze-text/jobs?api-version=2022-10-01-preview" 
-H "Ocp-Apim-Subscription-Key: {key}" 
-H "Content-Type: application/json" 
-d "{\"tasks\":[{\"kind\":\"CustomSingleLabelClassification\",
\"parameters\":{\"projectName\":\"ClassifyLab\",
\"deploymentName\":\"articles\"}}],
\"displayName\":\"CustomTextPortal_CustomSingleLabelClassification\",
\"analysisInput\":{\"documents\":[{\"id\":\"document_CustomSingleLabelClassification\",
\"text\":\"YOUR_DOCUMENT_HERE\",
\"language\":\"YOUR_DOCUMENT_LANGUAGE_HERE\"}]}}"
```

## Test
他のに比べて大分レスポンスがシンプル。
```
{
    "classes": [
        {
            "category": "News",
            "confidenceScore": 0.36
        }
    ]
}
```

# カスタム固有表現認識 (Custom named entity recognition)
テキスト ドキュメントからあらかじめ定義されたエンティティを抽出する。エンティティは、人、場所、物、イベント、スキル、または値。上でやった会話理解とかなり似ている気がする。。。

## 最初に
プロジェクトを作成。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/f9c8e0bd-1c73-4316-78d2-8392be1b3a29.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/8b6e2c7c-1608-4418-7142-f240b401189b.png)

## Data Labeling
ラベルを作成し、手動で文章の該当部分をピックアップ。
ここではItemForSale、Price、Locationの3つをラベリングしていく。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/0947bb9a-5231-1daf-3af4-996adb3348e1.png)

ちなみに1個だけ手動でやって、それ以外はGPTによるAuto-labelingを使ってみたところちゃんとラベリングされた。ただ結局手動でOKを確定しなくてはいけないらしく、ここをちゃんとしないとTrainingができない。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/9fdd1ef3-afd6-26f2-4f84-a4057d174a7f.png)


## Training
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/0fe0b525-0e07-e96d-349f-cd677c62f871.png)

たまたまかもしれないけどやたらと時間がかかった。。。

## Model Performance
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/8481a594-5d66-46a5-f883-5cad0780ff97.png)

```
- Precision	すべての試行された認識に対する成功した表現認識の比率。 高いスコアは、エンティティが認識されている限り、正しくラベル付けされることを意味します。
- Recall	ドキュメントの実際のエンティティの数に対する成功した表現認識の比率。 高いスコアは、適切なラベルが割り当てられているかどうかに関係なく、エンティティを適切に検出できたことを意味します
- F1 スコア	単一のスコアリング メトリックを提供する精度とリコールの組み合わせ
```
要するに、Recallは検出できるかの指標、Precisionは検出できたものが正しくラベル付けされているかということらしい。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/fc2eb635-4d2b-7d82-4b9e-bcc9f0b897ad.png)

これはFalse Positiveとなっていて、普通に回答ミス。70 lbの重さとPriceを勘違いしてしまっている。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/b7f07f57-e8ba-7558-4896-4c8bb4bf7e08.png)

こういうデータを元に、必要なトレーニングデータを追加していく。

## Deploy
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/311d4c8d-5900-04f3-237c-012e9498f855.png)

```
curl -X POST "https://{endpoint}.cognitiveservices.azure.com/language/analyze-text/jobs?api-version=2022-10-01-preview" 
-H "Ocp-Apim-Subscription-Key: {key}" 
-H "Content-Type: application/json" 
-d "{\"tasks\":[{
\"kind\":\"CustomEntityRecognition\",
\"parameters\":{
\"projectName\":\"CustomEntityLab\",
\"deploymentName\":\"AdEntities\",
\"stringIndexType\":\"TextElement_v8\"}}],
\"displayName\":\"CustomTextPortal_CustomEntityRecognition\",
\"analysisInput\":{\"documents\":[{\"id\":\"document_CustomEntityRecognition\",
\"text\":\"YOUR_DOCUMENT_HERE\",
\"language\":\"YOUR_DOCUMENT_LANGUAGE_HERE\"}]}}"
```

## Test
文章を与えると、ItemForSale、Price、Locationを抽出してくれる。
```
{
    "entities": [
        {
            "text": "Glass L Shaped desk",
            "category": "ItemForSale",
            "offset": 0,
            "length": 19,
            "confidenceScore": 0.99
        },
        {
            "text": "$100",
            "category": "Price",
            "offset": 22,
            "length": 4,
            "confidenceScore": 1
        },
        {
            "text": "downtown Detroit MI",
            "category": "Location",
            "offset": 177,
            "length": 19,
            "confidenceScore": 0.99
        }
    ]
}
```

# Azure AI 翻訳 (Azure AI Translator)
機能は3つ。音訳というのは中々面白い。

- 言語検出
```
[
  {
    "language": "ja",
    "score": 1.0,
    "isTranslationSupported": true,
    "isTransliterationSupported": true
    
    
   }
]
```

- 翻訳
```
[
  {"translations": 
    [
      {"text": "Hello", "to": "en"},   
      {"text": "Bonjour", "to": "fr"}
    ]
  }
]
```
- 表記変換（音訳）
```
curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&fromScript=Jpan&toScript=Latn" 
-H "Ocp-Apim-Subscription-Key: <your-key>" 
-H "Ocp-Apim-Subscription-Region: <your-service-region>" 
-H "Content-Type: application/json" 
-d "[{ 'Text' : 'こんにちは' }]"

[
    {
        "script": "Latn",
        "text": "Kon'nichiwa"
    }
]
```

## カスタム翻訳モデル
カスタム翻訳ツールポータルがあるので、こちらでWorkspace, Projectを作成。Domainというのを選べて、業界用語的なところに対応してくれるのかな？
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/5e5dfa30-ab3e-c2cb-221b-89de7549306d.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/245ac619-7536-b241-0d79-f7a3d1551225.png)

HandsOnがAPIメインでつまらなかったので、こちらにQuickStartをやってみる。

https://learn.microsoft.com/ja-jp/azure/ai-services/translator/custom-translator/quickstart

### トレーニング
人が翻訳した望ましい翻訳文を英語とドイツ語でアップロードする。その他辞書ファイルとかもアップできるらしい。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/ac981f66-ded0-bbd7-971c-5bd18a714d11.png)


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/12f58c6f-8a0e-58e4-4db1-292409dbf5d9.png)

取り込まれた。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/b223baf9-ec5b-e380-3bb6-db3750d68709.png)

Trainingしてみる。
10,000 unique training sentences required.とあり、Trainingだけで60ドル近くかかってしまう、かつ数時間かかるらしい。。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/89c6c19d-6401-3f66-72a5-c5fb1e3491ec.png)

ので、ここはドキュメントからスクショを拝借。BLEUスコアという翻訳の品質を測るスコアがあるらしい。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/654538/dbe8d78e-bd30-ee1d-fc2d-73121fdceaa2.png)

## Deploy
あとはデプロイして、API経由で発行するだけ。

普通にただ翻訳したいだけならこうだが、
```
https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

[
    {"Text":"Where can I find my employee details?"}
]
```

カスタムモデルを利用して翻訳する場合はCategory IDを付与する必要がある。

https://learn.microsoft.com/ja-jp/azure/ai-services/translator/custom-translator/how-to/translate-with-custom-model

```
Category ID は、WorkspaceID、プロジェクト ラベル、およびカテゴリ コードを連結して作成されます。

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&to=de&category=a2eb72f9-43a8-46bd-82fa-4693c8b64c3c-TECH
```

# 音声
- 音声テキスト変換
- テキスト読み上げ（音声合成） 
- Speech Translation
- Speaker Recognition（音声に基づいて個々の話者を認識）
- 意図認識（音声入力の意味論的意味を判断する API）

ちょっと色々機能が多すぎるので、今は記載しない。後で別にまとめるかも。