應對手冊

應對手冊是生成式代理的基本構成要素。生成式代理通常具備多份應對手冊，且每份手冊都有獨立定義，可處理特定工作。提供給 LLM 的教戰手冊資料，可確保 LLM 具備回答問題和執行工作所需的資訊。每個教戰手冊都能提供資訊、傳送查詢至外部服務，或將對話處理作業延遲至流程或其他教戰手冊，以處理子工作。

限制

限制如下：

• 使用 Playbook 的代理不支援從預設起始流程中的預設歡迎意圖路徑傳送通話夥伴簡訊，但您可以在標準流程中啟用通話夥伴簡訊選項。
• Playbook 不支援電話系統的 DTMF 輸入。

語言支援

請參閱語言參考資料中的「Playbooks」欄。標示為 Playbook 的語言已使用 gemini-2.5-flash 模型進行品質測試。

使用英文以外的語言時：

• 在大多數情況下，請使用英文撰寫。對於某些語言和用途，如果額外提供譯文語言的指示，可以稍微提升回覆品質。
• 在教戰手冊指示中宣告支援的語言，例如「一律使用法文回答」。
• 請以譯文語言定義範例。

模型支援

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

• 在代理層級選取 LLM 模型：
  • 在 Conversational Agents 控制台的「Agent setting」(代理設定) >「Generative AI」(生成式 AI) >「Playbook」(應對手冊) 部分，從可用模型清單中選取模型的顯示名稱。
  • 使用 API 更新代理設定時，請在 GenerativeSettings.llm_model_settings.model 欄位中指定模型名稱。請參閱 GenerativeSettings。
• 在要求層級覆寫模型選項：
  • 在 Conversational Agents 控制台模擬器測試 Playbook 時，請從清單中選取模型的顯示名稱。
  • 使用 API 測試代理時，請在 DetectIntentRequest.query_params.llm_model_settings.model 欄位中指定模型名稱。請參閱 DetectIntentRequest。

支援的區域

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 資料

playbook 包含下列資料：

• Playbook 名稱：以自然語言命名的簡潔名稱，可協助開發人員和 LLM 瞭解 Playbook 處理的工作。
• 目標：應對手冊需完成的工作。
• 指令：代理為達成目標必須採取的程序步驟。
• 範例：對話範例，可做為 LLM 的少量樣本提示。
• 參數：儲存對話相關資訊的變數，例如使用者輸入內容、使用者系統資訊和動作結果。

LLM 提示詞

在每個對話回合中，Dialogflow CX 會使用設計階段的 Playbook 資料和執行階段的對話資料，在權杖限制內建立 LLM 提示。

以下清單摘要說明這則提示的內容，其中標題僅供說明，不一定是提示的一部分：

# INTERNAL_SYSTEM_PROMPT
<you cannot see or edit this>

# INTERNAL_SYSTEM_EXAMPLES
<you cannot see or edit this>

# AVAILABLE_TOOLS_TO_CURRENT_PLAYBOOK
<tool names and schemas, for example...>

## Tool: my_datastore
   description: blah
   input: blah
   output: blah

## Tool: some_other_custom_tool
   description: blah
   input: blah
   output: blah

# PLAYBOOK
<verbatim Goal and Instructions that you provide in the console>

# PLAYBOOK_EXAMPLES
<as many Examples for the current Playbook as can fit in the prompt>

## Example 1

## Example 2
..
..
..
## Example N (up to the input token limit)

# CURRENT_CONVERSATION
<the conversation up to this point w/ some caveats...>

* Caveat 1: If there was a transition from Playbook A -> Playbook B, the
  Conversation that happened in Playbook A is summarized and provided as context
* Caveat 2: If there was a transition from Flow A -> Playbook A, the
  Conversation that happened prior to the entry of Playbook A is summarized and
  provided to the Playbook

應對手冊類型

建立應對手冊時，請選取類型：工作應對手冊或例行程序應對手冊。

工作應對手冊

工作應對手冊是原始的應對手冊類型，您可以將複雜任務拆解為可重複使用的小型子任務，並建立組合對話階段，每個階段都會透過輸入和輸出參數彼此通訊。

任務應對手冊 (呼叫者) 呼叫另一個任務應對手冊 (受呼叫者)：

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

任何例行程序或工作應對手冊都可以呼叫其他工作應對手冊，但工作應對手冊無法呼叫其他例行程序應對手冊。

例行程序應對手冊

例行程序應對手冊是近期推出的應對手冊類型，這類應對手冊用於建立循序對話階段模型，且每一階段都是完整的獨立元件。例行程序應對手冊可呼叫工作應對手冊，將大型任務拆解為小型的子任務，也可以轉換為其他例行程序應對手冊或流程。

下列清單顯示例行程序應對手冊 A 轉換至例行程序應對手冊 B，然後轉換至流程 C：

1. 例行程序應對手冊 A 會在啟動時讀取工作階段參數，並在退出前寫入工作階段參數。
2. 例行程序應對手冊 A 結束，並轉換至例行程序應對手冊 B。
3. 例行程序應對手冊 B 會在啟動時讀取工作階段參數，並在結束前寫入工作階段參數。
4. 例行程序應對手冊 B 結束，並轉換至流程 C。
5. 流程 C 會讀取及寫入工作階段參數。

如果例行程序應對手冊未轉換至其他例行程序應對手冊或流程，工作階段會返回上次使用的流程，如果沒有，則會結束。

例行程序應對手冊的參數管理行為如下：

• 進入例行程序應對手冊後，系統會為輸入參數指派值，這些值與同名的工作階段參數相同。
• 例行程序應對手冊結束時，會產生輸出參數的值，並指派給同名的工作階段參數。

比較教戰手冊類型

預設教戰手冊

使用 Conversational Agents 控制台建立生成式代理時，Dialogflow CX 會自動建立預設生成式代理應對手冊。

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

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

建立應對手冊

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

1. 在控制台的導覽選單中，按一下「Playbook」圖示。
2. 點選「建立」。
3. 選取「例行」或「任務」應對手冊類型。
4. 提供教戰手冊資料。

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

建立應對手冊時，生成式 AI 面板會開啟。這樣就能生成應對手冊資料。

匯入及匯出自動化動作

使用 Conversational Agents 控制台建立 Playbook 後，可以匯出這些 Playbook，用於其他代理。

如要匯出：

1. 前往應對手冊清單。
2. 選取要匯出的應對手冊，然後選取「匯出」。
3. 選取匯出選項，然後按一下「匯出」。

如要匯入先前匯出的應對手冊，請按照下列步驟操作：

1. 前往應對手冊清單。
2. 選取要匯入的應對手冊，然後選取「匯入」。
3. 選取匯入選項，然後按一下「匯入」。