在 AI Agents (Cognigy) 中新增檢索知識節點

AI Agents (Cognigy) 流量中的節點代表您的虛擬客服所執行的動作或邏輯。編輯節點可讓您設定其屬性、更新參數或調整其在流量中的行為。

檢索知識節點讓AI Agents (Cognigy)能夠在互動期間,從已連接的知識來源(例如Knowledge Hub)擷取相關資訊。它會處理使用者的查詢,搜尋已設定的知識庫,並傳回最相關的內容,以產生准確且具上下文感知的回應。

對於指定的流量,您只能設定一個檢索知識節點,該節點只能連結至單一Knowledge Hub知識庫。目前不支援在同一流量中設定多個知識節點。

啟動 AI Agents (Cognigy) 到 NiCE CXone

  1. 按一下應用程式選擇器 Icon of three-by-three grid of white squares on a blue background,前往 General,然後選取 Automation。

  2. 在自動化內,選取Cognigy AI。

在 AI Agents (Cognigy) 新增檢索知識節點

  1. 在AI Agents (Cognigy)中,選擇Build > 流程。

  2. 從清單中,選取您要編輯的流量,例如,SayHelloAndHandover。

  3. 如果計劃包含多個流量,請在頂部的流量選擇器中選取主要流量。流量會在Chart檢視中開啟,您可以在此新增及設定節點。

  4. 在流量編輯器中,按一下應新增檢索知識節點的位置的加號 (+) 圖示。

  5. 選取按函數分頁 > CXone類別 > 檢索知識。節點會新增至您的流量中。

  6. 按一下節點以在右側開啟編輯節點面板。

  7. 《編輯節點》面板會顯示特定節點類型的可配置欄位。 Let me verify the format with placeholders: Edit Node 《編輯節點》面板會顯示特定節點類型的可配置欄位。

  8. 對於檢索知識節點,您會看到以下欄位:

欄位名稱

定義

備註

Knowledgehub ID 選取您想要整合的知識庫。

下拉式名單列出了在Knowledge Hub中設定的知識庫。

回應類型 節點返回的內容:

答案:Knowledge Hub 會使用「KB Answers」部分中的設定,從知識庫產生答案。區塊:Knowledge Hub 會從知識庫傳回最相關的內容區塊,而不產生答案。每個區塊均包含其文字、來源 URI、相關度分數及引用中繼資料。當您希望AI客服專員的 LLM 根據來源內容產生回應時,請使用此選項。

保留 Answer 和 Chunks 的描述。新增預設值為 Answer 的說明。新增當選取 Chunks 時,KB Answers 設定中的查詢角色、Prompt 和 Model ARN 不適用的說明。

輸入查詢 表示最終使用者的問題,將用於在知識庫中搜尋答案。
查詢
查詢角色 描述您希望 AI 在生成摘要時採用的角色。 如果您正在使用 Prompt 編輯,並已設定提示管理器設定檔 ID,請勿使用此欄位,因為提示管理器中已經設有角色(persona)設定。
查詢語言 選取生成摘要所使用的語言。此設定僅影響輸出的語言。

選擇您想要 LLM 回應所使用的語言。

用於選取LLM回應所用語言的查詢語言欄位

Knowledge Hub
篩選器 指定標準,以根據其中繼資料選擇應包含在Knowledge Hub中的知識文章。

定義以 JSON 為基礎的擷取篩選器,套用屬性條件以限制所傳回的文件,支援單一條件及使用 andAll/orAll 的巢狀邏輯群組。支援多個運算子(等於、notEquals、數值比較、in/notIn、startsWith),適用於字串、數字及布爾屬性,讓您可以建立簡單或複雜的篩選器,例如,

{
"equals":
{
"key":"PageRestriction",
"value":"Public"
}
}

有關詳細資料,請參閱篩選器運算子部分。

最大文章數 定義為產生回應而從知識庫檢索文章的最大數量。  
Prompt 建立自訂提示以控制語氣並為您的知識庫提供上下文。如果您正在使用 Prompt 編輯,並已設定「提示管理器設定檔 ID」,請勿使用此欄位。  
Model ARN 選取要用於生成知識回應的LLM模型。

可用選項為amazon.nova-pro-v1:0、amazon.nova-lite-v1:0及anthropic.claude-haiku-4-5-20251001-v1:0。

如果您使用提示管理器ID,則無需在此欄位中填寫Model ARN,因為提示管理器已選取以下模型:

  • Nova Pro

  • Nova Lite

  • Claude 4.5 Haiku

  • Claude 3.5 Haiku

知識庫答案
提示管理器設定檔 ID 從 AI Studio 的提示管理器輸入設定檔 ID。這樣您便可以直接在提示管理器內管理及編輯您的提示。
  1. 導覽至 AI Studio > GenAI Prompts。

  2. Open Copilot for Agents > 知識庫答案.

  3. 請在適當的 KB Answer prompt 設定檔旁,選取更多操作 More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point 圖示。

  4. 從選單中選擇Copy ID。

答案的最大詞語數 設定產生的知識回應的最大length。  
最大連結 設定生成回應中要包含的引文連結的最大數量。  
結果儲存
結果儲存 指定擷取的內容應儲存的位置。
變數名稱 Enter 已儲存內容將儲存至其中的變數名稱。

LLM 回應會儲存在此變數中,而這些值會根據螢幕截圖所示的配置顯示在聊天中。

Say 節點:

「擷取知識」節點設定中的「輸出類型」設定

錯誤處理
記錄至系統 啟用將錯誤記錄到系統日誌。 日誌可於您「計劃」的日誌頁上檢視。此參數預設為非活躍。
選取錯誤處理方法 定義在請求期間發生的錯誤應如何處理。

