Rozhodování SAS (Preview)

Rozhodování SAS kombinuje AI a obchodní pravidla k automatizaci provozních rozhodnutí ve velkém měřítku. Pomocí tohoto konektoru můžete spouštět rozhodovací modely nasazené na platformě SAS Viya.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Podpora SAS
URL https://support.sas.com
Email support@sas.com
Metadata konektoru
Vydavatel SAS Institute, Inc.
Internetová stránka https://www.sas.com
Zásady ochrany osobních údajů https://www.sas.com/en_us/legal/privacy.html
Kategorie Umělá inteligence; Data

Inteligentní rozhodování SAS pro SAS Viya kombinuje správu obchodních pravidel, zpracování rozhodnutí, detekci událostí v reálném čase, řízení rozhodování a výkonné pokročilé analýzy SAS pro automatizaci a správu rozhodnutí v celém podniku. Inteligentní rozhodování SAS pomáhá urychlit operacionalizaci analytických modelů, včetně modelů SAS i modelů vyvinutých pomocí opensourcových architektur. Podporuje rozhodovací proces v úvěrových službách, prevenci podvodů, výrobě, personalizovaném marketingu a mnoha dalších případech použití.

Konektor pro rozhodování SAS umožňuje uživatelům připojit se ke svému prostředí SAS Viya a spouštět vybrané rozhodovací moduly a analytické modely. Mezi příklady případů použití konektoru pro rozhodování SAS patří:

  • Určení, jestli obsah e-mailu vyhovuje firemním zásadám společnosti
  • Určení skóre žadatele o zaměstnání na základě zpětné vazby na pohovor
  • Určení skóre prodejní příležitosti
  • Určení, jestli je faktura legitimní
  • Automatické schválení vyúčtování výdajů

Další informace o inteligentním rozhodování SAS a vyžádání bezplatné zkušební verze najdete na stránce https://www.sas.com/en_us/software/intelligent-decisioning.html.

Požadavky

  1. Uživatel musí mít existující licenci SAS Intelligent Decisioning.
  2. Uživatel musí nakonfigurovat prostředí inteligentního rozhodování SAS tak, aby umožňovalo volání přicházející z IP adres popsaných v rozsazích IP adres Azure.

Jak používat konektor pro rozhodování SAS

  1. Zaregistrujte klientské aplikace.
  2. Získejte přístupový token pro použití při připojování k prostředí SAS Viya.
  3. Připojte se k prostředí SAS Viya.

Registrace klientů

Všechny aplikace a skripty, které používají rozhraní SAS Viya REST API, musí být zaregistrované v prostředí SAS. Správce SAS musí ke vyžádání přístupového tokenu a registraci klienta použít službu OAuth ve Správci přihlášení SAS. Správce přihlášení SAS vydává přístupové tokeny OAuth v reakci na požadavky, které obsahují platný token z konfiguračního serveru SAS. Konektor pro rozhodování SAS jako klíč rozhraní API používá nosný token OAuth.

Registrace klienta:

  1. Vyhledejte platný token Consul. Správce SAS může najít token v souboru client.token v /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default podu sas-consul-server-0 . Pokud chcete načíst řetězec tokenu Consul v systému Linux, spusťte následující příkaz:

    kubectl exec sas-consul-server-0 -- \
    cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token

  2. Požádejte o token OAuth odesláním požadavku na /SASLogon/oauth/clients/consul. Zadejte token Consul z kroku 1 v X-Consul-Token poli. Pokud například chcete požádat o token pro klienta s názvem app, odešlete následující příkaz:

    curl -X POST "https://server.example.com/SASLogon/oauth/clients/consul?callback=false&serviceId=app" \
      -H "X-Consul-Token: <consul-token-from-step-1>"
    Parametr dotazu Description
    zpětné volání Zadejte false , aby se v odpovědi získal přístupový token. Jinak se token odešle službě zaregistrované na konfiguračním serveru SAS.
    ID služby Zadejte název klienta, kterého chcete zaregistrovat.

    V reakci na požadavek vrátí Správce přihlášení SAS odpověď JSON, která obsahuje přístupový token v poli access_token .

  3. Zaregistrujte klientskou aplikaci odesláním žádosti na /SASLogon/oauth/clientsadresu . Zadejte přístupový token vrácený v kroku 2 jako hodnotu hlavičky 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
     }'

    Spropitné: Ve výchozím nastavení je token platný po dobu 12 hodin (nebo 43200 sekund). Pokud chcete nastavit kratší nebo delší dobu trvání, nastavte access_token_validity pole podle potřeby pomocí celočíselné hodnoty pro dobu v sekundách.

    Poznámka: Podporují se další authorized_grant_types, ale konektor pro rozhodování SAS v současné době očekává client_credentials typ udělení.

