應對手冊

應對手冊是生成式代理程式的基本構成元素。生成式代理通常具備多份應對手冊，且每份手冊都有獨立定義，可處理特定工作。系統會將劇本資料提供給 LLM，讓 LLM 取得回答問題和執行工作所需的資訊。每個劇本都可以提供資訊、向外部服務傳送查詢，或將對話處理作業延後至「流程」或另一個劇本，以處理子工作。

限制

限制如下：

• 使用應對手冊的代理無法從 Default Start Flow 的 Default Welcome Intent 路線傳送通話助手簡訊，但您可以在標準流程中啟用通話助手簡訊選項。
• 劇本不支援電話系統的 DTMF 輸入。

語言支援

請參閱語言參考資料中的「劇本」欄。已使用 gemini-2.0-flash 模型測試劇本中標示語言的品質。

使用英文以外的語言時：

• 在大多數情況下，請使用英文版劇本說明。對於特定語言和用途，如果額外提供目標語言的指令，可能會獲得稍微更好的回覆。
• 在劇本說明中宣告語言支援。 例如：「請一律使用法文回答」。
• 以目標語言定義範例。

支援的機型

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

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

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

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

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

支援的區域

應對手冊支援下列地區：

• 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

應對手冊資料

劇本包含下列資料：

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

LLM 提示詞

在每個對話回合中，Dialogflow CX 會使用設計階段的劇本資料和執行階段的對話資料，在權杖限制內建立大型語言模型提示。以下是這項提示的內容摘要，標題僅供說明，不一定屬於提示內容。

# 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 控制台建立生成式代理時，系統會自動建立預設生成式應對手冊。

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

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

建立應對手冊

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

1. 按一下主控台左側導覽列中的劇本圖示。
2. 按一下「建立新項目」按鈕。
3. 選取「例行」或「任務」應對手冊類型。
4. 提供應對手冊資料。

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

建立應對手冊時，系統會開啟生成式 AI 面板。系統會根據提示生成應對手冊資料。

匯入及匯出劇本

使用 Conversational Agents 控制台建立劇本後，即可匯出這些劇本，用於其他代理。如要匯出應對手冊，請按照下列步驟操作：

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

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

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