共用方式為


SAS Decisioning (預覽版)

SAS Decisioning 結合 AI 和業務規則,大規模自動化營運決策。 使用此連接器來執行部署在 SAS Viya 平台上的決策模型。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 SAS 支援
URL https://support.sas.com
Email support@sas.com
連接器中繼資料
Publisher SAS 研究所公司
網站 https://www.sas.com
隱私策略 https://www.sas.com/en_us/legal/privacy.html
類別 人工智慧;資料

SAS Viya 上的 SAS Intelligent Decisioning 結合了業務規則管理、決策處理、即時事件偵測、決策治理和強大的 SAS 進階分析,可自動化和管理整個企業的決策。 SAS Intelligent Decisioning 有助於加快分析模型的操作化,包括 SAS 模型和使用開放原始碼框架開發的模型。 它支援信貸服務、詐欺預防、製造、個人化行銷和許多其他用例中的決策流程。

SAS Decisioning 連接器可讓使用者連線至其 SAS Viya 環境,並執行選取的決策模組和分析模型。 SAS Decisioning 連接器的範例使用案例包括:

  • 判斷電子郵件內容是否符合公司的公司政策
  • 根據面試反饋對求職者進行評分
  • 為銷售商機評分
  • 判斷發票是否合法
  • 自動核准費用報表

要了解有關 SAS Intelligent Decisioning 的更多信息並申請免費試用,請訪問 https://www.sas.com/en_us/software/intelligent-decisioning.html

先決條件

  1. 使用者必須擁有現有的 SAS Intelligent Decisioning 授權。
  2. 使用者必須設定 SAS Intelligent Decisioning 環境,以允許來自 Azure IP 範圍中所述的 IP 位址的呼叫。

如何使用 SAS Decisioning 聯結器

  1. 註冊您的用戶端應用程式。
  2. 取得存取權杖,以用於連線至 SAS Viya 環境。
  3. 連線至您的 SAS Viya 環境。

註冊客戶

所有使用 SAS Viya REST API 的應用程式和指令碼都必須向 SAS 環境註冊。 您的 SAS 管理員必須使用 SAS Logon Manager 中的 OAuth 服務來要求存取權杖並註冊用戶端。 SAS Logon Manager 會發出 OAuth 存取權杖,以回應包含來自 SAS Configuration Server 有效權杖的要求。 SAS Decisioning Connector 使用 OAuth 持有人權杖作為 API 金鑰。

若要註冊用戶端:

  1. 找到有效的 Consul 令牌。 SAS 管理員可以在 Pod 內部sas-consul-server-0/opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/defaultclient.token 檔案中找到權杖。 若要在 Linux 系統上擷取 Consul 權杖字串,請執行下列命令:

    kubectl exec sas-consul-server-0 -- \
        cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token
    
  2. 將請求張貼至 /SASLogon/oauth/clients/consul來請求 。 在欄位中 X-Consul-Token 指定步驟 1 中的 Consul 權杖。 例如,若要為名為 app的用戶端要求權杖,請提交下列命令:

    curl -X POST "https://server.example.com/SASLogon/oauth/clients/consul?callback=false&serviceId=app" \
          -H "X-Consul-Token: <consul-token-from-step-1>"
    
    查詢參數 Description
    回撥 指定 false 以接收回應中的存取權杖。 否則,權杖會傳送至 SAS Configuration Server 中註冊的服務。
    serviceId 服務 ID 指定您要註冊的用戶端名稱。

    為了回應要求,SAS Logon Manager 會傳回 JSON 回應,其中包含 access_token 欄位中的存取權杖。

  3. 將要求張貼至 /SASLogon/oauth/clients來註冊用戶端應用程式。 將步驟 2 中傳回的存取權杖指定為標頭的 Authorization 值:

    curl -X POST "https://server.example.com/SASLogon/oauth/clients" \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer <access-token-from-step-2>" \
        -d '{
          "client_id": "<client-id-goes-here>",
          "client_secret": "<client-secret-goes-here>",
          "scope": ["openid"],
          "authorized_grant_types": ["client_credentials"],
          "access_token_validity": 43199
         }'
    

    末: 根據預設,權杖的有效期為 12 小時 (或 43200 秒)。 若要設定較短或較長的持續時間,請視需要設定 access_token_validity 欄位,並使用整數值表示時間 (以秒為單位)。

    便條: 支援其他「authorized_grant_types」,但 SAS Decisioning 聯結器目前需要 client_credentials 授權型別。

如果請求成功,則會註冊客戶端。 成功的 JSON 回應看起來類似下列範例:

{"scope":["openid"],"client_id":"<requested-client-id>","resource_ids":["none"],"authorized_grant_types":["client_credentials"],
"access_token_validity":43199,"authorities":["uaa.none"],"lastModified":1521124986406}

取得存取權杖

已註冊的用戶端可以使用 SAS Logon OAuth API 要求存取權杖。 若要要求存取權杖,請將要求張貼至 /SASLogon/oauth/token 端點,並指定授權形式。 授權以授權授與的形式表示。 目前,SAS Viya REST API 支援 client_credentials 授權類型。

例如,假設用戶端識別碼為「myclient」,密碼為「mysecret」,您可以要求權杖,如下所示:

    curl -X POST "https://server.example.com/SASLogon/oauth/token" \
      -H "Content-Type: application/x-www-form-urlencoded" \
      -d "grant_type=client_credentials&client_id=myclient&client_secret=mysecret"

