# 疑難雜症

## 銜接的腳本沒有反應

當您的腳本在與指定管道關聯後未能正常反應，這可能是由於腳本設計或設置中存在一些常見問題。以下是主要原因及其相應的解決方法：

1. **腳本未啟用**：如果腳本處於未啟用狀態，即使與管道成功關聯，也不會在觸發時執行任何操作，導致流程被直接終止。
2. **子腳本開頭設置為「事件」**：子腳本如果以「事件」作為開頭，則該腳本需要在接收到用戶的訊息或滿足其他指定事件條件後才能繼續進行。如果在期望的互動中沒有發生這些事件，腳本則不會自動執行下一步。

***

## 腳本未如預期設計的流程前進

如果您的腳本無法按照預期流程前進，可以確認一下幾點：

### 在事件同層第一個事件使用了 \* 萬用字元

如果在同一層的事件判斷中，第一個事件或判斷節點使用了萬用字元「\*」，這樣顧客的任何訊息將立即符合，並前往第一個流程支線。這可能導致後續的其他關鍵字判斷失效，您需要調整判斷節點的左右位置。

<figure><img src="/files/3SNtUPRphJvrN8yxexTL" alt=""><figcaption></figcaption></figure>

### 不同類型節點置放於同層

當不同類型的節點放置在同一層級時，例如「事件」和「條件」在同一層判斷，同層後續的不同類型節點將不會被執行。

<figure><img src="/files/zFwShEUQN0qaYaiptlME" alt=""><figcaption></figcaption></figure>

### **是否有例外處理**

有些客戶可能會自行輸入文字而非按照介面提供的選項進行操作。為了處理這種情況，您可以在同一層級節點後添加關鍵字「\*」來模糊判斷處理。

<figure><img src="/files/X4UmGj92m1gXJykMUuWC" alt=""><figcaption></figcaption></figure>

### 判斷條件有遺漏

若您透過關鍵字判斷流程走向，建議檢查關鍵字是否有遺漏。例如，當您設定關鍵字為「A」，但客戶未如您預期發送「B」，可能需要檢查是否需要加入更多關鍵字，或者使用其他判斷方式來處理未知的情況。

<figure><img src="/files/4kJWsNets0ttzIyXFndE" alt=""><figcaption></figcaption></figure>

### 腳本超過 100 個節點上限

為了避免設計冗長的流程，造成用戶體驗不佳與難以管理，單一腳本有節點上限。當您的設計需要超過上限時，建議您使用第三方整合 (例如 API) 或者重新規劃並拆分成子腳本、模組等方式，以設計更簡化易用的流程。這樣您與您的客戶可以更快速地獲得所需的資訊。

***

## 如何匯入其他環境設計的腳本

若您希望匯入從其他 FIRST LIN 系統環境設計的機器人腳本，請前往特定的腳本並切換至「編輯模式」。在介面工具列上方，您將看到一個筆記圖示。點擊該圖示後，您可以選擇其他環境所設計的 JSON 檔案。選擇完畢後，請點擊「匯入」按鈕，系統將自動匯入您選擇的腳本設計。这樣的功能讓您能夠輕鬆地將來自其他系統的腳本內容匯入到我們的系統中，提高了工作效率和便利性。

<figure><img src="/files/vCeCNchFWvonj0PFBG6m" alt=""><figcaption></figcaption></figure>

***

## 如何驗證測試腳本

進行簡單的除錯時，您可以遵循以下步驟：

1. **精簡流程範圍：** 當懷疑節點或流程存在問題時，將流程範圍簡化到可能的範圍。例如，新增一個僅包含 3 - 4 個節點的測試腳本，而不是包含過多節點。這有助於驗證是否符合所需的支援，同時降低複雜度。
2. **逐步測試：** 逐步添加節點並測試，觀察每一步的行為。這有助於確定問題出現的具體位置，並快速找到可能的原因。
3. **記錄輸入和輸出：** 在進行測試時，詳細記錄每個節點的輸入和輸出，例如您可以穿插「筆記」節點，這能夠幫助您追蹤流程，找到可能的錯誤源。

***

## 常見提醒訊息

### The selected scenario id is invalid

當您看到「The selected scenario id is invalid」的錯誤訊息時，這表示在腳本流程中，您可能使用了「前往其他腳本」等節點功能，但該節點所關聯的子腳本已被刪除，導致無法正確連接相應的腳本。

為了解決這個問題，您需要檢查腳本流程，確保所有的節點和子腳本都正確關聯並存在。如果您確定某個子腳本已被刪除，則需要更新相應的節點，以連接到有效的子腳本或刪除無效的節點。

### The selected text conv event id is invalid.

當您看到「The selected text conv event id is invalid.」的錯誤訊息時，這表示在腳本流程中，您可能使用了「流程追蹤」等節點功能，但該節點所關聯的事件已被刪除，導致無法正確連結。

為了解決這個問題，您需要檢查腳本流程，確保所有的節點和事件都正確存在。如果您確定某個事件已被刪除，則需要更新相應的節點，以連結到有效的事件或刪除無效的節點。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.firstline.cc/feature/chatbot/scenario/yi-nan-za-zheng.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
