車輛管理局 (DMV) 劇本型預建代理程式可讓使用者在線上續辦駕照，以及預約 DMV 現場辦公室的服務。
對話方塊範例
以下範例對話說明這個預先建構的代理程式處理的常見情境。
更新駕照
使用者要求更新駕照。代理程式會收集必要資訊，包括使用者的駕照號碼、駕照效期、駕照上的姓名和出生日期。然後，服務專員會確認授權是否符合續約資格，並確認使用者是否要繼續進行線上續約。服務專員會建立線上申請，並提供確認號碼。
| 使用者輸入內容 | 服務專員回覆 |
|---|---|
| 您好： | |
| 你好，我是你的車輛管理局助理。我可以協助你線上續辦駕照，以及預約車輛管理局外勤辦公室的服務。今天需要什麼協助呢？ | |
| 我想換發駕照 | |
| 請告訴我最新的駕照號碼。 | |
| 是，是 ABCD1234。 | |
| 謝謝，我們已找到你的商家檔案。請提供執照到期日。 | |
| 09-01-2023 | |
| 請提供執照上的姓名。 | |
| 執照上的姓名是 Jacky Wang | |
| 謝謝！你的出生日期為何？ | |
| 1985-02-03 | |
| 請確認以下資訊： 駕駛人姓名：Jacky Wang 出生日期：1985 年 3 月 2 日 駕照號碼：ABCD1234 有效期限：2023 年 1 月 9 日 |
|
| 沒錯 | |
| 謝謝！我們已驗證你的資訊。你符合線上續訂資格。要線上更新駕照嗎？ | |
| 是 | |
| 你已成功申請換發駕照。確認號碼為 3LKCN0JS。 | |
| 今天還有其他問題需要協助嗎？ | |
| 不用了，謝謝 | |
| 謝謝！祝你有美好的一天。 |
預約
使用者要求預約。專員會收集必要資訊，包括特定 DMV 辦公室、預約日期和時間。與使用者確認收集到的詳細資料後，服務專員會為使用者預約，並提供確認號碼。
| 使用者輸入內容 | 服務專員回覆 |
|---|---|
| 可以幫我預約嗎？ | |
| 我可以協助你預約門診。請提供地址，我會為你搜尋附近的車輛管理局辦公室。 | |
| 是的，是明尼蘇達州第一大街。 | |
| 謝謝！我為你找到以下附近的 DMV 辦公室。請選取一個選項。 1. 明尼蘇達州駕駛人與車輛服務中心：2929 Chicago Ave, Minneapolis, MN 55407 2. Apple Valley DMV：15026 Glazier Ave, Apple Valley, MN 55124 |
|
| 我想前往布魯克林 DMV | |
| 抱歉，我找不到你提供的車輛管理局。請從下列清單中選取： 1. 明尼蘇達州駕駛人與車輛服務 2. Apple Valley DMV |
|
| 然後是 Apple Valley DMV | |
| 你想預約哪一天？我提供下列資訊： 1. 2023 年 12 月 13 日 2. 12-14-2023 3. 2023 年 12 月 15 日 如果這些日期都不適合，請告訴我你偏好的其他日期。 |
|
| 我想在 2023 年 12 月 16 日出發 | |
| 抱歉，我們的辦公室週末不營業。你是否要改為選取下列其中一個日期？ 1. 2023 年 12 月 18 日 2. 12-19-2023 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 預先建構代理程式的程式碼和資料範例，請展開查看操作說明。
- 將預建工具安裝程式下載至本機目錄。
- 前往下載 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 -
部署所有必要服務後，請使用安裝程式記錄的網址，設定預先建構代理程式中的每個工具：
Vertex AI Agent Builder 控制台
- 如果尚未匯入預先建構的代理程式，請將代理程式匯入專案。
- 前往 Vertex AI Agent Builder 控制台。
- 從主控台下拉式選單中選取專案。
- 選取應用程式。
- 按一下「工具」圖示。
-
針對代理程式中的每個工具，編輯結構定義，將
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 工具會擷取可預約的資訊，包括當地辦公室、預約日期和預約時間。選取有效辦公室、日期和時段後，即可使用這項工具預約。
完成
代理程式及其整合功能應已設定完成，可供測試。