本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 整合
<a name="actions-integrations"></a>

## AWS 服務
<a name="aws-services"></a>

### Amazon S3
<a name="amazon-s3"></a>

Amazon S3 動作可讓您存放和擷取檔案和資料。

**可用的動作**
+ **下載檔案** - 從 Amazon S3 下載檔案並傳回檔案物件控點。
+ **上傳檔案** - 將檔案物件控點上傳至 Amazon S3。
+ **複製物件** - 建立已存放在 Amazon S3 中的物件複本，從一個來源檔案到目的地位置。
+ **刪除物件** - 從 S3 儲存貯體刪除指定的物件。
+ **列出物件** - 列出指定儲存貯體中的所有物件。可以使用字首進行篩選。

### Amazon Bedrock
<a name="amazon-bedrock"></a>

Amazon Bedrock 動作可讓您透過單一 API 從領導 AI 公司連線到基礎模型 (FMs)。
+ **基本模型對談** - 傳送提示給 AI 模型。使用自然語言產生文字、分析內容，以及取得 AI 支援的回應。
+ **進階模型對談** - 提示具有更多選項的模型。進階選項包括自訂訊息格式、工具整合，以及對模型行為的精細控制。

### Amazon Bedrock 代理程式
<a name="amazon-bedrock-agents"></a>

Amazon Bedrock Agent 動作可讓您叫用 AI 助理，以連線至資料來源、APIs和後端系統。
+ **基本代理程式叫用** - 傳送請求給 AI 代理程式。用於不需要檔案附件、使用者輸入或自訂組態的簡單互動。
+ **進階客服人員叫用** - 呼叫具有更多選項的客服人員。用於需要檔案附件、使用者輸入或自訂組態的進階互動。

### Amazon Bedrock 資料自動化
<a name="amazon-bedrock-data-automation"></a>

Bedrock Data Automation (BDA) 簡化了使用生成式 AI 從非結構化內容中擷取寶貴洞見的程序。

**可用的動作**
+ **叫用資料自動化非同步** - 使用資料自動化專案或藍圖處理資料。開始非同步資料處理並傳回調用 ID。
+ **取得資料自動化狀態** - 取得資料自動化調用狀態和輸出位置的詳細資訊。

### Amazon Textract
<a name="amazon-textract"></a>

Amazon Textract 可協助您將文件文字偵測和分析新增至自動化。
+ **基本文件查詢** - 根據問題擷取資料。每個查詢都包含您要詢問的問題，以及您要關聯的別名。Textract 提供每個問題的文字答案和可信度分數。
+ **基本文件分析** - 從文件擷取資料。自動偵測和擷取表單 （鍵值對）、資料表 （結構化資料） 和文字，同時保留文件配置和資料關係。

### Amazon Comprehend
<a name="amazon-comprehend"></a>

Amazon Comprehend 是一種自然語言處理 (NLP) 服務，可讓您深入了解文件內容。它有助於分析文字以擷取金鑰片語、識別情緒和分類文件。

