Decisión de SAS (versión preliminar)
La toma de decisiones de SAS combina la inteligencia artificial y las reglas de negocio para automatizar las decisiones operativas a escala. Use este conector para ejecutar modelos de decisión que se implementan en la plataforma SAS Viya.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con SAS |
| URL | https://support.sas.com |
| Correo Electrónico | support@sas.com |
| Metadatos del conector | |
|---|---|
| Publicador | SAS Institute, Inc. |
| Sitio web | https://www.sas.com |
| Directiva de privacidad | https://www.sas.com/en_us/legal/privacy.html |
| Categorías | IA; Datos |
SAS Intelligent Decisioning on SAS Viya combina administración de reglas de negocio, procesamiento de decisiones, detección de eventos en tiempo real, gobernanza de decisiones y análisis avanzados de SAS eficaces para automatizar y administrar decisiones en toda la empresa. La toma de decisiones inteligentes de SAS ayuda a acelerar la operacionalización de los modelos analíticos, incluidos los modelos SAS y los desarrollados con marcos de código abierto. Apoya el proceso de toma de decisiones en servicios de crédito, prevención de fraudes, fabricación, marketing personalizado y muchos otros casos de uso.
El conector de decisión de SAS permite a los usuarios conectarse a su entorno de SAS Viya y ejecutar módulos de decisión seleccionados y modelos analíticos. Entre los casos de uso de ejemplo del conector de decisión de SAS se incluyen:
- Determinar si el contenido del correo electrónico cumple con la directiva corporativa de una empresa
- Puntuación de un solicitante de empleo en función de los comentarios de la entrevista
- Puntuación de una oportunidad de ventas
- Determinar si una factura es legítima
- Aprobar automáticamente un informe de gastos
Para más información sobre la toma de decisiones inteligentes de SAS y para solicitar una evaluación gratuita, visite https://www.sas.com/en_us/software/intelligent-decisioning.html.
Prerrequisitos
- El usuario debe tener una licencia de toma de decisiones inteligentes saS existente.
- El usuario debe configurar el entorno de decisión inteligente de SAS para permitir llamadas procedentes de las direcciones IP descritas en Intervalos IP de Azure.
Uso del conector de decisión de SAS
- Registre las aplicaciones cliente.
- Obtenga un token de acceso para usarlo para conectarse al entorno de SAS Viya.
- Conéctese al entorno de SAS Viya.
Registro de clientes
Todas las aplicaciones y scripts que usan las API REST de SAS Viya deben registrarse con el entorno de SAS. El administrador de SAS debe usar el servicio OAuth en el Administrador de inicio de sesión de SAS para solicitar un token de acceso y registrar un cliente. El Administrador de inicio de sesión de SAS emite tokens de acceso de OAuth en respuesta a las solicitudes que contienen un token válido del servidor de configuración de SAS. SaS Decisioning Connector usa un token de portador de OAuth como clave de API.
Para registrar un cliente:
Busque un token de Consul válido. Un administrador de SAS puede encontrar un token en el archivo client.token en
/opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/defaultdentro delsas-consul-server-0pod. Para recuperar la cadena de token de Consul en un sistema Linux, ejecute el siguiente comando:kubectl exec sas-consul-server-0 -- \ cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.tokenSolicite un token de OAuth publicando una solicitud en
/SASLogon/oauth/clients/consul. Especifique el token de Consul del paso 1 en elX-Consul-Tokencampo . Por ejemplo, para solicitar un token para un cliente denominadoapp, envíe el siguiente comando:curl -X POST "https://server.example.com/SASLogon/oauth/clients/consul?callback=false&serviceId=app" \ -H "X-Consul-Token: <consul-token-from-step-1>"Parámetro de consulta Description Callback Especifique falsepara recibir un token de acceso en la respuesta. De lo contrario, el token se envía al servicio registrado en el servidor de configuración de SAS.serviceId Especifique el nombre del cliente que desea registrar. En respuesta a la solicitud, el Administrador de inicio de sesión de SAS devuelve una respuesta JSON que incluye un token de acceso en el campo access_token .
Registre la aplicación cliente publicando una solicitud en
/SASLogon/oauth/clients. Especifique el token de acceso que se devolvió en el paso 2 como valor delAuthorizationencabezado: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 }'Propina: De forma predeterminada, un token es válido durante 12 horas (o 43200 segundos). Para establecer una duración más corta o larga, establezca el
access_token_validitycampo según sea necesario, utilizando un valor entero durante el tiempo en segundos.Nota: Hay otros "authorized_grant_types" admitidos, pero el conector de decisión de SAS espera actualmente el tipo de
client_credentialsconcesión.
Si la solicitud se realiza correctamente, el cliente se registra. Una respuesta JSON correcta es similar a la del ejemplo siguiente:
{"scope":["openid"],"client_id":"<requested-client-id>","resource_ids":["none"],"authorized_grant_types":["client_credentials"],
"access_token_validity":43199,"authorities":["uaa.none"],"lastModified":1521124986406}
Obtención de tokens de acceso
Los clientes registrados pueden solicitar un token de acceso mediante la API de OAuth de inicio de sesión de SAS. Para solicitar un token de acceso, publique una solicitud en el /SASLogon/oauth/token punto de conexión y especifique un formulario de autorización. La autorización se expresa en forma de concesión de autorización. Actualmente, las API rest de SAS Viya admiten el tipo de client_credentials concesión.
Por ejemplo, dado un identificador de cliente de "myclient" con un secreto "mysecret", puede solicitar un token de la siguiente manera:
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"
La respuesta JSON contiene un campo denominado access_token que contiene el valor del token que usa el conector de decisión de SAS para crear conexiones de Power Automate. Cuando expire el token, publique una nueva solicitud en el /SASLogon/oauth/token punto de conexión.
Conexión al entorno de SAS Viya
Para conectarse al entorno de SAS Viya, necesitará la siguiente información:
| Nombre del parámetro | Description |
|---|---|
| DIRECCIÓN URL del entorno de SAS Viya | Dirección URL de la implementación de toma de decisiones inteligentes de SAS. Por ejemplo: https://server.example.com |
| Token de autorización | El token de acceso devuelto desde el comando en Obtención de tokens de acceso anteriores. Prefijo del token con Bearer . |
La conexión se puede compartir entre usuarios.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | Compartible |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| DIRECCIÓN URL del entorno de SAS Viya | cuerda / cadena | Especificación de la dirección URL del entorno de SAS Viya | Cierto |
| Token de autorización | securestring | Token de autorización para esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Paso de ejecución |
Ejecuta el paso con los valores de entrada especificados. La |
Paso de ejecución
Ejecuta el paso con los valores de entrada especificados. La outputs variable de la respuesta contiene la salida de la ejecución.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
módulo
|
moduleId | True | string |
Identificador del módulo que contiene el paso que se va a ejecutar. |
|
paso
|
stepId | True | string |
Identificador del paso que se va a ejecutar. |
|
nombre
|
name | string |
nombre de la variable. |
|
|
value
|
value |
Valor de la variable. |
Devoluciones
Este tipo describe los valores de salida que se devuelven cuando se ejecuta un paso.
- Salida del paso
- stepOutput
Desencadenadores
| Cuando se produjo un evento predefinido |
Crea un nuevo webhook para el evento de tipo de contenido de devolución de llamada predefinido. |
| Cuando se publica un recurso |
Crea un nuevo webhook para el evento de publicación. |
| Cuando se valida un recurso |
Crea un nuevo webhook para completar cualquier evento de puntuación. |
Cuando se produjo un evento predefinido
Crea un nuevo webhook para el evento de tipo de contenido de devolución de llamada predefinido.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de contenido de devolución de llamada
|
callbackContentType | True | string |
Tipo del contenido de devolución de llamada. |
|
Filtro de contenido de devolución de llamada
|
callbackContentFilter | string |
Filtre por el contenido de devolución de llamada. |
Devoluciones
Contenido de la devolución de llamada genérica.
- Devolución de llamada de webhook genérica
- webhookCallbackGeneric
Cuando se publica un recurso
Crea un nuevo webhook para el evento de publicación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Prefijo de ruta de acceso de recurso
|
resourcePath | True | string |
Ruta de acceso del recurso en la carpeta . |
|
Tipo de destino
|
destinationType | True | string |
Devoluciones
Contenido de la publicación de devolución de llamada. Esto representa el tipo de medio application/vnd.sas.webhook.callback.publish (versión 1).
- Publicación de devolución de llamada de webhook
- webhookCallbackPublish
Cuando se valida un recurso
Crea un nuevo webhook para completar cualquier evento de puntuación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Prefijo de ruta de acceso de recurso
|
resourcePath | True | string |
Ruta de acceso del recurso en la carpeta . |
|
Estado
|
state | True | string |
Devoluciones
El contenido de la devolución de llamada valida. Esto representa el tipo de medio application/vnd.sas.webhook.callback.validate (versión 1).
- Validación de devolución de llamada de webhook
- webhookCallbackValidate
Definiciones
anyVariableValue
stepOutput
Este tipo describe los valores de salida que se devuelven cuando se ejecuta un paso.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
moduleId
|
moduleId | string |
Identificador del módulo que contiene el paso ejecutado. |
|
stepId
|
stepId | string |
Nombre del paso que generó esta salida. |
|
Salidas
|
outputs | array of variable |
Los valores de salida que se devuelven desde un paso ejecutado. El orden de las variables coincide con el orden presentado en la firma de salida. |
variable
Par nombre-valor que representa una variable de entrada o salida.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
name | string |
nombre de la variable. |
|
value
|
value | anyVariableValue |
Valor de la variable. |
link
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
href
|
href | string |
Dirección URL del vínculo. |
|
tipo de artículo
|
itemType | string |
Si se trata de un vínculo a un contenedor, |
|
method
|
method | string |
Método HTTP para el vínculo. |
|
rel
|
rel | string |
Relación del vínculo al recurso. |
|
responseItemType
|
responseItemType | string |
Tipo de medio o tipo de vínculo de los elementos del cuerpo de la respuesta para una |
|
responseType
|
responseType | string |
Tipo de medio o tipo de vínculo del cuerpo de la respuesta para una |
|
title
|
title | string |
Título del vínculo. |
|
type
|
type | string |
Tipo de medio o tipo de vínculo para el vínculo. |
|
Uri
|
uri | string |
Identificador URI relativo del vínculo. |
webhookCallbackValidate
El contenido de la devolución de llamada valida. Esto representa el tipo de medio application/vnd.sas.webhook.callback.validate (versión 1).
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
state | string |
Indica si es correcto o erróneo. |
|
resourceUri
|
resourceUri | string |
Uri del recurso en el que se realiza la validación. |
|
resourcePath
|
resourcePath | string |
Ruta de acceso del recurso en la carpeta . |
|
resourceVersion
|
resourceVersion | string |
Versión del recurso en el que se realiza la validación. |
|
validationType
|
validationType | string |
Tipo de la validación que se realiza en el recurso. |
|
Enlaces
|
links | array of link |
Cero o más vínculos a recursos o operaciones relacionados. |
|
version
|
version | integer |
Número de versión del esquema de este tipo de medio. Esta representación es la versión 1. |
webhookCallbackPublish
Contenido de la publicación de devolución de llamada. Esto representa el tipo de medio application/vnd.sas.webhook.callback.publish (versión 1).
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
resourceUri
|
resourceUri | string |
Uri del recurso que se publica. |
|
resourcePath
|
resourcePath | string |
Ruta de acceso del recurso en la carpeta . |
|
resourceVersion
|
resourceVersion | string |
Versión del recurso que se publica. |
|
destinationType
|
destinationType | string |
Tipo del destino donde se publica el recurso. |
|
replace
|
replace | boolean |
Indica si el recurso se publica por primera vez o se reemplaza. |
|
Enlaces
|
links | array of link |
Cero o más vínculos a recursos o operaciones relacionados. |
|
version
|
version | integer |
Número de versión del esquema de este tipo de medio. Esta representación es la versión 1. |
webhookCallbackGeneric
Contenido de la devolución de llamada genérica.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Enlaces
|
links | array of link |
Cero o más vínculos a recursos o operaciones relacionados. |
|
version
|
version | integer |
Número de versión del esquema de este tipo de medio. Esta representación es la versión 1. |