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 を参照してください。

前提条件

ユーザーには、既存の SAS Intelligent Decision ライセンスが必要です。
ユーザーは、SAS Intelligent Decisioning 環境を構成して、Azure IP 範囲で説明されている IP アドレスからの呼び出しを許可する必要があります。

SAS Decisioning コネクタの使用方法

クライアントアプリケーションを登録します。
SAS Viya 環境への接続に使用するアクセストークンを取得します。
SAS Viya 環境に接続します。

クライアントを登録しています

SAS Viya REST API を使用するすべてのアプリケーションおよびスクリプトは、SAS 環境で登録する必要があります。 SAS 管理者は、SAS Logon Manager の OAuth サービスを使用してアクセストークンを要求し、クライアントを登録する必要があります。 SAS Logon Manager は、SAS Configuration Server からの有効なトークンを含む要求に応答して、OAuth アクセストークンを発行します。 SAS Decisioning コネクタは、API キーとして OAuth ベアラートークンを使用します。

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

有効な 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
```

/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 の応答を返します。

/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 変数には、実行の出力が含まれています。

ステップの実行

操作 ID:: executeStep

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

パラメーター

名前	キー	必須	型	説明
モジュール	moduleId	True	string	実行するステップを含むモジュールの識別子。
ステップ	stepId	True	string	実行するステップの識別子。
名前	name		string	変数の名前。
値	value			変数の値。

戻り値

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

ステップの出力: stepOutput

トリガー

リソースの検証時	任意のスコアリングイベントを実行するための新しい Webhook を作成します。
リソースの発行時	公開イベント用の新しい webhook を作成します。
事前定義のイベントが発生した場合	事前定義のコールバックコンテンツタイプイベント用の新しい webhook を作成します。

リソースの検証時

操作 ID:: createValidateWebhook

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

パラメーター

名前	キー	必須	型	説明
リソースパスの接頭辞	resourcePath	True	string	フォルダー内のリソースのパスです。
州	state	True	string

戻り値

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

Webhook コールバック検証: webhookCallbackValidate

リソースの発行時

操作 ID:: createPublishWebhook

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

パラメーター

名前	キー	必須	型	説明
リソースパスの接頭辞	resourcePath	True	string	フォルダー内のリソースのパスです。
公開先の種類	destinationType	True	string

戻り値

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

Webhook コールバック公開: webhookCallbackPublish

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

操作 ID:: createGenericWebhook

事前定義のコールバックコンテンツタイプイベント用の新しい 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	`PUT`、`POST`、または `PATCH` の操作に対する応答本文の項目のメディアタイプまたはリンクタイプ。
responseType	responseType	string	`PUT`、`POST`、または `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 です。

SAS Decisioning (プレビュー)

前提条件

SAS Decisioning コネクタの使用方法

クライアントを登録しています

アクセス トークンを取得する

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

接続の作成

既定

調整制限

アクション

ステップの実行

パラメーター

戻り値

トリガー

リソースの検証時

パラメーター

戻り値

リソースの発行時

パラメーター

戻り値

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

パラメーター

戻り値

定義

anyVariableValue

stepOutput

変数

リンク

webhookCallbackValidate

webhookCallbackPublish

webhookCallbackGeneric

その他のリソース

アクセストークンを取得する