Partilhar via


Decisão SAS (Pré-visualização)

O SAS Decisioning combina IA e regras de negócios para automatizar decisões operacionais em escala. Use este conector para executar modelos de decisão que são implantados na plataforma SAS Viya.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte SAS
URL https://support.sas.com
Email support@sas.com
Metadados do conector
Editora Instituto SAS, Inc.
Sítio Web https://www.sas.com
Política de privacidade https://www.sas.com/en_us/legal/privacy.html
Categorias IA; Dados

O SAS Intelligent Decisioning no SAS Viya combina gerenciamento de regras de negócios, processamento de decisões, deteção de eventos em tempo real, governança de decisões e poderosas análises avançadas SAS para automatizar e gerenciar decisões em toda a empresa. O SAS Intelligent Decisioning ajuda a agilizar a operacionalização de modelos analíticos, incluindo modelos SAS e aqueles desenvolvidos com estruturas de código aberto. Ele suporta o processo de decisão em serviços de crédito, prevenção de fraudes, fabricação, marketing personalizado e muitos outros casos de uso.

O conector SAS Decisioning permite que os usuários se conectem ao seu ambiente SAS Viya e executem módulos de decisão e modelos analíticos selecionados. Exemplos de casos de uso para o conector SAS Decisioning incluem:

  • Determinar se o conteúdo do e-mail está em conformidade com a política corporativa de uma empresa
  • Pontuar um candidato a emprego com base no feedback da entrevista
  • Marcar uma oportunidade de vendas
  • Determinar se uma fatura é legítima
  • Aprovar automaticamente um relatório de despesas

Para saber mais sobre o SAS Intelligent Decisioning e solicitar uma avaliação gratuita, visite https://www.sas.com/en_us/software/intelligent-decisioning.html.

Pré-requisitos

  1. O usuário deve ter uma licença SAS Intelligent Decisioning existente.
  2. O usuário deve configurar o ambiente de Decisão Inteligente SAS para permitir chamadas provenientes dos Endereços IP descritos em Intervalos de IP do Azure.

Como usar o conector de decisão SAS

  1. Registe as suas aplicações cliente.
  2. Obtenha um token de acesso para uso na conexão ao seu ambiente SAS Viya.
  3. Conecte-se ao seu ambiente SAS Viya.

Registo de clientes

Todos os aplicativos e scripts que usam APIs REST do SAS Viya devem ser registrados no ambiente SAS. O administrador SAS deve usar o serviço OAuth no SAS Logon Manager para solicitar um token de acesso e registrar um cliente. O SAS Logon Manager emite tokens de acesso OAuth em resposta a solicitações que contêm um token válido do Servidor de Configuração SAS. O SAS Decisioning Connector usa um token OAuth Bearer como uma chave de API.

Para registar um cliente:

  1. Localize um token Consul válido. Um administrador SAS pode encontrar um token no arquivo client.token dentro /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default do sas-consul-server-0 pod. Para recuperar a cadeia de caracteres do token Consul em um sistema Linux, execute o seguinte comando:

    kubectl exec sas-consul-server-0 -- \
        cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token
    
  2. Solicite um token OAuth postando uma solicitação no /SASLogon/oauth/clients/consul. Especifique o token Consul da etapa 1 no X-Consul-Token campo. Por exemplo, para solicitar um token para um cliente chamado app, envie o seguinte 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
    chamada de retorno Especifique false para receber um token de acesso na resposta. Caso contrário, o token será enviado para o serviço registrado no SAS Configuration Server.
    serviceId Especifique o nome do cliente que você deseja registrar.

    Em resposta à solicitação, o SAS Logon Manager retorna uma resposta JSON que inclui um token de acesso no campo access_token .

  3. Registre o aplicativo cliente postando uma solicitação para /SASLogon/oauth/clients. Especifique o token de acesso que foi retornado na etapa 2 como o valor do Authorization cabeçalho:

    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
         }'
    

    Dica: Por padrão, um token é válido por 12 horas (ou 43200 segundos). Para definir uma duração menor ou maior, defina o access_token_validity campo conforme necessário, usando um valor inteiro para o tempo em segundos.

    Observação: Existem outros "authorized_grant_types" suportados, mas o conector SAS Decisioning atualmente espera o client_credentials tipo de concessão.

Se o pedido for bem-sucedido, o cliente é registado. Uma resposta JSON bem-sucedida é semelhante ao exemplo a seguir:

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

Obtenção de tokens de acesso

Os clientes registrados podem solicitar um token de acesso usando a API OAuth de logon SAS. Para solicitar um token de acesso, publique uma solicitação no /SASLogon/oauth/token ponto de extremidade e especifique uma forma de autorização. A autorização é expressa sob a forma de uma concessão de autorização. Atualmente, as APIs REST do SAS Viya suportam o client_credentials tipo de concessão.

Por exemplo, dado um identificador de cliente de "myclient" com um segredo "mysecret", você pode solicitar um token da seguinte maneira:

    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"

A resposta JSON contém um campo chamado access_token que contém o valor do token usado pelo conector de decisão SAS para criar conexões Power Automatic. Quando o token expirar, publique uma nova solicitação no /SASLogon/oauth/token ponto de extremidade.

Conectando-se ao seu ambiente SAS Viya

Para se conectar ao seu ambiente SAS Viya, você precisará das seguintes informações:

Nome do parâmetro Description
URL do ambiente SAS Viya URL da implantação do SAS Intelligent Decisioning. Por exemplo: https://server.example.com
Token de autorização O token de acesso retornado do comando em Obtendo tokens de acesso acima. Prefira o token com Bearer .

