}
]
}
]
}
```
#### 發送語音
以下回應將發送語音檔案；目前 Messenger 僅支援 25MB 以下的 MP3、OCG、WAV 語音檔。
```
{
"messages": [
{
"attachment": {
"type": "audio",
"payload": {
"url": "https://ccrma.stanford.edu/~jos/mp3/bachfugue.mp3"
}
}
}
]
}
```
#### 發送檔案
以下回應將發送檔案。目前 Messenger 僅支援 25MB 以下的檔案，不分檔案類型。
```
{
"messages": [
{
"attachment": {
"type": "file",
"payload": {
"url": "http://www.africau.edu/images/default/sample.pdf"
}
}
}
]
}
```
#### 發送圖文模組
以下回應將發送圖文模組。請注意圖文模組中的每一個項目都包含圖片、描述、與按鈕。
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "generic",
"image_aspect_ratio": "square",
"elements": [
{
"title": "Yoctol Image 1",
"image_url": "https://www.yoctol.com/images/amazingBrain.png",
"subtitle": "Size: M",
"buttons": [
{
"type": "web_url",
"url": "https://www.yoctol.com",
"title": "View Item"
}
]
},
{
"title": "Yoctol Image 2",
"image_url": "https://www.yoctol.com/images/amazingBrain.png",
"subtitle": "Size: L",
"default_action": {
"type": "web_url",
"url": "https://www.yoctol.com",
},
"buttons": [
{
"type": "web_url",
"url": "https://www.yoctol.com",
"title": "View Item"
}
]
}
]
}
}
}
]
}
```
#### 發送清單範本
以下回應將發送清單範本，更多設定請參考 [Messenger 清單範本](https://developers.facebook.com/docs/messenger-platform/send-messages/template/list/)。
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "list",
"top_element_style": "large",
"elements": [
{
"title": "Yoctol List Image 1",
"image_url": "https://www.yoctol.com/images/amazingBrain.png",
"subtitle": "Size: M",
"buttons": [
{
"type": "web_url",
"url": "https://www.yoctol.com",
"title": "查看商品"
}
]
},
{
"title": "Yoctol List Image 2",
"image_url": "https://www.yoctol.com/images/amazingBrain.png",
"subtitle": "Size: L",
"default_action": {
"type": "web_url",
"url": "https://www.yoctol.com",
},
"buttons": [
{
"type": "web_url",
"url": "https://www.yoctol.com",
"title": "查看商品"
}
]
}
]
}
}
}
]
}
```
#### 按鈕
以下回應將發送按鈕。您可以設定各個按鈕的動作，例如打開網站。更多關於按鈕的用法，請參考 [Messenger 按鈕](https://developers.facebook.com/docs/messenger-platform/send-messages/buttons)。
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "button",
"text": "您好",
"buttons": [
{
"type": "web_url",
"url": "https://www.yoctol.com",
"title": "打開網站"
}
]
}
}
}
]
}
```
另外您也可以傳送特殊按鈕，例如撥打電話、分享。
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "generic",
"elements": [
{
"title": "想知道更多嗎？",
"image_url": "https://www.yoctol.com/images/amazingBrain.png",
"subtitle": "可以和我們直接聯絡！若覺得我們的服務很棒，請不吝分享給大家！",
"buttons": [
{
"type": "phone_number",
"phone_number": "+886223222168",
"title": "打給客服"
},
{
"type": "element_share"
}
]
}
]
}
}
}
]
}
```
#### 快速回覆
以下回應將發送快速回覆。
```
{
"messages": [
{
"text": "請問你喜歡剛才提供的餐點嗎?",
"quick_replies": [
{
"title": "超愛！",
}
]
}
]
}
```
# 應用 API 元件 - LINE
### **功能簡介**
您可以發送多種不同 HTTP 請求方法，讓機器人解析您的伺服器回應並回覆訊息。
具體而言，您將可以執行：
1. 創建動態訊息
2. 執行 postbacks
3. 取得並設定使用者參數（即將到來）
4. 轉向其他節點（即將到來）
### **回傳參考**
我們將解析您回傳的 JSON，以此為根據發送訊息給您的顧客。更多訊息請參考 [LINE API 文件](https://developers.line.biz/en/reference/messaging-api/)。
#### **發送文字**
以下回應將發送文字訊息。
```
{
"messages": [
{
"type": "text",
"text": "歡迎使用最聰明的聊天機器人平台 —— YOCTOL.AI"
},
{
"type": "text",
"text": "您打算創建怎樣的機器人呢？"
}
]
}
```
#### **發送圖片**
目前圖片格式支援 JPG，以下回應將發送圖片訊息。
```
{
"messages": [
{
"type": "image",
"originalContentUrl": "https://example.com/original.jpg",
"previewImageUrl": "https://example.com/preview.jpg"
}
]
}
```
#### **發送影片**
以下回應將發送影片檔案。目前 LINE 僅支援 10MB 以下、1 分鐘以內的 MP4 檔網址。
```
{
"messages": [
{
"type": "video",
"originalContentUrl": "https://example.com/original.mp4",
"previewImageUrl": "https://example.com/preview.jpg"
}
]
}
```
#### **發送語音**
以下回應將發送語音檔案；目前 LINE 僅支援 10MB 以下、1 分鐘以內的 M4A 語音檔網址。
```
{
"messages": [
{
"attachment": {
"type": "audio",
"payload": {
"url": "https://ccrma.stanford.edu/~jos/mp3/bachfugue.mp3"
}
}
}
]
}
```
#### **發送貼圖**
以下回應將發送貼圖。目前 LINE 支援的[貼圖清單](https://developers.line.biz/media/messaging-api/sticker_list.pdf)。
```
{
"messages": [
{
"type": "sticker",
"packageId": "1",
"stickerId": "1"
}
]
}
```
#### **按鈕**
以下回應將發送按鈕。您可以設定各個按鈕的動作，例如打開網站。更多關於按鈕的用法，請參考 [LINE 按鈕](https://developers.line.biz/en/reference/messaging-api/#buttons)。
```
{
"messages": [
{
"type": "template",
"altText": "This is a buttons template",
"template": {
"type": "buttons",
"thumbnailImageUrl": "https://example.com/bot/images/image.jpg",
"imageAspectRatio": "rectangle",
"imageSize": "cover",
"imageBackgroundColor": "#FFFFFF",
"title": "Menu",
"text": "Please select",
"defaultAction": {
"type": "uri",
"label": "View detail",
"uri": "http://example.com/page/123"
},
"actions": [
{
"type": "postback",
"label": "Buy",
"data": "action=buy&itemid=123"
},
{
"type": "postback",
"label": "Add to cart",
"data": "action=add&itemid=123"
},
{
"type": "uri",
"label": "View detail",
"uri": "http://example.com/page/123"
}
]
}
}
]
}
```
另外您也可以傳送特殊按鈕，例如打開相機。
```
{
"messages": [
{
"type": "template",
"altText": "This is a buttons template",
"template": {
"type": "buttons",
"text": "Please select",
"actions": [
{
"type": "camera",
"label": "Camera"
},
{
"type": "cameraRoll",
"label": "Camera roll"
}
]
}
}
]
}
```
#### **快速回覆**
以下回應將發送快速回覆。
```
{
"messages": [
{
"type": "text",
"text": "Did you enjoy the last game of the CF Rockets?",
"quickReply": {
"items": [
{
"type": "action",
"action": {
"type": "cameraRoll",
"label": "Send photo"
}
},
{
"type": "action",
"action": {
"type": "camera",
"label": "Open camera"
}
}
]
}
}
]
}
```
# Referral Link - Messenger
Referral Link 可以讓您的使用者在點選按鈕時，直接叫出某個節點，以啟動特定對話。
### 說明
Referral link 為 Messenger 平台上提供的進階功能。
單一節點可設定一固定 **網址** ，當顧客點入該網址，會自動導向聊天機器人、顯示此 **節點內容**。此為啟動機器人特定對話的「捷徑」功能。
{% hint style="success" %}
使用 Referral link 功能，使用者不須與機器人層層對話，即可得到特定節點內容。
{% endhint %}
{% hint style="warning" %}
完成後，請務必按下右上角的「發布」，該鏈結才會生效！
{% endhint %}
詳細 Messenger 官方介紹，請參考此 [連結 ](https://developers.facebook.com/docs/messenger-platform/discovery/m-me-links)。
# Extension
### 說明
Extension 為 Messenger 平台上提供的進階功能。
當按鈕連結設定為 **網址** 時，可選擇開啟擴充視窗功能（Extension）。則當顧客點選此按鈕後，*網頁* 將直接顯示於同視窗彈出的 **擴充視窗**，不會另開新視窗或分頁。
{% hint style="success" %}
使用 Extension 功能，則連結的網頁僅需開發*手機版網頁*，不需額外開發*桌上型電腦版*。
{% endhint %}
{% hint style="info" %}
目標網頁須符合 Messenger Extension SDK 設定，才可成功開啟擴充視窗。
{% endhint %}
詳細 Messenger 官方介紹，請參考此 [連結](https://developers.facebook.com/docs/messenger-platform/guides/chat-extensions) 。
# 顧客標籤
### **說明**
利用**`顧客標籤元件`**，為顧客貼上指定標籤後，可於**`顧客標籤名單`**了解顧客最有興趣的面向。並可利用標籤進行**`分群推播`**，精準地提供目標顧客所需的資訊。
### **顧客標籤元件**
1. 於節點的訊息內容新增顧客標籤元件（顧客不會看到此元件內容）。
2. 選擇既有標籤（可於顧客標籤名單建立）或建立標籤。
則當顧客觸發此節點時（可能是透過按鈕點進來、或是自然語意直接觸發），該顧客便會被新增╱移除指定的顧客標籤。
### 顧客標籤名單
#### 標籤列表
* 您可於標籤列表建立、修改、編輯標籤。
* 標籤前數字為「被貼有該標籤之顧客數量」。
#### 顧客列表
* 可查看所有「與機器人互動過的顧客」之資訊。
* 注意：僅對粉絲專頁或貼文按讚、留言、分享者，並未與機器人互動。
* 點擊 PSID 可查詢該名顧客資訊，並可新增╱移除標籤。
### 推播選擇標籤
請參考[設定推播訊息](https://docs.yoctol.ai/touch/push)。
# 設定推播訊息
### 您將學會
* 用 LINE 機器人推播訊息
* 用 Messenger 機器人推播訊息
### 1.建立活動
建立一則訊息推播活動
1. 點選側欄的 **`行銷活動`** 的 **`訊息推播`** 。
2. 在訊息推播列表的右上角，點選 **`＋訊息推播`** 。
3. 進入 **基本設定** 畫面。
4. 輸入 **訊息推播名稱**。
5. 選擇 **推播受眾** 為與所有**`與機器人互動過的顧客`**，或指定 [顧客標籤](https://docs.yoctol.ai/settings/customers_label)。
6. 在 **推播訊息標籤** 選擇最適當的標籤。
{% hint style="danger" %}
請注意平台重要規範
1. Messenger
* 請為您的推播活動選擇最適當的標籤。詳細標籤內容請參閱 [Facebook 訊息標籤政策](https://developers.facebook.com/docs/messenger-platform/send-messages/message-tags/?locale=zh_TW)。
* 請勿用標籤訊息傳送促銷內容（例如：每日好康、優惠券、折扣或拍賣通知）。此行為違反 Facebook 政策，可能導致你的帳號被停權。
* 若您希望傳送促銷訊息，請選擇「包含促銷內容」。
* 促銷訊息只能傳送給 24 小時內有和機器人互動過的使用者。超過 24 小時未與機器人互動的使用者，只能收到一則促銷訊息裡的「第一個回應元件」。
* 例：促銷訊息為新產品文字描述，以及新產品的圖片，共兩個回應元件。超過 24 小時未和機器人互動過的使用者，只會收到文字；24 小時內有和機器人互動過的使用者，則會收到文字與圖片。
2. LINE
* 您需在 LINE@ 上購買 Push API 的付費方案，才能推播。請參閱 [LINE@ 付費方案](https://at.line.me/tw/plan)。
* LINE 推播無需選擇訊息標籤。
{% endhint %}
### 2.編輯訊息內容
訊息推播亦有多種 [元件](https://docs.yoctol.ai/term/element) 可以選擇：
* 文字
* 圖片
* 圖文模組
* 圖文訊息（LINE）
* 快速回覆
* 接續回應
* 隨機元件
### 3.發布排程
1. 選擇 **立即推播** 或 **排程** 。若選擇排程，請設定推播時間。
2. 按下 **推播** 或 **排程** 。
# 使用貼文回覆活動
### 您將學會
* 自動回覆公開留言
* 自動傳送私訊回覆
### 1.步驟一：建立活動
1. 點選側欄的 **`行銷活動`** ，選擇 **`貼文回覆`** 。
2. 在貼文回覆列表的右上角，按下 **`＋貼文回覆`** 。
3. 進入 **活動設定** 畫面。
4. 輸入 **貼文活動標題** 。
5. 在 **選擇貼文** 欄位，選擇您欲串接的貼文。您可選擇「已發布」或「已排程」的貼文。
6. 點擊 **`下一步`** 。
### 2.編輯預設回覆
若使用者輸入的語句，沒有觸發任何關鍵字規則，機器人會採用預設回覆。
1. 在 **預設回覆** 底下的 **回覆內容** ，點選 **公開（公開回覆）** 。
2. 在輸入框輸入預設回覆。
3. 在 **回覆內容** 點選 **`私訊`**，便能設定私訊回覆內容。
{% hint style="info" %}
如何讓機器人的回覆更多元？在訊息編輯框上方，點選 **＋隨機回覆** ，便可建立多則回覆。系統會從中隨機選取。
{% endhint %}
### 3.新增回覆內容
1. 點擊畫面右上角的 **`＋回覆內容`**。
2. 命名回應內容。
3. 在 **關鍵字** 欄位，輸入關鍵字。（為了增加互動彈性，可以將類似的詞彙都建立為關鍵字。）
4. 選擇 **包含任一關鍵字** 或 **所有關鍵字** 。
5. 編輯公開與私訊回覆
{% hint style="info" %}
1.發布後，若想要測試，記得留言時要切換成個人帳號。以紛絲專頁身份是沒辦法觸發機器人回覆留言的哦！
2.Facebook 的私訊回覆功能，僅能傳送純文字。若您想傳送圖片，或是有附帶按鈕的訊息，請利用私訊回覆引導使用者輸入能觸發以上節點的關鍵字的訊息。例如： 只差一步就能得到秘笈囉！請輸入「給我秘笈」 。
{% endhint %}
# 如何改善機器人答錯狀況？
### 問題
為何我的機器人總是答錯？該怎麼讓機器人變聰明？
### 回答
機器人答錯的可能原因包含：
1. 觸發條件設定錯誤
2. 腳本文案設計不佳
3. 自然語意模型判斷錯誤
透過下列解法，將可有效改善機器人的錯誤回答。
### 解法一：修正觸發條件
舉例而言：若您將「外送」的觸發條件，誤植為「意圖：價格」，則無論您將運費查詢的意圖判斷訓練得多麽精準，機器人皆會誤答為「價格」。
敬請於發布前，確認您的觸發條件皆設定無誤。
### **解法二：優化回答文案**
由於人類對同一件事情的講法可能有千百種，若您撰寫了過於針對特定句型的腳本文案，則機器人的對話容易產生牛頭不對馬嘴的感覺。\
建議您至腳本編輯工具，參考以下方針，修調文案。
#### **1.將是非題改寫為開放性回答**
對於類似的事情，可能會使用是非題或開放式問題詢問。撰寫開放性文案，可確保機器人在多種情況下都能回答正確。
> 【範例】對於「營業時間」這項問題：\
> 可能問法一：「星期天有開嗎？」\
> 可能問法二：「你們哪天不營業？」\
> \
> \=> 不良回答：『否。』\
> \
> \=> 建議回答：『我們的營業時間為：週一到週六 10:00 – 22:00，週日公休。』
#### **2. 合併文案**
性質接近的事情，建議您統一建立一個節點，讓機器人的回答可以涵蓋各種可能的問法。
### 解法三：改善自然語意理解力
若機器人答錯的情況，肇因於意圖判斷錯誤，請您進入自然語意工具，參考以下做法：
#### **1.改善訓練句**
您可增加訓練句的句數，並撰寫更多不同句型、用字的訓練句。詳情可參考[(3) 建立意圖 & 撰寫訓練句](https://docs.yoctol.ai/guide/add-intent-utterance)。
#### **2.調整意圖結構**
您可將容易混淆的意圖彼此合併，或是新增更多意圖，以處理機器人還聽不懂的問題。
【範例】\
訓練句一：「信義店在哪裡？」\
訓練句二：「士林店在哪邊？」\
訓練句三：「新竹店在哪？」
因句型相似且詞彙可抽換，故可合併為一句訓練句即可：\
「 {{**分店}}**在哪裡？」
#### **3.適時使用抽換詞**
若某幾則訓練句之間的差別主要是在詞彙的抽換，您可考慮直接使用[抽換詞](https://docs.yoctol.ai/guide/entities)。
提醒您：若您調整了訓練句 / 意圖 / 抽換詞，請您務必按下 **`訓練`** ，自然語意模型才會進行優化。
# 如何啟用測試版機器人？
### 問題
開始使用聊天機器人前，很擔心因為某個環節出了錯，而影響實際營運中的 Facebook 粉絲專頁或 LINE 官方帳號。有沒有什麼解決辦法？
### 回答
您可以**建立測試用的 Facebook 粉絲專頁或 LINE 官方帳號並綁定機器人。**確認沒問題後，再綁定至實際要使用的粉絲專頁或 LINE。
另外，若想測試 LINE 機器人的推播功能，可在 [LINE Developers](https://developers.line.biz/) 開啟 channel ，並選擇 Messaging API -> Developer trail。Developer trail 好友上限 50 人並可推播，但不能升級為付費方案。 Free 免費版雖然不能推播但可以升級付費方案。
透過測試版機器人，您可以特別注意：
**1. LINE 官方帳號綁定機器人後無法與用戶「一對一聊天」**
LINE 官方啟用「Messenger API」 後，您將無法再使用與客戶直接對話的「一對一聊天」功能，亦無法使用部分 APP 介面登入其後台。您可利用測試版機器人確認此情境適合建立何種機器人。(LINE 官方帳號 2.0 推出後預計提供部分解決方案)
**2.Messenger 機器人的訊息標籤政策**
您可利用測試版機器人了解以下 Facebook 對 Messenger 機器人的訊息標籤政策與[「24+1 政策」](https://developers.facebook.com/docs/messenger-platform/policy/policy-overview/?translation#24hours_window)對推播內容的影響。
* 若推播訊息不包含促銷內容，例如：搬家、活動通知，請選擇「不含促銷內容」。並請參閱 [Facebook 訊息標籤政策 ](https://developers.facebook.com/docs/messenger-platform/send-messages/message-tags/?locale=zh_TW)選擇最適當的標籤。
* 若推播訊息包含促銷內容，例如：每日好康、優惠券、折扣或拍賣通知，請選擇「包含促銷內容」。若利用「非促銷內容」的標籤傳送促銷內容，會違反 Facebook 政策，可能導致你的帳號被停權。
* 促銷內容只能傳送給 24 小時內有和機器人互動過的使用者。**超過24小時未與機器人互動的使用者，只能收到促銷內容裡的「第一個回應元件」。**
# 找不到已建立的粉絲專頁
### 問題
在一般設定的機器人綁定區，為何找不到已建立的粉絲專頁？如何解決？
### 回答
如果已確認有建立專頁卻仍出現此情境，代表您的專頁授權可能未進行完整，或僅部分授權。 您可登出 YOCTOL.AI 帳號，再重新登入，至 **`一般設定`** -> **`機器人綁定`** -> **`按此連結 Facebook 帳號`** ，進行完整的授權，以恢復正常行為。
### 排解步驟
1. 請至 Facebook [應用程式和網站](https://www.facebook.com/settings?tab=applications) ，或 [企業整合工具](https://www.facebook.com/settings?tab=business_tools)，將 YOCTOL.AI 移除。
2\. 重新回到 YOCTOL.AI 進行授權
請進入 **`一般設定`** -> **`機器人綁定`** -> **`按此連結 Facebook 帳號`** 進行重新授權，即可找到您的臉書專頁。
{% hint style="danger" %}
請勾選確認完所有授權步驟（共 2 步驟），勿中途跳出，避免授權不完整情形發生。
{% endhint %}
# 如何回到真人回話模式？（LINE）
本篇將教您，如何在 LINE 管理後台關閉機器人功能，回到一對一對話模式。
### **如何回到真人回話模式？**
我之前將我的 LINE 帳號串接了機器人，但是我現在想用真人親自回答消費者的問題，我該怎麼回到真人一對一回話的狀態呢？
### 回答
首先，請先確認您的**該隻 LINE 機器人所串接的 LINE Channel，是 2019 年 4 月 18 日之後才創建的**。只有此日期之後創建的機器人帳號，才能使用「回到一對一回話模式」的功能。
若您已確認機器人符合上述條件，請參考以下步驟，即可切換真人 / 機器人對話模式！
### 方法一
1. 登入您的 [LINE Developers 後台](https://developers.line.biz)
2. 選擇您欲操作的機器人帳號
3. 點選 `Change informations`
4. 在側欄，選擇 `Response settings`
5. 在 `Response mode` 選擇 **Chat**
即可切換成一對一回話模式！
### 方法二
1. 登入您的 [LINE Official Account Manager 後台](https://manager.line.biz)
2. 選擇您欲操作的機器人帳號
* > 請注意：若此時您看到的帳號列表為空白，表示您自 2019 年 4 月 18 日起，尚未創建新的 LINE Channel。此為正常現象。您可採用**方法一**，即可看到您舊有的 LINE Channel。
3. 在側欄，選擇 `Response settings`
4. 在 `Response mode` 選擇 **Chat**
即可切換成一對一回話模式！
### 參考影片
# 下載、上傳機器人
### 問題
我不想從零開始建置機器人。我可以把其他機器人的內容複製過來嗎？
### 回答
在 YOCTOL.AI，您可下載既有的機器人，再上傳至新的空白機器人，即可快速複製機器人內容。
### 排解步驟
1. 請至您欲複製的機器人，選擇 **`設定`** -> **`一般設定`** -> **`下載機器人`** 。
2\. 請點選左上角的 YOCTOL.AI Logo，回到機器人列表。
3\. 點選**`＋新增機器人`**，並上傳您所下載的機器人檔案。
4\. 最後，點選右下角的**`＋新增機器人`**，就完成囉！
# 如何切換語言（中、英文）
### **問題**
我想做英文相關的操作，例如：把介面改成英文、訓練出聽得懂英文的機器人。我該怎麼做呢？
### 切換介面語言為中 / 英文
1. 請至**`帳戶設定`**
2. 將**`顯示語言`**，改為 **English**
3. 按下**`儲存變更`**
### 自然語意：訓練聽得懂英文的機器人
1. 登入您的 [LINE Developers 後台](https://developers.line.biz)創建一隻機器人，或選擇您欲英文化的機器人
2. 點選左側選單的**`設定`** > **`自然語意引擎設定`**
3. 將**`語言`**改成 **英文（English）**
### 注意事項
「自然語意引擎設定」和「介面顯示語言」不會互相連動。也就是說，您可以在英文的介面之下，訓練中文機器人；在中文介面下，訓練英文版的機器人。
# 腳本
### 說明
在 YOCTOL.AI 左邊功能欄 **`機器人編輯`** 中的**`腳本`** 是機器人進行對話互動的依據。機器人所要說的話都要在此事先編輯好。腳本由許多 [節點](https://docs.yoctol.ai/term/node) 所組成。
# 節點
### 說明
在 YOCTOL.AI 左邊功能欄 **`機器人編輯`** 中 **`腳本`** 裡的 **`節點`**（node）是組成機器人[腳本](https://docs.yoctol.ai/term/script)的基本單位。當機器人被使用者以打字輸入語句、點擊按鈕等行為所觸發後，適用的回應內容就是一個節點。
節點內容可能包含：文字、圖片、圖文模組等 [元件](https://docs.yoctol.ai/term/element) 。
節點需要由 [觸發條件](https://docs.yoctol.ai/term/trigger) 觸發。
### 範例
以飲料店機器人為例，它基礎需理解 3 個意圖：商品介紹、訂購外送、門市介紹。聽懂意圖後要讓機器人回話，就必須有承接問題的回應節點：「商品介紹」、「訂購外送」、「門市介紹」。
# 元件
### 說明
在 YOCTOL.AI 的 [節點](https://docs.yoctol.ai/term/node) 中的 **元件** 為組成節點的基礎單位。
YOCTOL.AI 支援 Facebook Messenger 及 LINE 的回應元件。
一個節點中可以有數個元件，針對不同通訊平台，Messenger 平台不限一則回應的元件數量；LINE 平台限制一則訊息最多 5 個元件。
### MESSENGER 回應元件
| 元件名稱 | 說明 |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 文字 | 純文字，可附帶按鈕。按鈕最多為 3 個。按鈕可連結至撥打電話、開啟網頁、或其他節點。 |
| 圖片 | 一則圖片訊息僅能傳送一張圖片，且不可附帶按鈕。
請注意：因應系統的尺寸限制，圖片可能受到自動裁切。
|
| 圖文模組 | 圖文模組（Generic Template，又稱一般型範本） 。
一則訊息最多可附帶 10 格圖文模組，每格最多可設定 3 個按鈕。
|
| 快速回覆 | 快速回覆（Quick Replies）被點擊後，系統會為使用者自動輸入快速回覆上的字串。
一則 Messenger 訊息最多可附帶 11 個快速回覆。點擊後，按鈕會隨之消失在對話中。
快速回覆僅能接續在其他元件之後，不可作為對話的開場白。快速回覆無法開啟網頁。
|
| 接續節點 | 每則回應內容中，皆可從已建立過的節點中選擇，作為接下來的回應。 |
| 隨機元件 | 隨機元件為多組文字元件的組合。系統會從中隨機選取回覆。 |
| JSON API | JSON API 讓你連結機器人與你的伺服器後端，完成高度彈性的回應與額外功能。 |
### **LINE 回應元件**
| 元件名稱 | 說明 |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| 文字 | 純文字，可附帶按鈕。按鈕最多為 3 個。按鈕可連結至撥打電話、開啟網頁、或其他節點。 |
| 圖片 | 一則圖片訊息僅能傳送一張圖片，且不可附帶按鈕。
請注意：因應系統的尺寸限制，圖片可能受到自動裁切。
|
| 圖文模組 | 圖文模組（Carousel Template） 。
一則訊息最多可附帶 10 格圖文模組，每格最多可設定 3 個按鈕。
|
| 圖文訊息 | 圖文訊息（Imagemap）為一張圖片。
圖片內可自訂版型，版型中的每個區域可自訂連結動作，
包含：開啟網頁、傳送訊息。請注意：「圖文訊息」不等同於「圖文選單」。
圖文選單為對話視窗下方常駐之選單。如欲設定，請前往腳本編輯工具的常駐選單頁面。
|
| 快速回覆 | 快速回覆（Quick Replies）被點擊後，系統會為使用者自動輸入快速回覆上的字串。
點擊後，按鈕會隨之消失在對話中。一則 LINE 訊息最多可附帶 13 個快速回覆。
快速回覆僅能接續在機器人產出的語句之後，不可作為對話的開場白。
|
| 接續節點 | 每則回應內容中，皆可從已建立過的節點中選擇，作為接下來的回應。 |
| 隨機元件 | 隨機元件為多組文字元件的組合。系統會從中隨機選取回覆。 |
| JSON API | JSON API 讓你連結機器人與你的伺服器後端，完成高度彈性的回應與額外功能。 |
# 意圖
### 說明
在 YOCTOL.AI 左邊功能欄 **`機器人編輯`** 中的 **`意圖`**（intent）是指機器人對於使用者輸入的自然語言要達成的目標，所給予的分類。
在 YOCTOL.AI 中，若要訓練自然語意引擎，基礎必須有 2 個意圖，最多為 25 個意圖。
{% hint style="info" %}
機器人建置初期建議設定 2-3 個意圖，每個意圖至少 3-5 句 [訓練句](https://docs.yoctol.ai/term/utterance) 再訓練，每個意圖中的訓練句上限為 30 句。
{% endhint %}
### 範例
以飲料店機器人來示範，它基礎要能理解 3 個意圖：
* 商品介紹
* 訂購外送
* 門市介紹
對於同一種意圖，可能有許多不同的自然語言表達方式。舉例而言，當顧客輸入「*招牌是什麼，推嗎？*」、「*外有沒有出新品？*」這兩句話時，根據其語意，機器人都可以將此句子分類為「商品介紹」這個意圖。
### 影片介紹
{% embed url="" %}
# 訓練句
### 說明
在 YOCTOL.AI [意圖](https://yoctol.wpcomstaging.com/2019/03/12/%e6%84%8f%e5%9c%96/) 中能撰寫的 **訓練句**（utterance）是針對每個意圖舉例子讓機器人學習的內容。
建議在每個意圖中撰寫至少 3-5 句訓練句，並以模擬多元、最具代表性的使用者問句作為訓練句。每個意圖中的訓練句上限為 30 句。
您可以在訓練句中搭配 [抽換詞類](https://docs.yoctol.ai/term/entity) 來幫助訓練，一個訓練句中可以用到最多 3 個抽換詞。
### 範例
以飲料店機器人為例，若我們想訓練「訂購外送」這個意圖，可以撰寫以下訓練句。若語句中包含 [抽換詞類](https://docs.yoctol.ai/term/entity)，可使用半型的 {{ }} 標注出抽換詞類。
1. 我要訂很多杯！
2. 買多少可以外送？
3. 訂10杯**{{商品名稱}}**多久可以送到？
4. …
### 影片
{% embed url="" %}
# 抽換詞類
### 說明
在 YOCTOL.AI 左邊功能欄 **`機器人編輯`** 中的 **`抽換詞類`**（entity）是指使用者的輸入語句中，有明確指涉對象的詞彙。常見的抽換詞類包含：物品、人名、時間、地點、金額等。
抽換詞類依附在 [意圖](https://docs.yoctol.ai/term/intent) 之下。當使用者輸入語句時，模型會先判斷語句的意圖，再比對抽換詞類。同一個抽換詞類可用於多個意圖，幫助擴展機器人 [訓練句](https://docs.yoctol.ai/term/utterance) 的廣度。
一個抽換詞類之下可能包含多個抽換詞；一個抽換詞可能會有多個同義詞。
訓練句中包含 [抽換詞類](https://docs.yoctol.ai/term/entity) ，可使用半型的 **{{}}** 標注。
{% hint style="danger" %}
抽換詞類的命名不能以數字作為開頭
{% endhint %}
### 範例
以飲料店機器人為例，搭配「商品介紹」意圖的抽換詞類可能為「商品」：
* 抽換詞類：商品
* 抽換詞：珍珠奶茶、珍珠綠茶
* 同義詞：珍珠奶茶 = 珍奶、珍珠綠茶 = 珍綠
而「商品」抽換詞類在「商品介紹」意圖中的應用如下：
1. **擴展訓練句**：「商品介紹」意圖的訓練句可能有：我想詢問**{{商品}}**？
* 代表這句話在自然語意模型中或擴展成：
* 我想詢問**珍珠奶茶**
* 我想詢問**珍珠綠茶**
* 我想詢問**珍奶**
* 我想詢問**珍綠**
* 試想您有百餘種商品，在訓練機器人的時候就不用撰寫百餘句訓練句把商品帶入，可以直接用抽換詞類幫助訓練。
2. **腳本設計**：針對「商品介紹」意圖對應的腳本，可以安排一次提供菜單或各種商品的介紹
* 基礎的答案：「商品介紹」節點用菜單總覽所有商品
* 您可依照抽換詞類拆分更細緻的答案：
* 「商品介紹\_珍珠奶茶」節點呈現單一商品介紹
* 「商品介紹\_珍珠綠茶」節點呈現單一商品介紹
### 影片
{% embed url="" %}
# 觸發條件
### 說明
在 YOCTOL.AI 中 [節點](https://docs.yoctol.ai/term/node) 的 **`觸發條件`**（trigger）是使機器人回應特定節點的規則。
**一種觸發條件，只能接在單一節點。**\
**但一個節點，可以有多種觸發條件。**
\
若套用在多個節點上，可能導致機器人無法正常回覆。
### 範例
以飲料店機器人中「訂購資訊」節點為例，可應用的觸發條件包含以下：
1. 自然語意：選擇「意圖為：『訂購資訊』」
2. 關鍵字比對：選擇「包含任意詞彙：『下單』、『訂飲料』、『訂購』」
3. 正規表達式：撰寫「.\*(下單|訂飲料|訂購).\*$」等式子，撰寫方式可參考[正規表達式](https://docs.yoctol.ai/term/regex)。
# 正規表達式
### 說明
在 YOCTOL.AI 中 [觸發條件](https://docs.yoctol.ai/term/trigger) 的 **正規表達式** (Regular Expression)，根據其名可解釋為 描述某種規則的表達式 ，是用來檢索、搜尋或替換符合某個模式或特定排列組合的文字。又名為正規表示式、正則表達式、正規表示法、正規運算式、規則運算式、常規表示法，英文名亦可簡稱 Regexp、Regex 或 RE。
### 範例
我們知道語言的表現方式有百百種，同一句話或是一種表達可以有很多表現方式。又或是不同的表達中有很相似的結構類型。這些可以透過觀察，歸納出某個特定的規則或規律來說明、囊括某一種結構或形式相似的表達。
例如：`大杯紅茶、中杯紅茶、小杯奶茶、中杯綠茶`等，我們可以知道是兩個基本特徵變項的組合： `飲料的尺寸`及`茶飲品項`。
這時我們就可以把`大杯、中杯、小杯`歸納成一類，`紅茶、奶茶、綠茶`歸納成一類。進而推演出一個規則，囊括有各種尺寸的飲料品項的表達。
| 尺寸 | 品項 |
| --------------------- | --------------------- |
| 大杯
中杯
小杯
| 紅茶
奶茶
綠茶
|
而在語言上的寫法就可以透過正規表達式來實現寫出這樣的規則：
> (大|中|小)杯 (紅|奶|綠)茶
### 一般常用場景
正規表達式常被用在蒐集電子郵件、手機號碼、身份證字號或是生日等結構類似的文字表達方面。
> 手機號碼： ^09\d{8}$
>
> 身分證字號：^\[A-Z]\d{9}$
>
> 電子信箱（以 gmail 為例）：^.\*@gmail.com$
>
> 生日：^\d{4}-\d{2}-\d{2}$
### 使用正規表達式的時機
我們在建置聊天機器人時，有時會希望使用者輸入的某些話，可以精確進入某個意圖，進而編寫腳本回應。而這些用語可能展現了特定的文字組合規則，若逐一窮盡舉出，不但耗費時間且有遺漏的可能。
這時，使用正規表達式就是最好的幫手。而常用在建置機器人的情境當中，歸納使用者的話語時，可能想要包括、排除、或是範圍內限定某些表達，例如：要包括特定用詞、排除某種語言、限定第幾個字元為某個字等等。我們在稍後會以 實際範例 來做說明。
### 符碼意義
基本規則：符號是用來限定前面字元允許出現的個數。這邊簡單介紹幾個常用到的表達式符號，更多詳細可以查詢各網站符碼對照表。
| 符號 | 意義 | 舉例 | 表達 |
| -- | -------- | --- | --------------------- |
| . | 任一字元 | . | `你`、`妳`、`我`、`他` |
| \* | 0 個或以上字元 | 你\* | Ø、`你`、`你你`、`你你你` |
| + | 1 個或以上字元 | 你+ | `你`、`你你`、`你你你`、`你你你你` |
| ? | 0 個或 1 個 | 你? | Ø、`你` |
**^** 開頭限定 e.g., ^你好 >>> (符合) `你好` >>> (不符合) ~~`哈囉你好`~~
**$** 結尾限定 e.g., .+吃$ >>> (符合) `我要吃` >>> (不符合) ~~`我吃東西`~~
**|** 或 e.g., 妳|你 >>> `妳`、`你`
**( )** 定義操作符的範圍和優先度 e.g., (你好|你很好) >>> `你好`、`你很好`
\[ **]** 字元集合，`[]`其中任一個字元 e.g., \[你我他] >>> `你`、`我`、`他`
**{ }** 符號數量範圍，`{}`的數字表示限制的數量 e.g., .{2} >>> `妳好`、`哈囉`、`吃飯`、`走路`
**\d** 任一數字 e.g., \d{3} >>> `123`、`333`、`459`
### 情境示例
以服飾電商為情境，我們想訓練一個意圖，知識範圍包含服飾中不同顏色的庫存狀態。
> 對於 `顏色` 和`服飾種類` 的組合有很多種表達：
* 紅色的牛仔褲、藍色的上衣、黃色短褲、綠色薄外套、黃色薄外套、綠色的短褲
不同`顏色`與`服飾種類`的排列組合會有眾多可能，此時就可以利用正規表達式，將所有可能性列出。
| 顏色 | 服飾種類 |
| ----------- | ------------- |
| 紅色、藍色、黃色、綠色 | 牛仔褲、上衣、短褲、薄外套 |
正規表達式可以寫為：
> (紅|藍|黃|綠)色(牛仔褲|短褲|上衣|薄外套)
然而使用者也很可能在字串中間，加入其他的詞來表達，例如 `的`：
* 紅色的上衣、綠色的短褲、紅色的牛仔褲、藍色的上衣、黃色短褲、綠色薄外套、綠色的短褲、深綠色短褲、亮藍色的上衣
在此情況下，正規表達式可寫為：
> (紅|藍|黃|綠)色.?(牛仔褲|短褲|上衣|薄外套)
再更進階一點，我們想要對顏色進行更清楚的描述，例如`淺紅色`、`亮黃`、`深綠`都想要搜尋到，則正規表達式可寫為：
> (淺|亮|深)(紅|藍|黃|綠)色.?(牛仔褲|短褲|上衣|薄外套)
若想抓出搜尋款式樣式的句型，例如：「我要找 OOO 的款式、我想要找 OOO 的樣式的褲子、我想要找 OOO 的樣式的褲子」，正規表達式可寫為：
> ^我(要|想要)找.\*的(款式|樣式)$
### 學習資源
在編寫正規表達式時，除了要熟悉各符號的意義，也需要謹慎確認該表達式是否能正確呈現您想要表達的意思。我們提供幾個網站，供您練習時參考。
* 檢測表達式：[Regex101](https://regex101.com/)
* 檢測表達式：[Regexr](https://regexr.com/)
# 選單
### 說明
在 YOCTOL.AI 左邊功能欄 **`機器人編輯`** 中的 **`選單`**，是指出現在對話視窗下面的常駐選單。可讓您的用戶快速找到機器人的基本功能。
不同通訊軟體的選單，可能有不同的命名，YOCTOL.AI 中以選單稱之。
* 在 Messenger 中稱為 [常設功能表](https://developers.facebook.com/docs/messenger-platform/send-messages/persistent-menu)（Persistent menu）
* 在 LINE 中稱為 [圖文選單](https://developers.line.biz/en/docs/messaging-api/using-rich-menus/)（Rich menu）
### Messenger 常設功能表
Messenger 常設功能表，最多可設定 3 層選單。
**主選單**：可設定 3 格按鈕
* 註：目前 Facebook 已不支援子選單的功能。
### LINE 圖文選單
LINE 圖文選單，有 6 種圖片版型可選擇。
**標題**：YOCTOL.AI 平台顯示的選單名稱\
**選單顯示名稱：** LINE 視窗下方的按鈕顯示文字
# 預設回覆
### 說明
在 YOCTOL.AI **腳本** 中預設的 **`預設回覆節點`** 為平台內建，當顧客輸入的訊息，超過您所設定的所有意圖、節點之觸發條件範圍時，機器人會一律傳送預設回覆。
{% hint style="info" %}
預設回覆為平台內建節點無法刪除，但可以編輯內容或停用。
{% endhint %}
# 歡迎訊息
### 說明
在 YOCTOL.AI **腳本** 中預設的 **`歡迎訊息節點`** 為平台內建，當顧客初次進入對話視窗、或重新開始對話時，機器人會說出的第一句話。
# 轉接真人
### 說明
在 YOCTOL.AI **腳本** 中預設的 **`轉接真人節點`** 為平台內建，由 預設回覆 節點中的按鈕觸發，可以讓顧客在跟機器人對答時切換成真人客服模式，與真人客服對話。詳細設定方式，請參考[設定轉真人客服功能](https://docs.yoctol.ai/settings/switch_to_human)。
{% hint style="info" %}
平台內建節點無法刪除，但可以編輯內容或停用。
{% endhint %}
# 權限管理
您可以邀請他人，共同編輯機器人。
### 說明
一個機器人，可以由多位不同的協作者共同編輯管理。
您可點擊側欄的 **`設定`** > **`權限管理`**，邀請他人加入，或是修改他人的管理權限。
### 權限角色
YOCTOL.AI 包含 4 種權限角色：
* 專案擁有者
* 管理員
* 編輯
* 檢視者
每種權限的特色如下：
