Compartir a través de


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

  1. El usuario debe tener una licencia de toma de decisiones inteligentes saS existente.
  2. 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

  1. Registre las aplicaciones cliente.
  2. Obtenga un token de acceso para usarlo para conectarse al entorno de SAS Viya.
  3. 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:

  1. 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/default dentro del sas-consul-server-0 pod. 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.token
    
  2. Solicite un token de OAuth publicando una solicitud en /SASLogon/oauth/clients/consul. Especifique el token de Consul del paso 1 en el X-Consul-Token campo . Por ejemplo, para solicitar un token para un cliente denominado app, 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 false para 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 .

  3. 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 del Authorization encabezado:

    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_validity campo 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_credentials concesió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 outputs variable de la respuesta contiene la salida de la ejecución.

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

Valor de la variable.

Valor de la variable.

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.

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, itemType es el tipo de medio o el tipo de vínculo para los elementos del 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 PUToperación , POSTo PATCH .

responseType
responseType string

Tipo de medio o tipo de vínculo del cuerpo de la respuesta para una PUToperación , POSTo PATCH .

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.