根據您的需求,您可以選擇以下其中一個錯誤處理選項:

  • 停止流量執行:終止目前的流量執行。

  • 繼續流量執行:允許流量繼續執行,略過錯誤並繼續進行下一步。

  • 前往節點:將工作流程重新導向流量中的特定節點,這對於錯誤復原或自訂錯誤處理十分有用。

錯誤訊息(可选) Enter一個自訂訊息,以在發生錯誤時顯示。此欄位為可選。 當繼續流量執行選項位於選取錯誤處理方式中被選取時,此參數會啟用。若知識擷取失敗,則為可选輸出的訊息。
偵錯設定
偵錯設定 基於效能考量,偵錯記錄僅於從互動面板進行測試,且其中已啟用偵錯模式時才會啟用。  
記錄請求正文 啟用或停用傳送至 Knowledge Hub 的請求正文的記錄功能。  
記錄請求 啟用或停用記錄請求完成所需的已使用時間。  
延遲 模擬 輸入在為此節點啟用模擬時所要使用的模擬代碼。 Mocking 可讓您在不更改原有節點設定的情況下,透過以模擬代碼取代其邏輯來更改節點的行為。此方法可讓您保留原有的流量邏輯,並模擬節點行為,以在 Simulator、Interaction Panel 及 Endpoints 中測試特定的流量條件,而不需重新設定節點。 Mocking 在編輯中每個節點的設定內提供 Mock Code 欄位。此欄位支援 JavaScript 代碼,以存取 Input、Context 及 Profile 物件,以及 api.say 函數。模擬代碼會在運行時完全覆寫已設定節點的執行邏輯。 如需詳細資料,請參閱Mocking主題。
設定
標籤 定義節點的自訂名稱。  
備註 免費文字欄位。  
Analytics 步驟 \n\n\n\n一旦節點通過,步驟便會記錄在 Cognigy Insights 及 Cognigy.AI OData 終點中  

在編輯節點面板中管理節點選項

使用更多選項 More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point 選單,在編輯節點面板中對節點執行其他動作。這些動作可協助您複製識別碼、管理節點狀態,或設定流量的起始點。

節點 ID 複製

複製節點的唯一 identifier,以供 API 呼叫或偵錯時使用。

  1. 在「編輯節點」面板中,選取您想要的節點。

  2. 按一下 More options 可開啟選單的「更多選項」圖示,該選單包含針對所選項目的其他操作,例如複製 ID、刪除、停用或設為進入點 圖示。

  3. 選取 複製節點 ID。

    節點 ID 已複製到您的剪貼簿。

刪除節點

永久地將節點從流量中移除。

  1. 在「編輯節點」面板中,選取您要刪除的節點。

  2. 按一下更多選項 More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point 圖示。

  3. 選擇刪除。

    出現提示時,請確認刪除。

    刪除節點後將無法還原,如有需要,請重新建立節點。

停用節點

暫時停用節點而不將其從流量中移除。

  1. 在編輯節點面板中,選取您要停用的節點。

  2. 按一下更多選項 More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point 圖示。

  3. 選取停用。

    節點將保留在流量中,但在您再次啟用它之前不會執行。

將節點設為入口點

將一個節點定義為流量的起始點。

  1. 在編輯節點面板中,選取您要設為進入點的節點。

  2. 按一下 更多選項 More options icon that opens a menu with additional actions for the selected item, such as copy ID, delete, disable, or set as entry point 圖示。

  3. 選取Set Entrypoint。

    流量將會從這個節點開始,而不是預設的開始節點。

篩選器運算子

本部分涵蓋單個及多個運算符的通用語法:

  • 單一條件

{"<operator>": {
"key": "<metadata-key>",
"value": <value>
}
}
  • 多個條件 — AND(全部必須匹配)

{
"andAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
  • 多個條件 — OR(符合任何一項即可)

{
"orAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
  • 巢狀 — AND 內含 OR(複雜邏輯)

{
"andAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{
"orAll": [
{ "<operator>": { "key": "<metadata-key>", "value": <value> } },
{ "<operator>": { "key": "<metadata-key>", "value": <value> } }
]
}
]
}
  • 有效運算子 — 將 <operator> 取代為以下其中一個:

Console 符號

API 篩選器名稱 (<operator>)

Supported Data Type

淺白英文

=

等於 字串、數字、布爾 是完全等於

!=

notEquals 字串、Number、布爾 不等於

^

startsWith 字串、Number、布爾 開頭與

>

大於 數字 大於

>=

大於或等於 數字 大於或等於

<

小於 數字 小於

<=

小於或等於 數字 小於或等於

:

在 字串清單 是清單中的其中一項

!:

notIn 字串列表 不屬於清單中的任何一項
  • 替換參考

預留位置 取代與

<operator>

上表中的任何API篩選器名稱

<metadata-key>

Uri、標題、PageRestriction、標記等(區分大小寫)

<value>(字串)

"公共"

<值>(數字)

2023

<value>(布爾)

true 或 false

<value>(字串清單)

["value1", "value2"] — 僅適用於 in 及 notIn
  • <metadata-key>:在 Knowledge Hub 中定義。此值可能因 KMS 連接器而異。

  • <Value>:必須與 KMS 發送的值相符。

andAll 和 orAll 在陣列內最少需要兩個條件。

  • 有效運算子參考

API 篩選器名稱

(<operator>)

支援的資料類型 含義

equals

字串、數字、布爾 是等於

不等於

字串、數字、布爾 不等於

startsWith

字串、數字、布爾 開始與

大於

數字 大於

大於或等於

數字

大於或等於

less than

數字 小於

小於或等於

數字 小於或等於

在

字串清單 是清單中的其中一項

notIn

字串清單 是清單中沒有的其中一項