SAS Decisioning (プレビュー)

SAS Decisioning は、AI とビジネス ルールを組み合わせて、大規模な経営に関する意思決定を自動化します。 このコネクタを使用して、SAS Viya プラットフォームに展開されている意思決定モデルを実行します。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 SAS サポート
[URL] https://support.sas.com
メール support@sas.com
Connector Metadata
発行者 SAS Institute, Inc.
Web サイト https://www.sas.com
プライバシー ポリシー https://www.sas.com/en_us/legal/privacy.html
カテゴリ AI; データ

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 Decision ライセンスが必要です。
  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 は、SAS Configuration Server からの有効なトークンを含む要求に応答して、OAuth アクセス トークンを発行します。 SAS Decisioning コネクタは、API キーとして OAuth ベアラー トークンを使用します。

クライアントを登録するには:

  1. 有効な Consul トークンを検索します。 SAS 管理者は、sas-consul-server-0 ポッドの中の /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default にある client.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 に要求を送信して、OAuth トークンを要求します。 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>"
    
    クエリ パラメーター 内容
    callback 応答の中でアクセス トークンを受信するために、false を指定します。 それ以外の場合は、トークンは SAS Configuration Server に登録されているサービスに送信されます。
    serviceId 登録するクライアントの名前を指定します。

    要求に応答し、SAS Logon Manager は access_token フィールドにアクセス トークンを含む JSON の応答を返します。

  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 応答には、SAS Decisioning コネクタが Power Automate 接続を作成するために使用するトークンの値を含む access_token という名前のフィールドが含まれています。 トークンが期限切れになるとき、新しい要求を /SASLogon/oauth/token エンドポイントに送信します。

SAS Viya 環境に接続しています

SAS Viya 環境に接続し、次の情報を入力する必要があります。

パラメーター名 内容
SAS Viya 環境の URL SAS Intelligent Decisioning 配置の URL。 例: https://server.example.com
認証トークン 上記のアクセス トークンを取得するのコマンドから返されたアクセス トークン。 トークンに Bearer というプレフィックスを付けます。

接続はユーザー間で共有できます。

接続の作成

コネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべてのリージョン 共有可能

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください

件名 タイプ 内容 必要
SAS Viya 環境の URL 文字列 SAS Viya 環境の URL を指定する
認証トークン securestring この API の認証トークン True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

ステップの実行

指定された入力値でステップを実行します。 返信される outputs 変数には、実行の出力が含まれています。

ステップの実行

指定された入力値でステップを実行します。 返信される outputs 変数には、実行の出力が含まれています。

パラメーター

名前 キー 必須 説明
モジュール
moduleId True string

実行するステップを含むモジュールの識別子。

ステップ
stepId True string

実行するステップの識別子。

名前
name string

変数の名前。

value

変数の値。

戻り値

この型は、ステップが実行されたときに返される出力値を示します。

ステップの出力
stepOutput

トリガー

リソースの検証時

任意のスコアリング イベントを実行するための新しい Webhook を作成します。

リソースの発行時

公開イベント用の新しい webhook を作成します。

事前定義のイベントが発生した場合

事前定義のコールバック コンテンツ タイプ イベント用の新しい webhook を作成します。

リソースの検証時

任意のスコアリング イベントを実行するための新しい Webhook を作成します。

パラメーター

名前 キー 必須 説明
リソース パスの接頭辞
resourcePath True string

フォルダー内のリソースのパスです。

state True string

戻り値

コールバック検証のコンテンツ。 これは application/vnd.sas.webhook.callback.validate メディア タイプ (バージョン 1) を表します。

Webhook コールバック検証
webhookCallbackValidate

リソースの発行時

公開イベント用の新しい webhook を作成します。

パラメーター

名前 キー 必須 説明
リソース パスの接頭辞
resourcePath True string

フォルダー内のリソースのパスです。

公開先の種類
destinationType True string

戻り値

コールバック公開のコンテンツ。 これは application/vnd.sas.webhook.callback.publish メディア タイプ (バージョン 1) を表します。

Webhook コールバック公開
webhookCallbackPublish

事前定義のイベントが発生した場合

事前定義のコールバック コンテンツ タイプ イベント用の新しい webhook を作成します。

パラメーター

名前 キー 必須 説明
コールバック コンテンツ タイプ
callbackContentType True string

コールバック コンテンツの種類です。

コールバック コンテンツ フィルター
callbackContentFilter string

コールバック コンテンツのフィルターです。

戻り値

汎用コールバックのコンテンツ。

Webhook の汎用コールバック
webhookCallbackGeneric

定義

anyVariableValue

変数の値。

変数の値。

stepOutput

このタイプは、ステップが実行されたときに返される出力値を説明しています。

名前 パス 説明
moduleId
moduleId string

実行されたステップを含むモジュールの識別子。

stepId
stepId string

この出力を生成したステップの名前。

出力
outputs array of variable

実行されたステップから返される出力値。 変数の順序は、出力署名に表示されている順序と一致します。

変数

入力変数または出力変数を表す名前/値ペア。

名前 パス 説明
name string

変数の名前。

価値
value anyVariableValue

変数の値。

リンク

名前 パス 説明
href
href string

リンクの URL。

itemType
itemType string

これがコンテナーへのリンクである場合、itemType はコンテナー内のアイテムに対するメディア タイプまたはリンク タイプです。

method
method string

リンクで使用する HTTP メソッド。

rel
rel string

リソースに対するリンクの関係。

responseItemType
responseItemType string

PUTPOST、または PATCH の操作に対する応答本文の項目のメディア タイプまたはリンク タイプ。

responseType
responseType string

PUTPOST、または PATCH の操作に対する応答本文のメディア タイプまたはリンク タイプ。

役職
title string

リンクのタイトル。

type
type string

リンクのメディア タイプまたはリンク タイプ。

uri
uri string

リンクの相対 URI。

webhookCallbackValidate

コールバック検証のコンテンツ。 これは application/vnd.sas.webhook.callback.validate メディア タイプ (バージョン 1) を表します。

名前 パス 説明
都道府県
state string

成功か失敗かを示します。

resourceUri
resourceUri string

検証が実行されるリソースの URI です。

resourcePath
resourcePath string

フォルダー内のリソースのパスです。

resourceVersion
resourceVersion string

検証が実行されるリソースのバージョンです。

validationType
validationType string

リソースで実行される検証の種類です。

links
links array of link

関連するリソースまたは操作に対し、ゼロ以上のリンクが存在します。

version
version integer

このメディア タイプのスキーマ バージョン番号。 この表現はバージョン 1 です。

webhookCallbackPublish

コールバック公開のコンテンツ。 これは application/vnd.sas.webhook.callback.publish メディア タイプ (バージョン 1) を表します。

名前 パス 説明
resourceUri
resourceUri string

公開されているリソースの URI です。

resourcePath
resourcePath string

フォルダー内のリソースのパスです。

resourceVersion
resourceVersion string

公開済みリソースのバージョンです。

destinationType
destinationType string

リソースを公開する宛先の種類。

replace
replace boolean

リソースが最初に公開されたかどうか、または、置き換えられるかを示します。

links
links array of link

関連するリソースまたは操作に対し、ゼロ以上のリンクが存在します。

version
version integer

このメディア タイプのスキーマ バージョン番号。 この表現はバージョン 1 です。

webhookCallbackGeneric

汎用コールバックのコンテンツ。

名前 パス 説明
links
links array of link

関連するリソースまたは操作に対し、ゼロ以上のリンクが存在します。

version
version integer

このメディア タイプのスキーマ バージョン番号。 この表現はバージョン 1 です。