在上一篇([09]使用IDialog來實現SoC)介紹了怎麽使用IDialog
來拆分邏輯,并且一步一步的用取得名字的邏輯拆成為一個NameDialog
。
在這一篇我們將會把所有的邏輯重構成爲IDialog,并且對於目前學習到的Bot Builder SDK做一個階段性的總結。
重構剩下來的邏輯
上篇重構完了取得名字的邏輯之後,我們還剩下幾個部分需要重構:
- 查飯店
- 取得訂房的費用明細
- 訂房
重上一篇的重構方式我們可以看出,整個重構的步奏分爲:
- 建立一個Dialog
- 把邏輯從root放到dialog裡面
- 修正root為呼叫dialog來觸發
- 測試
接下來我們就快速看一下這幾個邏輯拆分的程式部分。
查飯店
首先我們建立一個IDialog
叫做SearchHotelDialog。這個SearchHotelDialog
回回傳一個HeroCard
:
[Serializable]
public class SearchHotelDialog : IDialog<HeroCard>
{
public Task StartAsync(IDialogContext context)
{
throw new NotImplementedException();
}
}
在來我們把HeroCard
的產生放在Dialog裡面:
public Task StartAsync(IDialogContext context)
{
// 返回飯店的圖片以及可以打開官網的按鈕
// 建立一個HeroCard
var herocard = new HeroCard()
{
Title = "xxx飯店",
Text = "5星級高級大飯店",
Images = new List<CardImage>()
{
new CardImage("https://cdn.pixabay.com/photo/2016/02/10/13/32/hotel-1191709_1280.jpg")
},
Buttons = new List<CardAction>()
{
new CardAction("openUrl", "官網", value: "http://www.google.com")
}
};
context.Done(herocard);
return Task.CompletedTask;
}
最後我們要在RootDialog
做一些調整:
...
if (activity.Text == "查飯店")
{
context.Call(new SearchHotelDialog(), async (ctx, r) =>
{
var returnMessage = activity.CreateReply();
var heroCardResult = await r;
returnMessage.Attachments = new List<Attachment>(){ heroCardResult.ToAttachment() };
await context.PostAsync(returnMessage);
context.Wait(MessageReceivedAsync);
});
}
...
最後我們測試,發現結果和之前一樣。
取得訂房的費用明細
再來我們重構取得費用明細,先建立一個GetReciptDialog
,這個Dialog會回傳一個Attachment
[Serializable]
public class GetReceiptDialog : IDialog<Attachment>
{
public Task StartAsync(IDialogContext context)
{
throw new NotImplementedException();
}
}
再來把邏輯搬進去:
public Task StartAsync(IDialogContext context)
{
var receiptCard = new ReceiptCard()
{
Title = "訂房費用",
Total = "NT$ 120",
Tax = "NT$ 20",
Items = new List<ReceiptItem>()
{
new ReceiptItem()
{
Title = "1大房",
Price = "90",
Quantity = "1",
Image = new CardImage("https://cdn.pixabay.com/photo/2014/08/11/21/40/wall-416062__180.jpg")
},
new ReceiptItem()
{
Title = "飲料",
Price = "10",
Quantity = "1",
Image = new CardImage("https://cdn.pixabay.com/photo/2014/09/26/19/51/coca-cola-462776_1280.jpg")
}
}
};
context.Done(receiptCard.ToAttachment());
return Task.CompletedTask;
}
ReceiptItem
而是一個Attachment
,因爲Attachment是更加generic的形態,我們剛剛那個查飯店其實應該也要調整,這個我們等一下處理。
接下來我們調整RootDialog
,這邊我們把關鍵字改成明細
比較清楚:
...
else if(activity.Text == "明細")
{
context.Call(new GetReceiptDialog(), async (ctx, r) =>
{
var returnMessage = activity.CreateReply();
var attachmentResult = await r;
returnMessage.Attachments = new List<Attachment>() { attachmentResult };
await context.PostAsync(returnMessage);
context.Wait(MessageReceivedAsync);
});
}
...
接下來測試一下,發現結果一樣。
查飯店v2調整
還記得我們之前爲了顯示AdaptiveCard
有做了一個v2版本的查飯店。
我們把他和SearchHotelDialog
整合,改成一次回傳兩家飯店,一個用HeroCard
,一個用AdaptiveCard
。
首先,我們調整SearchHotelDialog
的回傳内容,從HeroCard
改成List <Attachment>
public class SearchHotelDialog : IDialog<List<Attachment>>
再來調整dialog裡面的邏輯:
public Task StartAsync(IDialogContext context)
{
// 返回飯店的圖片以及可以打開官網的按鈕
// 建立一個HeroCard
HeroCard herocard = GetHeroCard();
AdaptiveCard adCard = GetAdaptiveCard();
context.Done(new List<Attachment>() { herocard.ToAttachment(),
new Attachment()
{
Content = adCard,
ContentType = AdaptiveCard.ContentType
}
});
return Task.CompletedTask;
}
最後調整RootDialog
,把查飯店v2刪掉,然後調整查飯店取得的回傳形態:
if (activity.Text == "查飯店")
{
context.Call(new SearchHotelDialog(), async (ctx, r) =>
{
var returnMessage = activity.CreateReply();
var attachments = await r;
returnMessage.Attachments = attachments;
await context.PostAsync(returnMessage);
context.Wait(MessageReceivedAsync);
});
}
最後,我們可以看到,輸入了查飯店,可以看到兩個版本的飯店:
訂房調整
我們的訂房使用的是FormFlow來產生,這一整個邏輯也可以重構到dialog裡面,做法和其他一樣,先建立一個ReserveRoomDialog
:
[Serializable]
public class ReserveRoomDialog : IDialog<RoomReservation>
{
public Task StartAsync(IDialogContext context)
{
throw new NotImplementedException();
}
}
再來,我們把邏輯放到了Dialog裡面:
public Task StartAsync(IDialogContext context)
{
var reserveRoomForm =
FormDialog.FromForm(RoomReservation.BuildForm,
FormOptions.PromptInStart);
context.Call(reserveRoomForm, AfterReserveRoomAsync);
return Task.CompletedTask;
}
private async Task AfterReserveRoomAsync(IDialogContext context
, IAwaitable<RoomReservation> result)
{
RoomReservation reservation = null;
try
{
reservation = await result;
//await context.PostAsync($"得到的結果:{Environment.NewLine} {JsonConvert.SerializeObject(reservation)}");
}
catch (FormCanceledException<RoomReservation> ex)
{
string reply;
if (ex.InnerException == null)
{
reply = $"您在 {ex.Last} 的時候退出了 -- 如果有遇到任何問題請告訴我們";
}
else
{
reply = "機器人暫時罷工了,請稍後嘗試";
}
await context.PostAsync(reply);
}
finally
{
context.Done(reservation);
}
}
RoomReservation
,因此當使用者退出的時候,直接在這邊輸出内容了。但是,既然回傳的是一個物件,那麽更好的做法應該是一個包含RoomReservation
的物件,裡面有資訊可以記錄
像是退出錯誤的訊息。這個就留給大家嘗試。
最後,調整Rootdialog:
...
else if(activity.Text == "訂房")
{
context.Call(new ReserveRoomDialog(), ReserverRoomAfterAsync);
}
private async Task ReserverRoomAfterAsync(IDialogContext context,
IAwaitable<RoomReservation> result)
{
var roomReserved = await result;
if (roomReserved != null)
{
await context.PostAsync($"您的訂單資訊:{Environment.NewLine}" +
$"{JsonConvert.SerializeObject(roomReserved, Formatting.Indented)}");
}
else
{
await context.PostAsync($"訂單取得失敗");
}
context.Wait(MessageReceivedAsync);
}
訂房
。
内建的Dialog - 範例 Prompt
透過這幾次的重構,相信對於Dialog的建立有了概念,并且這些Dialog是可以簡單重複使用。
這邊舉個簡單例子,内建有個Dialog能夠讓我們方便取得使用者的回復,舉例來説,訂房最後應該有個確認輸入,這個時候我們可以使用内建的Dialog,Prompt
。
private async Task ReserverRoomAfterAsync(IDialogContext context,
IAwaitable<RoomReservation> result)
{
var roomReserved = await result;
if (roomReserved != null)
{
await context.PostAsync($"您的訂單資訊:{Environment.NewLine}" +
$"{JsonConvert.SerializeObject(roomReserved, Formatting.Indented)}");
PromptDialog.Confirm(context, ConfirmReservation, "請確認訂房資訊");
}
else
{
await context.PostAsync($"訂單取得失敗");
context.Wait(MessageReceivedAsync);
}
}
private async Task ConfirmReservation(IDialogContext context, IAwaitable<bool> result)
{
var confirmResult = await result;
if(confirmResult)
{
await context.PostAsync($"訂單完成。訂單號:{DateTime.Now.Ticks}");
}
else
{
await context.PostAsync("訂房取消");
}
context.Wait(MessageReceivedAsync);
}
最後我們看到輸入完表單了之後,會有個確認的訊息:
由這個範例看出,我們可以透過重構IDialog讓我們邏輯能夠重複使用,這樣就不用一直寫這些utility功能。
結語
到目前爲止,我們已經把整個Bot Builder SDK的主要component瞭解的7788了。我們從訊息格式瞭解起,知道用Activity
作爲統一的格式,然後透過Rich Card的輸出内容讓我們可以讓輸出變得更加漂亮。
再來我們看了FormFlow,用它來快速建立表單輸入的方式。
最後介紹了用Dialog來拆分邏輯,并且介紹了其中一個内建的Dialog,PromptDialog
。
Bot Builder SDK還有一些細節,例如透過Scoreable來處理一些特殊關鍵字,不過這個以後有機會在介紹。
對於開發一個Chatbot目前的知識量已經足夠了,并且我們透過這些知識做出了一個訂房的chatbot,接下來我們就可以考慮把他散佈出去讓大家來給我們一些feedback。