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
変数には、実行の出力が含まれています。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
モジュール
|
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 |
これがコンテナーへのリンクである場合、 |
method
|
method | string |
リンクで使用する HTTP メソッド。 |
rel
|
rel | string |
リソースに対するリンクの関係。 |
responseItemType
|
responseItemType | string |
|
responseType
|
responseType | string |
|
役職
|
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 です。 |