車輛管理局 (DMV) 劇本型預建代理程式可讓使用者在線上續辦駕照，以及在 DMV 現場辦公室預約服務。
對話範例
下列範例對話說明這個預先建構的代理程式處理的常見情境。
更新駕照
使用者要求更新駕照。代理程式會收集必要資訊，包括使用者的駕照號碼、駕照效期、駕照上的姓名和出生日期。然後，服務專員會確認授權是否符合續約資格，並確認使用者是否要繼續進行線上續約。服務專員會建立線上申請，並提供確認號碼。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 您好： | |
| 你好，我是你的 DMV 助理。我可以協助你線上續辦駕照，以及預約車輛管理局 (DMV) 辦公室的服務。今天需要什麼協助呢？ | |
| 我想換發駕照 | |
| 請告訴我最新的駕照號碼。 | |
| 是，代碼為 ABCD1234。 | |
| 謝謝，我們已找到你的個人資料。請提供執照到期日。 | |
| 09-01-2023 | |
| 請提供執照上的姓名。 | |
| 執照上的姓名為 Jacky Wang | |
| 謝謝！你的出生日期為何？ | |
| 1985-02-03 | |
| 請確認以下資訊： 駕駛人姓名：Jacky Wang 出生日期：1985 年 3 月 2 日 駕照號碼：ABCD1234 有效期限：2023 年 9 月 1 日 |
|
| 沒錯 | |
| 謝謝！我們已驗證你的資訊。你符合線上續訂資格。要線上更新駕照嗎？ | |
| 是 | |
| 你已成功申請換發駕照。確認編號為 3LKCN0JS。 | |
| 還需要其他協助嗎？ | |
| 不用了，謝謝 | |
| 謝謝！祝你有美好的一天。 |
預約
使用者要求預約。專員會收集必要資訊，包括特定 DMV 辦公室、預約日期和預約時間。與使用者確認收集到的詳細資料後，服務專員會為使用者預約，並提供確認號碼。
| 使用者輸入內容 | 代理回覆 |
|---|---|
| 可以幫我預約嗎？ | |
| 我可以協助你預約。請提供地址，我會為你搜尋附近的車輛管理局辦公室。 | |
| 是的，是明尼蘇達州第一大街。 | |
| 謝謝！我為你找到以下附近的 DMV 辦公室。請選取其中一個選項。 1. 明尼蘇達州駕駛人與車輛服務中心：2929 Chicago Ave, Minneapolis, MN 55407 2. Apple Valley DMV：15026 Glazier Ave, Apple Valley, MN 55124 |
|
| 我想前往布魯克林 DMV | |
| 很抱歉，我找不到你提供的 DMV。請從清單中選取： 1. 明尼蘇達州駕駛人與車輛服務 2. Apple Valley DMV |
|
| 然後是 Apple Valley DMV | |
| 你想預約哪一天？我已準備好下列資訊： 1. 2023 年 12 月 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 |
|
| nine | |
| 很抱歉，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 -
部署所有必要服務後，請使用安裝程式記錄的網址，在預先建構的代理程式中設定各項工具：
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 工具會擷取可預約的資訊，包括當地辦公室、預約日期和時間。選取有效辦公室、日期和時段後，即可使用這項工具預約。
完成
代理程式及其整合功能應已設定完成，可開始測試。