---
title: 機器人階段
slug: neurons/help/zh_tw/2VbQSs9fWcU_3IFjy-Ujz
createdAt: 2026-09-07T08:18:41.274Z
---

階段用於建置機器人。 在[機器人編輯器](https://docs.ivanti.com/neurons/help/zh_tw/j6wtYg3g8YitQOoh1j-_F)頁面上，將階段拖曳到工作區域。 階段設定面板顯示，供您定義動作或查詢的設定。 階段必須連線 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/ThinP_XzVxTCGGrO8G1Nj_bots-stageconnect.png" alt="階段連接器圖示" caption size="10" width="27" height="25"} 才能在機器人中建立工作流程，請參閱[連線設定](https://docs.ivanti.com/neurons/help/zh_tw/j6wtYg3g8YitQOoh1j-_F#Connecti)。 您可以從階段類別選取一個階段。 您還可以建立[自訂階段](https://docs.ivanti.com/neurons/help/zh_tw/byn_2OhEACFR5KynsAeOi)和[使用者階段](https://docs.ivanti.com/neurons/help/zh_tw/_vFkwzxIwdBBZK95ml9qf)以與機器人一起使用。

## 階段類別

:::hint{type="success"}
下方的概觀並不會列出每個單獨的階段。 列出的階段可能不適用於每個組態路徑。
:::

::::ExpandableHeading
## 查詢

用於顯示和篩選滿足指定條件的裝置資訊。 此查詢階段的輸出和內容可在機器人內傳遞給後續階段。
例如，顯示可用磁碟空間低於 10% 的裝置。

- **Teams 通話品質階段**: Teams 通話品質階段取得目標裝置或使用者帶品質資訊的通話記錄。 它會在現場會議之前或期間評估網路效能、裝置相容性和整體通話體驗，幫助識別潛在問題。
  要設定 Teams 通話品質階段:
  1. 選取 **Teams 通話品質階段**並前往**階段設定**。
  2. 在**選取憑證的連接器**欄位中，使用下拉式功能表選取連接器以連線 Microsoft Entra ID。
  3. **開始日期**和**結束日期**是選用欄位；您可以選取自訂值或現在的日期選項。 如果選取自訂值選項，請輸入該值，如果現在選取日期，請切換**將時間新增至日期**以輸入**時間單位**和**持續時間**。

     :::hint{type="info"}
     這將擷取過去 30 天的資料，每個使用者最多 60 次通話。
     :::
- **清單查詢**: 此階段根據使用者選取的篩選器和欄從清單擷取值，之後可在機器人工作流程中使用。 可擷取的屬性僅限於具有單一值 (1:1 關係) 的屬性；不支援以陣列為基礎的屬性。
  此階段存在於所有機器人內容中，裝置和人員清單的**通用**內容中也提供專用階段。

:::hint{type="info"}
使用「至人員內容」或「至裝置內容」階段時，若未在階段內提出正確的庫存查詢，將導致「無效的內容」錯誤。
:::

- **清單查詢 (進階)**: 此階段的運作方式與庫存查詢階段相同，但也允許擷取基於陣列的庫存屬性 (1: 許多關係)。 它存在於所有機器人內容中，裝置和人員清單的**通用**內容中也提供專用階段。

:::hint{type="info"}
使用「至人員內容」或「至裝置內容」階段時，若未在階段內提出正確的庫存查詢，將導致「無效的內容」錯誤。
:::
::::

:::ExpandableHeading
## 動作

動作階段利用自動化網狀架構來執行動作。 某些動作可使用變數。 深入瞭解[階段變數](https://docs.ivanti.com/neurons/help/zh_tw/2VbQSs9fWcU_3IFjy-Ujz#variables)。
:::

::::ExpandableHeading
## 通用

- **篩選結果**: 您可以依據可自訂的屬性篩選查詢結果。 一旦將內置的查詢階段連線到篩選器，**屬性**下拉清單將列出可選取的所有可用屬性。 若要檢視屬性的詳細資訊，請前往查詢**階段設定**面板，並選取**階段資訊**。
  - 您也可以使用**預覽查詢**功能評估所有目標裝置，並使用結果表格檢視可篩選的值的格式和範圍。
  - 您能夠將多個查詢連結成序列。 如果執行此動作，那麼所有結果將組合起來並可進行篩選，或者在「動作階段」中使用。 您可以變更所連接篩選器的比較行為，使其套用 AND 或 OR 邏輯來判斷結果。

**聯接**: 使用此階段重新合並已拆分為獨立分支的機器人。 在階段設定中，選取聯接行為；任何狀態、全部成功、至少有一個成功。

- **設定變數**: 使用此階段提供一致的參考點，可以使用預設值設定並根據結果按階段更新。 當您想要使用單個變數來引用可能從跨不同分支的查詢更新的欄位時，這很有用。 您可以設定的變數在[定義變數](https://docs.ivanti.com/neurons/help/zh_tw/j6wtYg3g8YitQOoh1j-_F#Definevariable)中定義。
- **延遲**: 使用此階段將工作流程設定為暫停一段預先定義的時間。 它會依延遲階段中設定的時間來延遲執行即將執行的階段。 在階段設定中，選取延遲持續時間 (以分鐘、小時和天為單位)。 您可以設定的延遲上限為七天，延遲下限為一分鐘。 此階段對於等待使用者回覆訊息或等待程序完成很有幫助。
- **裝置內容階段**: 當您選擇通用作為機器人目標類型時，此階段可用。 使用此階段從人員內容或通用內容切換到裝置內容。 在工作設定中，您可以建立輸入，然後將其綁定到**裝置名稱**，或者您可以將其切換到**清單輸入模式**。 當您按一下裝置內容可調整大小階段時，階段庫將動態地變成裝置內容庫。 您可以從裝置內容階段中的階段庫中拖曳所需的階段，以收集可在此裝置內容外進一步使用的資料。 當您想要將不同裝置上的不同動作做為相同工作流程的一部分進行排序時，此格式對於工作流程的編排很有用。
- **投放至類型階段**: **投放至類型**階段可讓您將輸入值轉換為特定資料。 當下游階段或篩選器需要諸如字串、數字、布林值或日期等特定類型的值時，此階段很有用。
  例如，從記錄訊息字串擷取數字後，您可以將輸出轉換為整數，並在下游階段執行數學運算。

:::hint{type="info"}
如果您需要將物件轉換為字串，請改用 **To JSON** 階段。
:::

主要功能包括:

:::Paragraph{listStyleType="disc" indent="2"}
**布林值會話**
:::

:::Paragraph{listStyleType="disc" indent="3"}
將 'true'、'TRUE' 或 '1' 等值轉換為布林值 true。
:::

:::Paragraph{listStyleType="disc" indent="3"}
只有精確值 1 會被視為真；十進位值如 1.5 則不會。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**日期會話**
:::

:::Paragraph{listStyleType="disc" indent="3"}
使用 [JavaScript 日期建構器](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date)將支援的字串值轉換為日期物件。
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="2"}
**會話編號**
:::

:::Paragraph{listStyleType="disc" indent="3"}
執行直接數字轉換。
範例:
:::

:::Paragraph{listStyleType="disc" indent="4"}
輸入: '23'
:::

:::Paragraph{listStyleType="disc" indent="4"}
輸出: 23
:::

:::Paragraph{listStyleType="disc" listStart="3" indent="2"}
**字串會話**
:::

:::Paragraph{listStyleType="disc" indent="3"}
因為輸入支援權杖，將值轉換為字串表示。 可將多個值合併為單一字串。
:::

- **JavaScript AI 階段**: **JavaScript AI** 階段將 JavaScript 階段的靈活性與 AI 輔助程式碼產生相結合，讓使用者能夠透過提示而非手動編寫程式碼來建立資料轉換和業務邏輯。 產生的程式碼可以在工作流程中檢閱、編輯、測試和重複使用。
  **階段設定&#x20;**&#x5305;含一個提示欄位，用於產生 JavaScript 程式碼。 它支援使用者定義的輸入，可以直接在提示中引用。 您可以使用**開啟階段編輯器**選項來修改提示。 在**測試和取得輸出**測試之前，必須先套用並儲存變更。
  首次儲存機器人時，您必須接受位於**階段設定**面板底部的 JavaScript AI 階段的條款和條件。
  如同所有 AI 相關階段，此階段保持不可用，直至在**管理員** > **設定中啟用了** **AI 支援階段選項**，且使用者已被指派包含**人工智慧** > **機器人生成式 AI 階段**權限的 RBAC 角色之前。
- **JavaScript 階段**: **JavaScript** 階段可讓您在工作流程中執行 JavaScript 程式碼，而不在端點裝置執行。 它有助於處理資料、執行計算、格式化值和產生結構化輸出。 這樣即使目標裝置離線，工作流程也能執行處理。
  在**階段設定**中，您可以為階段定義一個或多個輸入。 JavaScript 程式碼中會自動提供輸入值，不需要明確的變數宣告。
  在 **JavaScript 編輯器**欄位中輸入程式碼後，按一下**測試並取得輸出**以執行程式碼並檢視輸出。 輸出由傳回的 JSON 產生，並可作為工作流程中下游階段的結構化輸出。 可以使用**開啟階段編輯器**選項修改產生的 JavaScript。 測試前必須套用並儲存變更。

:::hint{type="info"}
此階段以隔離方式執行；因此，其功能會受到限制。 例如，使用 JavaScript 呼叫 Web 服務的能力會導致連線失敗。
:::
::::

:::ExpandableHeading
## Beta

您可以在此優先存取這些階段。 Beta 階段的目的在於讓 Ivanti 針對即將推出的功能收集意見反應和資料。
:::

::::ExpandableHeading
## 自訂

自訂階段允許您執行自訂指令碼。 可從下列指令碼模板進行選擇:

- **osquery**: 一種開源 SQL 語言，可用於從裝置查詢和擷取資訊，支援 Windows 和 macOS 裝置。
- **PowerShell 查詢**: 可用來查詢 Windows 和 macOS 裝置。 IT可以作為系統或登入使用者執行，或使用指定的憑證。
- **PowerShell AI**: 可用於在機器人工作流程中產生和執行 PowerShell 指令檔。 它可以作為系統或登入使用者執行，或使用指定的憑證。
- **Bash 動作**: 可用來在 macOS 裝置上執行動作。
- **Bash 動作 AI**: 可用於在機器人工作流程中產生和執行自訂 Bash 指令碼。 它可以系統或登入使用者身分執行。
- **命令動作**: 在目標端點上執行 Windows 命令提示命令。 它會以系統或登入使用者的身分執行。
- **命令動作 AI**: 可用來在機器人工作流程中產生和執行自訂命令指令碼。 它可以系統或登入使用者身分執行。
- **PowerShell 動作**: 可用來在 Windows 裝置上執行動作。

:::hint{type="info"}
在 FRU 環境中無法使用 AI 功能。
:::

深入瞭解[自訂階段](https://docs.ivanti.com/neurons/help/zh_tw/byn_2OhEACFR5KynsAeOi)。
::::

:::ExpandableHeading{customAnchorSlug="list"}
## 清單函數

清單函數階段可讓您對清單形式的階段結果執行動作。 例如，您可以對清單進行篩選、排序、計數或加總。
如果清單函數階段的結果仍然是清單，您可以新增另一個清單函數來進一步調整結果。

在工作區域中，您可以透過**清單**標籤，識別 (預計) 傳回清單結果的階段。

**若要在工作流程中套用清單函數階段:**

1. 新增包含清單結果的階段。
2. 新增所需的清單函數。
3. 使用 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/ThinP_XzVxTCGGrO8G1Nj_bots-stageconnect.png" alt caption size="10" width="27" height="25"}，連接步驟 2 和 3 中的階段。
   這將在清單函數階段填入**選取清單**的值。
4. **選取清單**，以對該清單執行清單函數。
5. 視清單函數而定，完成階段的剩餘組態。
6. 完成機器人工作流程的其餘部分並儲存變更。
:::

:::ExpandableHeading
## 字串功能

字串操作階段可讓您從字串資料轉換、清除、驗證和擷取資訊，將之做為自動化工作流程的一部分。 它們適用於需要處理資料的工作流程，例如檢查字串格式、從記錄訊息中擷取資料，或動態建立字串。 部分階段包括:

- **擷取字串**: 使用規則運算式從文字區塊中比對和擷取字串，傳回相符的字串，以便稍後在工作流程中使用。
- **替換字串**: 允許在字串內以另一個值取代原值。 可藉由明確值或規則運算式完成比對。
- **字串比對**: 使用規則運算式比對字串，傳回 true 或 false 條件。
:::

:::ExpandableHeading{customAnchorSlug="Interaction"}
## 互動

互動階段允許機器人使用 Microsoft Teams 與一般使用者互動並收集其意見。 您可以從下列互動階段進行選擇:

- **MS Teams 互動**: 允許機器人透過 Microsoft Teams 與一般使用者互動並收集其意見。 此訊息包含標題、訊息和互動選擇: 按鈕或任意文字輸入。
- **MS Teams 訊息**: 允許機器人使用 Microsoft Teams 傳送單向訊息給一般使用者。 此訊息包含標題和訊息。
- **MS Teams 評分**: 允許機器人透過 Microsoft Teams 與一般使用者互動並收集評分。 此訊息包含標題、問題和評分。
- **MS Teams 觀點**: 允許機器人透過 Microsoft Teams 與一般使用者互動並收集其意見。 此訊息包含標題、訊息和互動選擇: 按鈕或任意文字輸入。

若要深入瞭解，請參閱 [MS Teams 階段](https://docs.ivanti.com/neurons/help/zh_tw/ms-teams)。
:::

:::ExpandableHeading
## 使用者

使用者階段是自訂指令碼階段。 它們被保存並在此使用者區段中可用，以便在機器人建立中多次重復使用。

瞭解有關[ 使用者階段](https://docs.ivanti.com/neurons/help/zh_tw/_vFkwzxIwdBBZK95ml9qf)的更多資訊。
:::

## 階段變數

階段設定中的變數可用於在階段間傳遞資訊，並將某個動作的輸出傳遞給其他動作。

### 插入變數

若要插入變數，請開啟**階段設定**。 任何支援變數的欄位都會顯示文字 Ctrl + 空白鍵。 選取 **Ctrl + 空格**從清單中選取並插入一個變數。

:::hint{type="info"}
當您在 PowerShell 中定義變數作為指令碼輸入時，請使用 $myvar 語法，在指令碼內引用這些變數。
:::

:::ExpandableHeading
## 標準變數

**機器人名稱**: 目前機器人的名稱。

**初始化使用者**: 起始機器人之使用者的名稱。 這可以是使用者或某個 Neurons 服務。

**初始化使用者 ID**: 初始化使用者的使用者 ID。 這可以是使用者 ID 或某個 Neurons 服務。

**時間戳記 (ISO)**: 使用 ISO 格式的目前時間戳記。

**裝置名稱**: 取得目前階段中目前裝置的裝置名稱。 返回的裝置名稱以逗號分隔。

**所有裝置資料**: 取得目前階段中目前裝置的所有資料。 這將會是 JSON 物件。

**指定名稱**: 登入的終端使用者的名稱。

**顯示名稱**: 一般使用者的全名。

**電子郵件**: 一般使用者的電子郵件。
:::

目前有可搭配變數使用的範本。 如有更複雜的需求，支援使用 handlebarsjs 的 javascript。

## 階段設定

當您將階段拖曳至工作區域上且其以醒目提示呈現時，**階段設定**面板隨即顯示。 使用設定來設定及自訂各個階段。

:::hint{type="info"}
您可以使用使用者階段指令碼功能自訂設定。 瞭解有關[ 使用者階段](https://docs.ivanti.com/neurons/help/zh_tw/_vFkwzxIwdBBZK95ml9qf)的更多資訊。
:::

每個階段都會有一個唯一的數值 ID。 若機器人會使用相同的階段超過一次以上，則此 ID 可用來識別個別階段。

按一下**檢視階段資訊**以顯示**階段資訊**面板，其中會顯示階段的說明及所有相關聯的屬性。 這些可做為篩選查詢結果的準則使用。

啟用**結果會影響 DEX 分數**的切換開關，以便在裝置頁面上顯示**調查**區段。

:::hint{type="info"}
如果階段的設定沒有正確設定，或者缺少某些資訊，階段將有一個紅色邊框，需要注意的設定也是如此。 正確完成設定後，紅色邊框將被移除。
:::

## 棄用的階段

如果機器人中有更新版本的階段可用，會有一個黃色橫幅顯示需要動作: 此機器人包含已棄用的 x 階段。 已棄用階段的邊框將為黃色。

選取**更新**將階段升級到較新的版本。 完成後，橫幅將消失，階段邊框將不再是黃色。

## 已禁用階段

如果機器人中的某個階段已被刪除且不再可用，則會顯示紅色橫幅需要採取措施: 此機器人包含已禁用的 x 階段。 禁用階段的邊框將為紅色。

您必須從機器人刪除階段。 一旦完成，橫幅就會消失。

## 釘選階段

使用釘選類別對您最常用的階段進行分群組。

要釘選階段，將鼠標懸停在階段上，選取釘選圖示 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/UbEF2qewH-_vO1Gm1yNs7_bots-pin.png" alt="釘選圖示" caption size="10" width="19" height="24"}。

要取消釘選階段，請按一下釘選圖示 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/oQFxvL_JLz5yKsMi80XpF_bots-pinned.png" alt="釘選圖示" caption size="10" width="19" height="24"}。

## 階段資訊

使用任何階段上的資訊圖示 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/Bm-9q1-8KeHYeloOe1H1S_general-info-icon.png" alt="資訊圖示" caption size="10" width="24" height="23"} 可顯示該階段執行事項的描述、作業系統特定資訊以及設定詳細資訊。

## 重新命名階段

使用任何階段上的重新命名 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/ZqxGmXUMIuSfsQ1OpeiQm_rename-stage.PNG" alt caption size="10" width="34" height="28"} 圖示，皆能為工作流程中的階段指定自訂名稱。 文字可以是您認為有助於說明機器人相應部分的內容，並且在儲存機器人時會保留下來。 當機器人處於編輯模式時，選取工作流程中的階段，然後按一下重新命名圖示以顯示**重新命名階段**對話方塊。 在對話方塊中指定名稱或說明後，相關資訊將顯示在工作流程的階段中。 階段文字現在也將包括預設階段名稱 (附加在括號中)。 相同組合文字也會顯示在「階段設定」面板、「階段結果」檢視中，如果您使用任何階段結果作為另一個階段的輸入，則還會顯示變數選擇器中。

:::hint{type="info"}
自訂名稱欄位中最多可新增 200 個字元。
:::

## 新的和更新的群組

新增或更新機器人階段時，這些階段將從發佈之日起在「新的和更新的」群組中顯示 30 天，並在階段中顯示*新的*或*更新的*綠色徽章。 30 天後，這些階段將從「新的和更新的」群組中消失，並顯示在其實際群組中。 此徽章可協助使用者識別新增的階段和舊階段。

:::hint{type="info"}
如果階段處於搶先體驗狀態，則無論持續時間為何，此徽章都會保留。 為所有人啟用階段之後，新的或更新的徽章將顯示 30 天，然後才會移除。
:::

### 相關階段

[自訂階段](https://docs.ivanti.com/neurons/help/zh_tw/byn_2OhEACFR5KynsAeOi)

[使用者階段](https://docs.ivanti.com/neurons/help/zh_tw/_vFkwzxIwdBBZK95ml9qf)