A conexão pode ser compartilhada entre os usuários.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome Tipo Description Obrigatório
URL do ambiente SAS Viya cadeia (de caracteres) Especificar URL do ambiente SAS Viya Verdade
Token de autorização securestring O token de autorização para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Executar etapa

Executa a etapa com os valores de entrada especificados. A outputs variável na resposta contém a saída da execução.

Executar etapa

Executa a etapa com os valores de entrada especificados. A outputs variável na resposta contém a saída da execução.

Parâmetros

Name Chave Necessário Tipo Description
módulo
moduleId True string

O identificador do módulo que contém a etapa a ser executada.

passo a passo
stepId True string

O identificador da etapa a ser executada.

nome
name string

Nome da variável.

valor
value

O valor da variável.

Devoluções

Esse tipo descreve os valores de saída que são retornados quando uma etapa é executada.

Saída da etapa
stepOutput

Acionadores

Quando um evento pré-definido aconteceu

Cria um novo webhook para o evento de tipo de conteúdo de retorno de chamada predefinido.

Quando um recurso é publicado

Cria um novo webhook para o evento de publicação.

Quando um recurso é validado

Cria um novo webhook para a conclusão de qualquer evento de pontuação.

Quando um evento pré-definido aconteceu

Cria um novo webhook para o evento de tipo de conteúdo de retorno de chamada predefinido.

Parâmetros

Name Chave Necessário Tipo Description
Tipo de conteúdo de retorno de chamada
callbackContentType True string

Tipo de conteúdo de retorno de chamada.

Filtro de conteúdo de retorno de chamada
callbackContentFilter string

Filtre o conteúdo do retorno de chamada.

Devoluções

O conteúdo do retorno de chamada genérico.

Webhook Callback Genérico
webhookCallbackGeneric

Quando um recurso é publicado

Cria um novo webhook para o evento de publicação.

Parâmetros

Name Chave Necessário Tipo Description
Prefixo do caminho do recurso
resourcePath True string

Caminho do recurso na pasta.

Tipo de destino
destinationType True string

Devoluções

O conteúdo do retorno de chamada publica. Isso representa o tipo de mídia application/vnd.sas.webhook.callback.publish (versão 1).

Webhook Callback Publicar
webhookCallbackPublish

Quando um recurso é validado

Cria um novo webhook para a conclusão de qualquer evento de pontuação.

Parâmetros

Name Chave Necessário Tipo Description
Prefixo do caminho do recurso
resourcePath True string

Caminho do recurso na pasta.

Estado
state True string

Devoluções

O conteúdo do retorno de chamada é validado. Isso representa o tipo de mídia application/vnd.sas.webhook.callback.validate (versão 1).

Webhook Callback Validar
webhookCallbackValidate

Definições

anyVariableValue

O valor da variável.

O valor da variável.

stepOutput

Esse tipo descreve os valores de saída que são retornados quando uma etapa é executada.

Name Caminho Tipo Description
moduleId
moduleId string

O identificador do módulo que contém a etapa executada.

stepId
stepId string

O nome da etapa que produziu essa saída.

saídas
outputs array of variable

Os valores de saída que são retornados de uma etapa executada. A ordem das variáveis corresponde à ordem apresentada na assinatura de saída.

variável

Um par nome/valor que representa uma variável de entrada ou saída.

Name Caminho Tipo Description
name string

Nome da variável.

valor
value anyVariableValue

O valor da variável.

ligação

Name Caminho Tipo Description
HREF
href string

O URL do link.

Tipo de item
itemType string

Se este for um link para um contêiner, itemType é o tipo de mídia ou tipo de link para os itens no contêiner.

método
method string

O método HTTP para o link.

rel
rel string

A relação do link com o recurso.

responseItemType
responseItemType string

O tipo de mídia ou tipo de link dos itens no corpo da resposta para um PUT, POST, ou PATCH operação.

responseType
responseType string

O tipo de mídia ou tipo de link do corpo de resposta para um PUT, POST, ou PATCH operação.

title
title string

O título do link.

tipo
type string

O tipo de mídia ou tipo de link para o link.

URI
uri string

O URI relativo para o link.

webhookCallbackValidar

O conteúdo do retorno de chamada é validado. Isso representa o tipo de mídia application/vnd.sas.webhook.callback.validate (versão 1).

Name Caminho Tipo Description
state
state string

Indique se é sucesso ou fracasso.

resourceUri
resourceUri string

Uri do recurso no qual a validação é executada.

resourcePath
resourcePath string

Caminho do recurso na pasta.

resourceVersion
resourceVersion string

Versão do recurso no qual a validação é executada.

validationType
validationType string

Tipo de validação que é executada no recurso.

links
links array of link

Zero ou mais links para recursos ou operações relacionados.

versão
version integer

Número da versão do esquema deste tipo de mídia. Esta representação é a versão 1.

webhookCallbackPublicar

O conteúdo do retorno de chamada publica. Isso representa o tipo de mídia application/vnd.sas.webhook.callback.publish (versão 1).

Name Caminho Tipo Description
resourceUri
resourceUri string

Uri do recurso publicado.

resourcePath
resourcePath string

Caminho do recurso na pasta.

resourceVersion
resourceVersion string

Versão do recurso publicado.

destinationType
destinationType string

Tipo de destino onde o recurso é publicado.

substituir
replace boolean

Indicado se o recurso é publicado pela primeira vez ou substituído.

links
links array of link

Zero ou mais links para recursos ou operações relacionados.

versão
version integer

Número da versão do esquema deste tipo de mídia. Esta representação é a versão 1.

webhookCallbackGenérico

O conteúdo do retorno de chamada genérico.

Name Caminho Tipo Description
links
links array of link

Zero ou mais links para recursos ou operações relacionados.

versão
version integer

Número da versão do esquema deste tipo de mídia. Esta representação é a versão 1.