Pokud je žádost úspěšná, klient se zaregistruje. Úspěšná odpověď JSON vypadá podobně jako v následujícím příkladu:

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

Získání přístupových tokenů

Zaregistrovaní klienti mohou požádat o přístupový token pomocí rozhraní API SAS Logon OAuth. Pokud chcete požádat o přístupový token, zadejte do koncového /SASLogon/oauth/token bodu požadavek a zadejte formulář autorizace. Autorizace se vyjadřuje ve formě udělení autorizace. V současné době rozhraní SAS Viya REST API podporují typ grantu client_credentials .

Například při zadání identifikátoru klienta "myclient" s tajným kódem mysecret můžete požádat o token následujícím způsobem:

    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"

Odpověď JSON obsahuje pole s názvem access_token , které obsahuje hodnotu tokenu používaného konektorem pro rozhodování SAS k vytvoření připojení Power Automate. Po vypršení platnosti tokenu odešlete do koncového /SASLogon/oauth/token bodu nový požadavek.

Připojení k prostředí SAS Viya

Pokud se chcete připojit k prostředí SAS Viya, budete potřebovat následující informace:

Název parametru Description
Adresa URL prostředí SAS Viya Adresa URL nasazení inteligentního rozhodování SAS Příklad: https://server.example.com
Autorizační token Přístupový token vrácený příkazem v části Získání přístupových tokenů výše. Předpona tokenu .Bearer

Připojení se dá sdílet mezi uživateli.

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Sdíletelný

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs

Název Typ Description Povinné
Adresa URL prostředí SAS Viya řetězec Zadání adresy URL prostředí SAS Viya Pravdivé
Autorizační token securestring Autorizační token pro toto rozhraní API Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Krok spuštění

Provede krok se zadanými vstupními hodnotami. Proměnná outputs v odpovědi obsahuje výstup spuštění.

Krok spuštění

ID operace:
executeStep

Provede krok se zadanými vstupními hodnotami. Proměnná outputs v odpovědi obsahuje výstup spuštění.

Parametry

Name Klíč Vyžadováno Typ Description
modul
 moduleId True string

Identifikátor modulu, který obsahuje krok ke spuštění.
krokovat
 stepId True string

Identifikátor kroku, který se má provést.
název
 name string

Název proměnné.
value
 value

Hodnota proměnné.

Návraty

Tento typ popisuje výstupní hodnoty, které se vrátí při spuštění kroku.

Výstup kroku
stepOutput

Aktivační události

Při ověření prostředku

Vytvoří nový webhook pro dokončení jakékoli události vyhodnocování.
Při publikování prostředku

Vytvoří nový webhook pro událost publikování.
Při předdefinované události

Vytvoří nový webhook pro předem definovanou událost typu obsahu zpětného volání.

Při ověření prostředku

ID operace:
createValidateWebhook

Vytvoří nový webhook pro dokončení jakékoli události vyhodnocování.

Parametry

Name Klíč Vyžadováno Typ Description
Předpona cesty k prostředku
 resourcePath True string

Cesta k prostředku ve složce
Stát
 state True string

Návraty

Obsah zpětného volání se ověří. Představuje typ média application/vnd.sas.webhook.callback.validate (verze 1).

Ověření zpětného volání webhooku
webhookCallbackValidate

Při publikování prostředku

ID operace:
createPublishWebhook

Vytvoří nový webhook pro událost publikování.

Parametry

Name Klíč Vyžadováno Typ Description
Předpona cesty k prostředku
 resourcePath True string

Cesta k prostředku ve složce
Typ cíle
 destinationType True string

Návraty