JSON 回應包含名為的欄位 access_token ,其中包含 SAS Decisioning 連接器用來建立 Power Automate 連線的權杖值。 當權杖到期時,將新請求張貼至 /SASLogon/oauth/token 端點。

連線至您的 SAS Viya 環境

若要連線到 SAS Viya 環境,您將需要下列資訊:

參數名稱 Description
SAS Viya 環境 URL SAS Intelligent Decisioning 部署的 URL。 例如:https://server.example.com
授權權杖 從上述 取得存取權杖 中的命令傳回的存取權杖。 在記號 Bearer 前加上 。

連線可以在使用者之間共用。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 可共用

預設

適用:所有地區

建立連線的參數。

這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱 類型 Description 為必填項目
SAS Viya 環境 URL 字串 指定 SAS Viya 環境 URL
授權權杖 securestring 此 API 的授權權杖

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

執行步驟

使用指定的輸入值執行步驟。 outputs回覆中的變數包含執行的輸出。

執行步驟

使用指定的輸入值執行步驟。 outputs回覆中的變數包含執行的輸出。

參數

名稱 機碼 必要 類型 Description
模組
moduleId True string

包含要執行之步驟的模組識別碼。

步驟
stepId True string

要執行之步驟的識別碼。

名稱
name string

變數的名稱。

value
value

變數的值。

傳回

此類型描述執行步驟時傳回的輸出值。

步驟輸出
stepOutput

觸發程序

當預先定義的事件發生時

為預先定義的回呼內容類型事件建立新的 Webhook。

發佈資源時

建立發佈事件的新 Webhook。

驗證資源時

建立新的 Webhook 以完成任何評分事件。

當預先定義的事件發生時

為預先定義的回呼內容類型事件建立新的 Webhook。

參數

名稱 機碼 必要 類型 Description
回呼內容類型
callbackContentType True string

回呼內容的型別。

回呼內容篩選器
callbackContentFilter string

篩選回呼內容。

傳回

一般回呼的內容。

Webhook 回呼泛型
webhookCallbackGeneric

發佈資源時

建立發佈事件的新 Webhook。

參數

名稱 機碼 必要 類型 Description
資源路徑前置詞
resourcePath True string

資料夾中資源的路徑。

目的地類型
destinationType True string

傳回

回呼發佈的內容。 這代表application/vnd.sas.webhook.callback.publish媒體型別(第1版)。

Webhook 回呼發佈
webhookCallbackPublish

驗證資源時

建立新的 Webhook 以完成任何評分事件。

參數

名稱 機碼 必要 類型 Description
資源路徑前置詞
resourcePath True string

資料夾中資源的路徑。

State
state True string

傳回

回呼驗證的內容。 這代表application/vnd.sas.webhook.callback.validate媒體型別(第1版)。

Webhook 回呼驗證
webhookCallbackValidate

定義

anyVariable值

變數的值。

變數的值。

步驟輸出

此類型描述執行步驟時傳回的輸出值。

名稱 路徑 類型 Description
模組標識
moduleId string

包含已執行步驟之模組的識別碼。

stepId
stepId string

產生此輸出的步驟名稱。

輸出
outputs array of variable

從已執行步驟傳回的輸出值。 變數的順序符合輸出簽章中呈現的順序。

變數

代表輸入或輸出變數的名稱/值組。

名稱 路徑 類型 Description
name string

變數的名稱。

value
value anyVariableValue

變數的值。

連結

名稱 路徑 類型 Description
href
href string

連結的 URL。

項目類型
itemType string

如果這是容器的連結, itemType 則是容器中項目的媒體類型或連結類型。

方法
method string

連結的 HTTP 方法。

關係
rel string

連結與資源的關係。

回應項目類型
responseItemType string

回應本文 PUT中專案的媒體類型或連結類型,適用於 、 或 POSTPATCH 作業。

response類型
responseType string

回應本文 PUT的媒體類型或連結類型,適用於 、 或 POSTPATCH 作業。

title
title string

連結的標題。

型別
type string

連結的媒體類型或連結類型。

統一資源識別碼 (URI)
uri string

連結的相對 URI。

webhookCallback驗證

回呼驗證的內容。 這代表application/vnd.sas.webhook.callback.validate媒體型別(第1版)。

名稱 路徑 類型 Description
狀態
state string

說明是成功還是失敗。

resourceUri
resourceUri string

執行驗證之資源的 URI。

resourcePath (資源路徑)
resourcePath string

資料夾中資源的路徑。

資源版本
resourceVersion string

執行驗證的資源版本。

validationType
validationType string

在資源上執行的驗證類型。

links
links array of link

零個或多個相關資源或作業的連結。

版本
version integer

此媒體類型的結構描述版本號碼。 此表示法是版本 1。

webhookCallbackPublish

回呼發佈的內容。 這代表application/vnd.sas.webhook.callback.publish媒體型別(第1版)。

名稱 路徑 類型 Description
resourceUri
resourceUri string

已發佈資源的 URI。

resourcePath (資源路徑)
resourcePath string

資料夾中資源的路徑。

資源版本
resourceVersion string

已發佈資源的版本。

destinationType
destinationType string

發佈資源的目的地類型。

取代
replace boolean

指出資源是第一次發佈還是取代。

links
links array of link

零個或多個相關資源或作業的連結。

版本
version integer

此媒體類型的結構描述版本號碼。 此表示法是版本 1。

webhookCallback一般

一般回呼的內容。

名稱 路徑 類型 Description
links
links array of link

零個或多個相關資源或作業的連結。

版本
version integer

此媒體類型的結構描述版本號碼。 此表示法是版本 1。