Playbooks

應對手冊是生成式代理程式的基本構成元素。生成式代理程式通常會有許多應對手冊，每個應對手冊都會定義為處理特定工作。劇本資料會提供給 LLM，讓 LLM 取得回答問題和執行工作所需的資訊。每個 Playbook 都能提供資訊、向外部服務傳送查詢，或將對話處理作業延後至流程或其他 Playbook，以便處理子工作。

限制

限制如下：

• 使用 Playbook 的服務專員無法透過預設開始流程中的預設歡迎意圖路徑傳送通話伴隨訊息簡訊，但您可以在標準流程中啟用通話伴隨訊息選項。
• Playbook 不支援電話系統的 DTMF 輸入。

語言支援

請參閱語言參考資料中的「Playbooks」欄。標示為 Playbook 的語言，已透過 gemini-2.0-flash 和 gemini-1.5-flash-002 模型進行品質測試。

如果使用英文以外的語言，請以目標語言定義範例，但操作說明請以英文呈現。針對某些語言和用途，如果您另外提供目標語言的操作說明，可能會獲得稍微更佳的回應。

模型支援

您可以在下列位置選取在 Playbook 中使用的 LLM 模型：

• 在代理程式層級選取 LLM 模型。

  • 在 Conversational Agents 控制台的「Agent」設定 ->「生成式 AI」->「Playbook」中，從所有可用模型的下拉式選單中，依顯示名稱選取模型。
  • 如果您使用 API 更新代理程式設定，請在 GenerativeSettings.llm_model_settings.model 欄位中指定模型名稱 (請參閱 GenerativeSettings)。

• 在要求層級覆寫模型選取作業。

  • 在 Conversational Agents 控制台模擬器中，測試 Playbook 時，請從下拉式選單中依顯示名稱選取模型。
  • 如果您是透過 API 測試介面代理程式 (請參閱「DetectIntentRequest」)，請在 DetectIntentRequest.query_params.llm_model_settings.model 欄位中指定模型名稱。

模型名稱	型號顯示名稱	模型規格	推出階段	可用區域
gemini-pro	gemini-1.0-pro-001	Gemini 1.0 Pro	正式發布版	所有 Playbook 區域
gemini-1.5-flash	gemini-1.5-flash-001	Gemini 1.5 Flash	正式發布版	所有 Playbook 區域
gemini-1.5-flash-002	gemini-1.5-flash-002	Gemini 1.5 Flash 002	公開預先發布版	所有 Playbook 區域
gemini-2.0-flash-001	gemini-2.0-flash-001	Gemini 2.0 Flash	正式發布版	所有 Playbook 區域
gemini-2.0-flash-lite-001	gemini-2.0-flash-lite-001	Gemini 2.0 Flash Lite	公開預先發布版	所有 Playbook 區域

支援的區域

應對手冊支援下列地區：

• global
• asia-south1
• asia-southeast1
• asia-southeast2
• asia-northeast1
• australia-southeast1
• eu (多地區)
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• northamerica-northeast1
• us (多地區)
• us-central1
• us-east1
• us-west1

應對手冊資料

Playbook 包含下列資料：

• 教戰手冊名稱：以自然語言撰寫的簡明名稱，可協助開發人員和 LLM 瞭解教戰手冊處理的任務
• 目標：概略說明應對手冊應達成的目標
• 操作說明：定義達成目標所需的程序步驟
• 範例：有效的少量樣本提示範例對話
• 參數：用於儲存對話內容的相關資訊，例如使用者輸入內容、使用者系統資訊、動作結果等等。

應對手冊類型

建立手冊時，請選取所需的手冊類型：工作手冊或日常手冊。

工作教戰手冊

工作手冊是原始型別的手冊。可用於將複雜的工作拆解為較小且可重複使用的子工作。這些結構會用於模擬組合式對話階段，每個階段都會透過輸入和輸出參數進行通訊。

以下是工作劇本 (呼叫端) 呼叫其他工作劇本 (被呼叫端) 的示例：

1. 呼叫端啟動被叫端。
2. 呼叫端會向被叫端提供必要的輸入參數。
3. 被呼叫端會處理這項資訊、執行指定的函式，並傳回輸出參數。
4. 呼叫端會從被呼叫端接收參數。

任何日常或工作手冊都能呼叫其他工作手冊，但工作手冊無法呼叫其他日常手冊。

日常安排應對手冊

例行應對手冊是一種新類型的應對手冊。這些元素用於模擬連續對話階段，每個階段都完整且獨立。這些程式可呼叫工作手冊，將較大的工作分解為較小的子工作，並轉換為其他例行手冊或流程。

以下是例行作業劇本 (A)、轉換至其他例行作業劇本 (B)、轉換至流程 (C) 的示意圖：

1. 日常安排指南 A 可以在啟動時讀取工作階段參數，並在結束前寫入工作階段參數。
2. 日常安排手冊 A 會結束並轉換至日常安排手冊 B。
3. 日常安排指南 B 可以在啟動時讀取工作階段參數，並在結束前寫入工作階段參數。
4. 日常安排 Playbook B 會結束並轉換至流程 C。
5. Flow C 可讀取及寫入工作階段參數。

如果例行應對手冊不會轉換至其他例行應對手冊或流程，則會返回上一個有效流程，如果沒有則會結束。

例行工作手冊的參數管理行為如下：

• 輸入例行作業劇本時，系統會為其輸入參數指派值，這些值與同名的工作階段參數相同。
• 例行程式劇本結束時，會為其輸出參數產生值，並將這些值指派給同名的工作階段參數。

預設教戰手冊

使用對話型代理控制台建立生成式代理時，系統會自動建立預設生成式應對手冊。

預設應對手冊是對話的起點，因此與其他應對手冊有幾項重要差異：

• 預設劇本不會收到先前對話輪次的摘要。
• 預設的應對手冊無法定義或接收輸入參數。

建立應對手冊

如要建立應對手冊，請按照下列步驟操作：

1. 按一下主控台左側導覽面板中的 Playbook 圖示。
2. 按一下「建立新」按鈕。
3. 選取「日常安排」或「工作」應對手冊類型。
4. 提供 Playbook 資料。

使用 AI 生成功能建立應對手冊

建立應對手冊時，系統會開啟生成式 AI 面板。您可以使用這個方法產生應對手冊資料。

匯入及匯出 Playbook

使用 Conversational Agents 控制台建立 Playbook 後，您可以匯出這些 Playbook，以便在其他代理程式中使用。如何匯出應對手冊：

1. 前往應對手冊清單。
2. 按一下要匯出的劇本集的匯出按鈕。
3. 選取匯出選項。
4. 按一下 [匯出]。

如要匯入先前匯出的 playbook，請按照下列步驟操作：

1. 前往應對手冊清單。
2. 按一下「匯入」。
3. 選取匯入選項。
4. 按一下「匯入」。