**可用的動作**
+ **分類文件** - 建立分類請求，以使用自訂模型端點即時分析單一文件。支援文字輸入或文件檔案 (PDF、Word 或映像）。
+ **Detect Key Phrases** - 偵測文字中發現的金鑰名詞片語，識別內容中的重要概念和主題。

## 外部應用程式
<a name="external-applications"></a>

### Microsoft Outlook
<a name="microsoft-outlook"></a>

Microsoft Outlook 動作可讓您的自動化管理電子郵件和行事曆。
+ **電子郵件**
  + **傳送使用者電子郵件** - 代表特定使用者傳送電子郵件訊息。
  + **回覆電子郵件** - 回覆訊息的寄件者。
  + **列出資料夾訊息** - 在登入使用者信箱的特定資料夾中取得訊息。
  + **列出使用者郵件** - 取得登入使用者信箱中的訊息 （包括已刪除項目和 Clutter 資料夾）。
  + **檢視電子郵件** - 擷取特定訊息物件的屬性和關係。
  + **更新電子郵件** - 更新訊息物件的屬性。
  + **刪除電子郵件** - 刪除指定使用者信箱中的訊息。
  + **列出電子郵件附件** - 擷取連接至訊息的附件物件清單。
  + **取得附件** - 讀取附件的屬性、關係或原始內容。
+ **資料夾**
  + **列出郵件資料夾** - 直接在登入使用者的根資料夾下取得郵件資料夾集合。
  + **將電子郵件移至資料夾** - 將訊息移至指定使用者信箱中的另一個資料夾。
  + **取得信箱設定** - 取得使用者的信箱設定，例如自動回覆、日期格式和時區。
+ **行事曆**
  + **列出行事曆事件** - 從 Microsoft Outlook 擷取指定使用者或資源的行事曆事件清單。
  + **建立行事曆事件** - 在使用者的預設行事曆或指定的行事曆中建立事件。
  + **更新行事曆事件** - 更新現有事件物件的屬性。
+ **Other (其他)**
  + **列出位置** - 取得租用戶中定義之位置物件 （房間或房間清單） 的集合。
  + **列出使用者** - 從 Microsoft Outlook 擷取組織中的使用者清單及其基本資訊。
  + **列出聯絡人** - 從登入使用者的預設聯絡人資料夾中取得聯絡人集合。

### Microsoft Teams
<a name="microsoft-teams"></a>

Microsoft Teams 動作可讓您的自動化透過管道和聊天訊息與團隊成員通訊，以及管理會議。
+ **訊息**
  + **列出聊天 **- 檢視所有聊天對話
  + **建立聊天** - 開始新的聊天對話
  + **取得個別聊天** - 檢視特定聊天的詳細資訊
  + **列出所有聊天訊息** - 在聊天對話中檢視訊息
  + **傳送聊天訊息** - 在聊天中傳送新訊息
+ **團隊**
  + **列出團隊** - 檢視已驗證使用者可存取的所有團隊
  + **取得團隊** - 檢視特定團隊的詳細資訊
  + **列出所有團隊成員** - 檢視團隊成員
  + **邀請使用者加入團隊** - 將新成員新增至團隊
+ **頻道**
  + **列出所有頻道** - 檢視特定團隊中的所有頻道
  + **建立頻道** - 在團隊中建立新的頻道
  + **取得頻道** - 檢視特定頻道的詳細資訊
  + **列出所有頻道訊息** - 檢視頻道中張貼的訊息
  + **傳送頻道訊息** - 將新訊息發佈至頻道
  + **回覆管道訊息** - 新增對現有管道訊息的回覆
  + **邀請頻道成員** - 將成員新增至特定頻道
+ **會議**
  + **建立線上團隊會議** - 安排新的線上會議
  + **取得線上團隊會議** - 檢視特定會議的詳細資訊
  + **列出所有錄製 **- 檢視會議的錄製
  + **列出所有文字記錄** - 檢視會議的文字記錄
+ **使用者**
  + **列出使用者** - 檢視組織中的使用者清單

### Microsoft SharePoint
<a name="microsoft-sharepoint"></a>

Microsoft SharePoint 可讓您透過自動化集中儲存、管理和共用文件和資訊。
+ **清單和項目**
  + **取得清單** - 取得與清單相關聯的操作清單
  + **建立項目** - 在清單中建立新的清單項目
  + **更新項目** - 更新 listItem 上的屬性
  + **刪除項目** - 從清單中移除項目
  + **取得項目** - 傳回清單中項目的中繼資料
  + **清單項目** - 取得清單中項目的集合
+ **工作表和檔案**
  + **新增工作表** - 將新的工作表新增至工作手冊
  + **刪除工作表** - 從工作手冊中移除工作表
  + **更新工作表** - 編輯工作表屬性 （重新命名、可見性）
  + **清單表** - 擷取工作表物件的清單
  + **讀取表** - 擷取工作表的屬性
  + **上傳檔案** - 建立或更新工作手冊檔案
+ **範圍和儲存格**
  + **讀取範圍** - 從指定範圍擷取值
  + **刪除範圍** - 刪除指定範圍內的儲存格
  + **寫入範圍** - 更新指定範圍內的值
  + **取得使用範圍** - 傳回指定工作表的使用範圍
  + **清除範圍** - 清除範圍值，包括格式、填充和邊界
  + **讀取儲存格** - 從特定儲存格取得值
  + **寫入儲存格** - 設定特定儲存格的值

### Microsoft OneDrive
<a name="microsoft-onedrive"></a>

Microsoft OneDrive 動作可讓您存放、同步和共用檔案。您可以直接與儲存至 OneDrive 的 Microsoft Excel 檔案互動，以進行試算表動作。
+ **檔案管理**
  + **取得項目** - 檢視特定檔案或資料夾的詳細資訊
  + **Get Drive** - 檢視 OneDrive 帳戶詳細資訊和儲存資訊
  + **列出項目** - 檢視磁碟機中的所有檔案和資料夾
  + **建立項目/建立資料夾** - 在 OneDrive 中建立新的資料夾或項目
  + **列出子**項 - 檢視特定資料夾中包含的項目
  + **刪除項目** - 移除檔案或資料夾
  + **更新項目/移動項目** - 更新中繼資料或在資料夾之間移動檔案
  + **複製項目** - 在不同的位置建立檔案或資料夾的副本
  + **新增許可** - 設定檔案的共用和存取許可
  + **上傳檔案** - 將新檔案新增至 OneDrive
+ **Excel**
  + **新增工作表** - 在 Excel 工作手冊中建立新的工作表
  + **清除範圍** - 從儲存格範圍移除內容和格式
  + **刪除範圍** - 從工作表中移除儲存格、資料列或資料欄
  + **刪除工作表** - 從工作手冊中移除工作表
  + **清單工作表** - 檢視工作手冊中的所有工作表
  + **讀取儲存格** - 取得特定儲存格的值
  + **讀取範圍** - 從儲存格範圍取得值
  + **閱讀表** - 檢視整個工作表的內容
  + **讀取使用範圍** - 取得包含資料的儲存格範圍
  + **更新工作表** - 修改工作表屬性
  + **寫入儲存格** - 設定特定儲存格的值
  + **寫入範圍** - 設定儲存格範圍的值

### Salesforce
<a name="salesforce"></a>

Salesforce 動作可讓您自動化管理跨案例、機會、潛在客戶、行銷活動、聯絡人等客戶關係的程序。
+ **案例**
  + **取得案例清單** - 從 Salesforce 取得客戶支援案例的清單，包括其中繼資料和最近項目。
  + **取得案例** - 檢視特定案例的詳細資訊
  + **建立案例** - 建立新的支援案例
  + **刪除案例** - 移除現有案例
  + **更新案例** - 編輯案例詳細資訊和資訊
+ **商機**
  + **取得機會** - 檢視銷售機會清單
  + **取得特定機會** - 檢視特定機會的詳細資訊
  + **建立機會** - 建立新的銷售機會
  + **更新機會** - 編輯機會詳細資訊
  + **刪除機會** - 移除現有的機會
+ **潛在客戶**
  + **更新潛在客戶** - 編輯潛在客戶詳細資訊和資訊
+ **行銷活動**
  + **更新行銷活動** - 編輯行銷活動詳細資訊和資訊
+ **饋送項目**
  + **更新摘要項目** - 編輯摘要項目內容和屬性
+ **聯絡案例**
  + **取得聯絡人清單** - 檢視系統中的所有聯絡人
  + **取得聯絡人** - 擷取特定聯絡人的詳細資訊
  + **更新聯絡人** - 編輯聯絡資訊
+ **使用者**
  + **取得使用者清單** - 擷取 Salesforce 使用者的清單
+ **系統**
  + **描述 SObject** - 取得任何 Salesforce 物件類型的物件中繼資料和欄位詳細資訊

### Jira
<a name="jira"></a>

Jira 動作可讓您自動管理問題、專案、衝刺等。
+ **問題**
  + **建立問題** - 在專案中建立問題。
  + **編輯問題** - 修改專案中的現有問題。
  + **更新問題狀態 （執行轉換）** - 變更問題的任務狀態。
  + **刪除問題** - 刪除專案中的問題。
  + **取得問題** - 檢視專案中問題的詳細資訊。
  + **搜尋問題** - 使用 JQL 搜尋問題
  + **搜尋狀態** - 搜尋問題狀態。
  + **下載問題附件** - 檢視附件的內容。
  + **新增附件** - 將附件新增至問題。
  + **取得所有標籤** - 檢視所有標籤。
+ **評論**
  + **新增註解** - 將新註解新增至問題。
  + **刪除註解** - 從問題中移除註解。
  + **更新註解** - 編輯問題上的現有註解。
  + **取得註解** - 檢視問題註解。
+ **專案**
  + **建立專案** - 在 Jira 中建立新專案。
  + **更新專案** - 修改專案詳細資訊。
  + **刪除專案** - 從 Jira 移除專案。
  + **取得專案** - 檢視專案詳細資訊。
  + **取得專案的問題類型** - 檢視專案問題類型。
  + **搜尋專案** - 尋找可見專案。
+ **衝刺**
  + **建立衝刺** - 在專案中建立衝刺。
  + **更新衝刺** - 更新衝刺詳細資訊。
  + **刪除衝刺** - 刪除專案中的衝刺。
  + **取得衝刺** - 檢視專案中衝刺的詳細資訊。
  + **將問題移至衝刺和排名** - 將問題指派給衝刺。
  + **將問題移至積壓** - 將問題移至積壓。
+ **使用者**
  + **尋找使用者** - 搜尋 Jira 使用者。
  + **尋找可指派的使用者** - 傳回可指派給問題的使用者清單。
  + **取得所有使用者** - 列出所有 Jira 使用者。

### ServiceNow
<a name="servicenow"></a>

ServiceNow 動作可讓您自動化事件、變更請求等的 IT 服務管理。
+ **事故**
  + **建立事件** - 建立新的事件記錄。
  + **讀取事件** - 擷取特定事件的詳細資訊。
  + **更新事件** - 修改現有的事件記錄。
  + **刪除事件** - 移除特定事件記錄。
+ **變更請求**
  + **建立變更請求** - 建立新的變更請求記錄。
  + **讀取變更請求** - 擷取特定變更請求的詳細資訊。
  + **更新變更請求** - 修改現有的變更請求記錄。
  + **刪除變更請求** - 移除特定變更請求記錄。
+ **知識庫文章**
  + **更新知識庫文章** - 修改現有的知識庫文章。
+ **問題記錄**
  + **更新問題記錄** - 修改現有的問題記錄。
+ **附件**
  + **上傳二進位附件** - 上傳檔案做為指定記錄的附件。
  + **上傳分段表單附件** - 將表單附件上傳至記錄。
  + **擷取附件內容** - 取得特定附件的二進位內容。
  + **擷取附件中繼資料** - 取得特定附件的中繼資料。
  + **刪除附件** - 從系統移除附件。
  + **擷取附件的中繼資料** - 取得多個附件的中繼資料。
+ **系統**
  + **列出使用者** - 從系統使用者資料表擷取所有現有的記錄。
  + **List Choices** - 從系統擷取選擇清單值。

### SAP
<a name="sap"></a>

SAP 動作可讓您自動化涉及業務合作夥伴資料、物料庫存、物料清單、產品主控和實體庫存的程序。
+ **SAP 業務合作夥伴**
  + **取得業務合作夥伴** - 擷取業務合作夥伴的一般資料，提供合作夥伴資訊的全方位檢視。
  + **依 ID 取得業務合作夥伴** - 使用特定業務合作夥伴號碼做為識別符擷取詳細的業務合作夥伴資料。
  + **取得業務合作夥伴地址** - 擷取與業務合作夥伴相關聯的地址詳細資訊，包括郵寄地址和聯絡資訊。
  + **取得業務合作夥伴角色** - 擷取業務合作夥伴的角色資訊，顯示他們在系統內的關係和職能。
  + **依 ID 取得業務合作夥伴角色** - 使用金鑰識別符欄位擷取業務合作夥伴的特定角色資料。
+ **SAP 材料庫存**
  + **取得帳戶中的物料庫存模型集合** - 取得具有批次、儲存位置和特殊庫存指標等詳細資訊的物料庫存層級。
+ **SAP 物料清單**
  + **取得物料 BOM 項目** - 擷取物料清單中所用物料的詳細資訊，包括數量、類別和關係。
+ **SAP 產品主伺服器**
  + **取得產品主要記錄** - 檢視產品主要一般詳細資訊。傳回完整的產品主記錄，其中包含篩選、排序和選取特定資料的選項。
  + **取得產品主記錄的工廠資料** - 檢視產品的工廠詳細資訊。存取特定產品的詳細植物特定資訊，包括製造、儲存和物流資料。
  + **依產品編號和工廠取得供應規劃資料** - 依產品編號和工廠檢視供應規劃詳細資訊。擷取詳細的規劃參數，包括批次大小、安全庫存層級和採購資料。
+ **SAP 實體庫存**
  + **取得 Phys 庫存文件項目** - 擷取實體庫存文件項目，包括計數結果和庫存差異。

## REST API 整合
<a name="custom-rest-apis"></a>

REST API Connection 整合可讓 Quick Automate 與自訂 REST APIs和 Web 服務互動，讓您將自動化功能擴展至外部系統。此整合支援 GET、POST、DELETE、PATCH 和 PUT HTTP 方法的動作執行。

**常見使用案例：**
+ 傳送通知至外部系統
+ 從第三方服務擷取資料
+ 更新外部資料庫中的記錄
+ 在連線的應用程式中觸發工作流程

**先決條件**

使用 REST API 整合建立自動化之前，請確定您有：
+ **設定的 REST API 整合**
  + 存取 Quick Suite 主控台
  + 導覽至整合 > REST API 連線
  + 使用基本 URL 設定 REST API 端點
  + 完成身分驗證設定 （請參閱下面的身分驗證一節）
  + 完整詳細資訊： [REST API Connection 整合](rest-api-integration.md)
+ **與自動化群組的連線整合**
  + 將您設定的 REST API 整合連結至自動化群組
  + 確認整合出現在可用的動作中
  + Step-by-step指南： [AWS 服務動作連接器](builtin-services-integration.md)
+ **已設定身分驗證**
  + 從 API 提供者取得的 OAuth 2.0 登入資料

### 身分驗證
<a name="rest-api-authentication"></a>

對於 Quick Automate，此整合支援 **OAuth 2.0 **身分驗證。您必須先設定 OAuth 登入資料，才能建立自動化。

**OAuth 2.0 設定步驟：**
+ 從身分提供者取得 OAuth 登入資料 （用戶端 ID 和用戶端秘密）
+ 在 Quick Suite 主控台中，導覽至您的 REST API 整合設定
+ 選取 OAuth 2.0 作為身分驗證方法
+ 輸入您的用戶端 ID 和用戶端秘密
+ 設定 API 供應商提供的授權 URL 和字符 URL
+ 完成 OAuth 流程以授權 Quick Suite
+ 測試連線以驗證身分驗證

**重要備註：**
+ Quick Automate 不支援請求標頭中的承載字符身分驗證。請改用 OAuth 組態。
+ 在整合層級設定身分驗證，而非每個自動化動作

### Configuration
<a name="rest-api-configuration"></a>

**設定您的 REST API 整合**

步驟 1：建立基本 URL 組態

步驟 2：連線至自動化群組

步驟 3：存取 REST API 動作
+ 在自動化中開啟動作面板
+ 尋找 REST API 動作
+ 將動作拖放到您的自動化工作流程
+ 
**注意**  
REST API 動作必須透過動作面板新增；在建置助理界面中無法使用

### 屬性參考
<a name="rest-api-properties"></a>
+ **Q Action Connector ID （必要）**
  + **描述：**將 REST API 動作連結至您設定整合的唯一識別符，包括基本 URL 和身分驗證設定。
  + **格式：**從您的連線整合自動填入
  + **範例**：`rest-api-connector-abc123`
+ **URI （選用）**
  + **描述：**附加到基本 URL 的其他路徑，以指定確切的 API 端點。
  + **格式：**含或不含正斜線的路徑字串 （取決於基本 URL 格式）
  + **運作方式：**
    + 基本 URL： `https://api.example.com`
    + URI： `/users/123`
    + 最終 URL： `https://api.example.com/users/123`
  + **範例**：

    ```
    /users/123
    prod/send-email
    /v2/orders
    customers/search
    ```
+ **其他標頭 （選用）**
  + **描述：**自訂 HTTP 標頭以金鑰/值對的形式包含在 API 請求中。
  + **格式：**

    ```
    Key: Value
    ```
  + **常見範例：**

    ```
    Content-Type: application/json
    Accept: application/json
    X-Custom-Header: custom-value
    X-API-Version: 2.0
    ```
  + **重要限制：**
    + 請勿包含授權標頭；身分驗證是透過 OAuth 組態處理
    + 每個標頭必須位於單獨的一行
    + 標頭區分大小寫
+ **請求 （必要）**
  + **描述：**使用 POST 或 PUT 請求傳送的 JSON 格式資料。
  + **格式：**有效的 JSON 物件。\$1\$1 代表空白請求
  + **POST 請求範例 （建立資源）：**

    ```
    {
      "title": "My New Post",
      "body": "This is the content of my new post.",
      "userId": 1,
      "tags": ["automation", "api"],
      "published": true
    }
    ```
  + **PUT 請求範例 （更新資源）：**

    ```
    {
      "status": "completed",
      "completedDate": "2026-01-27",
      "notes": "Task finished successfully"
    }
    ```
+ **輸出變數 （選用）**
  + **描述：**儲存來自 API 呼叫的 JSON 回應以用於後續自動化動作的變數名稱。
  + **格式：**英數變數名稱 （無空格）
  + **範例：**`apiResponse`、`userData`、 `orderDetails`

### API 用量範例
<a name="rest-api-examples"></a>

#### 範例 1：GET 請求 - 擷取票證詳細資訊
<a name="rest-api-example-get"></a>

**案例：**從外部票證系統擷取現有支援票證的詳細資訊

**組態：**
+ **Q Action Connector ID：** rest-api-connector-tickets
+ **HTTP 方法：**GET
+ **URI：**/tickets/`ticketId`
+ **其他標頭：**

  ```
  Accept: application/json
  ```
+ **請求內文：**\$1\$1 ( GET 請求為空白）
+ **輸出變數：** ticketDetails

#### 範例 2：POST 請求 - 建立新記錄
<a name="rest-api-example-post"></a>

**案例：**將新的支援票證提交至外部票證系統

**組態：**
+ **Q Action Connector ID：** rest-api-connector-tickets
+ **HTTP 方法：**POST
+ **URI：** `/tickets`
+ **其他標頭：**

  ```
  Content-Type: application/json
  Accept: application/json
  ```
+ **請求內文：**

  ```
  {
    "title": "{{ticketTitle}}",
    "description": "{{ticketDescription}}",
    "priority": "{{ticketPriority}}",
    "requestedBy": "{{userEmail}}",
    "category": "technical_support"
  }
  ```
+ **輸出變數：** `ticketResponse`