Obsah publikování zpětného volání Představuje typ média application/vnd.sas.webhook.callback.publish (verze 1).

Publikování zpětného volání webhooku
webhookCallbackPublish

Při předdefinované události

ID operace:
createGenericWebhook

Vytvoří nový webhook pro předem definovanou událost typu obsahu zpětného volání.

Parametry

Name Klíč Vyžadováno Typ Description
Typ obsahu zpětného volání
 callbackContentType True string

Typ obsahu zpětného volání
Filtr obsahu zpětného volání
 callbackContentFilter string

Vyfiltrujte obsah zpětného volání.

Návraty

Obsah obecného zpětného volání.

Obecná zpětná volání webhooku
webhookCallbackGeneric

Definice

anyVariableValue

Hodnota proměnné.

Hodnota proměnné.

stepOutput

Tento typ popisuje výstupní hodnoty, které se vrátí při spuštění kroku.

Name Cesta Typ Description
moduleId
 moduleId string

Identifikátor modulu, který obsahuje spuštěný krok.
stepId
 stepId string

Název kroku, který vytvořil tento výstup.
výstupy
 outputs array of variable

Výstupní hodnoty vrácené z provedeného kroku. Pořadí proměnných odpovídá pořadí uvedenému ve výstupním podpisu.

proměnná

Dvojice název/hodnota, která představuje vstupní nebo výstupní proměnnou.

Name Cesta Typ Description
name string

Název proměnné.
value
 value anyVariableValue

Hodnota proměnné.

odkaz

Name Cesta Typ Description
href
 href string

Adresa URL odkazu.
Typ položky
 itemType string

Pokud se jedná o odkaz na kontejner, itemType je typ média nebo typ propojení pro položky v kontejneru.
metoda
 method string

Metoda HTTP pro odkaz.
Rel
 rel string

Vztah propojení s prostředkem
responseItemType
 responseItemType string

Typ média nebo typ propojení položek v textu odpovědi pro PUToperaci , POSTnebo PATCH operace.
Typ odpovědi
 responseType string

Typ média nebo typ propojení textu odpovědi pro PUToperaci , POSTnebo PATCH operace.
title
 title string

Název odkazu.
typ
 type string

Typ média nebo typ propojení odkazu.
URI
 uri string

Relativní identifikátor URI odkazu.

webhookCallbackValidate

Obsah zpětného volání se ověří. Představuje typ média application/vnd.sas.webhook.callback.validate (verze 1).

Name Cesta Typ Description
stav
 state string

Uveďte, jestli se jedná o úspěch nebo neúspěch.
resourceUri
 resourceUri string

Identifikátor URI prostředku, na kterém se provádí ověření.
cesta k prostředku
 resourcePath string

Cesta k prostředku ve složce
resourceVersion
 resourceVersion string

Verze prostředku, na kterém se provádí ověření.
validationType
 validationType string

Typ ověření, které se provádí u prostředku.
links
 links array of link

Nulové nebo více odkazů na související prostředky nebo operace.
verze
 version integer

Číslo verze schématu tohoto typu média. Tato reprezentace je verze 1.

webhookCallbackPublish

Obsah publikování zpětného volání Představuje typ média application/vnd.sas.webhook.callback.publish (verze 1).

Name Cesta Typ Description
resourceUri
 resourceUri string

Identifikátor URI prostředku, který je publikovaný.
cesta k prostředku
 resourcePath string

Cesta k prostředku ve složce
resourceVersion
 resourceVersion string

Verze prostředku, který je publikovaný.
destinationType
 destinationType string

Typ cíle, do kterého se prostředek publikuje.
nahradit
 replace boolean

Označuje, jestli je zdroj poprvé publikovaný nebo nahrazený.
links
 links array of link

Nulové nebo více odkazů na související prostředky nebo operace.
verze
 version integer

Číslo verze schématu tohoto typu média. Tato reprezentace je verze 1.

webhookCallbackGeneric

Obsah obecného zpětného volání.

Name Cesta Typ Description
links
 links array of link

Nulové nebo více odkazů na související prostředky nebo operace.
verze
 version integer

Číslo verze schématu tohoto typu média. Tato reprezentace je verze 1.