透過 DMV Playbook 為基礎的預先建構代理程式，使用者可在線上續發駕照，並預約 DMV 外勤辦公室的預約服務。
對話方塊範例
以下對話方塊範例說明這個預先建構的服務代理處理的常見情境。
更新駕照
使用者要求換發駕照。代理程式會收集必要資訊，包括使用者的駕照號碼、駕照到期日、駕照上的姓名和出生日期。接著，代理人會驗證授權是否符合續約資格，並確認使用者是否要繼續線上續約。服務專員會建立線上申請表，並提供確認號碼。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 您好： | |
| 你好，我是你的 DMV 助理。我可以協助您在線上續發駕照，並預約 DMV 外勤辦公室的預約時間。今天需要什麼協助呢？ | |
| 我想續發駕照 | |
| 請告訴我你最新的駕照號碼。 | |
| 是的，是 ABCD1234。 | |
| 謝謝，我找到你的檔案了。請提供執照到期日。 | |
| 09-01-2023 | |
| 請告訴我駕照上的姓名。 | |
| 執照上的姓名為 Jacky Wang | |
| 謝謝！你的出生日期為何？ | |
| 1985-02-03 | |
| 請問您能否確認以下資訊？ 駕駛員姓名：Jacky Wang 出生日期：02-03-1985 駕駛執照號碼：ABCD1234 到期日：2023-09-01 |
|
| 沒錯 | |
| 謝謝！我已驗證你的資訊。您可以透過線上方式續約。您是否想在線上續發駕照？ | |
| 是 | |
| 您已成功申請駕照換發。你的確認編號為 3LKCN0JS。 | |
| 今天還有其他問題需要協助嗎？ | |
| 不用了，謝謝 | |
| 謝謝！祝您有美好的一天。 |
預約
使用者要求預約。專員會收集必要資訊，包括特定 DMV 辦公室、預約日期和預約時間。與使用者確認收集到的詳細資料後，服務專員會為使用者預約，並提供確認號碼。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 可以幫我預約嗎？ | |
| 我可以協助你預約。能否提供地址，讓我為你搜尋附近的 DMV 辦公室？ | |
| 是的，位於明尼蘇達州的 1st Main Street。 | |
| 謝謝！我為你找到以下附近的 DMV 辦公室。請選取其中一個？ 1. Minnesota Driver & Vehicle Services：2929 Chicago Ave, Minneapolis, MN 55407 2. Apple Valley DMV：15026 Glazier Ave, Apple Valley, MN 55124 |
|
| 我想前往布魯克林 DMV | |
| 很抱歉，我找不到你提供的 DMV。請從下列清單中選取： 1. Minnesota Driver & Vehicle Services 2. Apple Valley DMV |
|
| 然後是 Apple Valley DMV | |
| 你想預約哪一天的服務？我有以下可用資訊： 1. 2023 年 12 月 13 日 2. 2023 年 12 月 14 日 3. 2023 年 12 月 15 日 如果以上日期都不適合，也可以告訴我你偏好的日期。 |
|
| 我希望在 2023 年 12 月 16 日出發 | |
| 很抱歉，我們的辦公室週末不營業。是否要改選下列任一日期？ 1. 2023 年 12 月 18 日 2. 2023 年 12 月 19 日 3. 12-20-2023 |
|
| 2023 年 12 月 19 日 | |
| 謝謝！你想在什麼時候造訪？我有 2023 年 12 月 19 日的空檔時間： 1. 9:30 2. 10:00 3. 11:30 |
|
| 九 | |
| 很抱歉。9:00 無法運作。你想在什麼時候造訪？我有 1。9:30 2. 10:00 3. 11:30 |
|
| 九點三十分 | |
| 請確認是否要預約這個預約： DMV 辦事處：Apple Valley DMV 預約日期：2023 年 12 月 19 日 預約時間：9:30 |
|
| 是的，我可以 | |
| 謝謝！我已預約，你的確認編號為 BNFG987H。 | |
| 今天還有其他問題需要協助嗎？ | |
| 不行 | |
| 感謝您與 DMV 助理聯絡。祝你有愉快的一天！ |
無法辨識的輸入內容
使用者詢問的話題與換發駕照或預約無關。代理人回覆，說明可處理的主題。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 嗨 | |
| 你好，我是你的 DMV 助理。我可以協助您在線上續發駕照，並預約 DMV 外勤辦公室的預約時間。今天需要什麼協助呢？ | |
| 我想買車 | |
| 抱歉，我沒聽清楚。我可以協助你換發駕照或預約。 | |
| 今天需要什麼協助呢？ | |
| 我想預約 | |
| 我可以協助你預約。能否提供地址，讓我為你搜尋附近的 DMV 辦公室？ | |
| 這項服務的費用是多少？ | |
| 很抱歉，我無法判斷預期費用。如需查詢所有服務和費用，請前往當地 DMV 網站。 | |
| 仍要繼續嗎？ | |
| 不，就是這樣 | |
| 今天還有其他問題需要協助嗎？ | |
| 不，那是全部 | |
| 好的，感謝你與 DMV 助理聯絡。祝你有愉快的一天！ |
基本設定
如要設定這個預先建構的代理程式，請按照下列步驟操作：
- 匯入預先建構的代理程式。
- 請使用外部服務設定提供的工具，請參閱工具設定。
工具設定
這個代理程式包含用於整合外部服務的工具。您可以使用預先建構的工具安裝程式，為預先建構的代理程式部署範例程式碼和資料。
如要為 DMV 預先建構的代理程式部署及設定範例程式碼和資料，請展開操作說明。
- 將預建工具安裝程式下載至本機目錄。
- 前往下載 installer.zip 的本機目錄。
- 解壓縮 installer.zip，然後開啟
installer資料夾。 - 請詳閱 README.md，瞭解安裝程式及其需求的詳細總覽。
- 執行
pip install -r requirements.txt以安裝必要條件。 -
執行
gcloud auth application-default login以使用 gcloud auth 進行驗證。 -
使用
python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=dmv執行安裝程式 -
部署所有必要服務後，請使用安裝程式記錄的提供網址，在預先建構的代理程式中設定每個工具：
AI Applications 控制台
- 如果您尚未匯入預先建構的代理程式，請將代理程式匯入專案。
- 前往 AI 應用程式控制台。
- 從控制台下拉式選單中選取專案。
- 選取應用程式。
- 按一下「工具」圖示。
-
針對代理程式中的每個工具，編輯結構定義，將
servers:欄位中的網址替換為安裝程式記錄的端點。 - 按一下 [儲存]。
Dialogflow CX
- 如果您尚未匯入預先建構的代理程式，請將代理程式匯入專案。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 按一下「生成資源」圖示。
- 按一下「工具」。
-
針對代理程式中的每個工具，編輯結構定義，將
servers欄位中的網址替換為安裝程式記錄的端點。 - 按一下 [儲存]。
-
將 Cloud Datastore 使用者角色授予 Compute Engine 服務帳戶 (
your-project-number-developer.gserviceaccount.com)，讓新部署的 Cloud Run 函式能夠存取 Firestore。
更新授權工具
dmv_renew_tool 工具可用於驗證駕照詳細資料，包括駕駛員姓名、出生日期、駕照號碼和到期日。收集並驗證所需資訊後，系統會使用這項工具檢查許可證是否符合續約資格。如果授權符合續約資格，系統就會使用這項工具為使用者提交續約申請。
預約工具
dmv_book_appointment_tool 工具會擷取可用的預約資訊，包括當地辦公室、預約日期和預約時間。選取有效的辦公室、日期和時段後，系統就會使用這項工具來預約。
完成
代理程式及其整合功能現在應已設定完成，可以進行測試。