Compartilhar via


Decisões de SAS (versão prévia)

As decisões de SAS combinam regras de IA e de negócios para automatizar as decisões operacionais em escala. Use esse conector para executar modelos de decisão implantados na plataforma SAS Viya.

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – 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
Publicador Instituto SAS, Inc.
Site https://www.sas.com
Política de privacidade https://www.sas.com/en_us/legal/privacy.html
Categorias IA; Dados

O SAS Intelligent Decisioning on SAS Viya combina gerenciamento de regras de negócios, processamento de decisões, detecção de eventos em tempo real, governança de decisão e análise avançada de SAS avançada para automatizar e gerenciar decisões em toda a empresa. A Decisão Inteligente de SAS ajuda a agilizar a operacionalização de modelos analíticos, incluindo modelos SAS e aqueles desenvolvidos com estruturas de software livre. Ele dá suporte ao processo de decisão em serviços de crédito, prevenção contra fraudes, fabricação, marketing personalizado e muitos outros casos de uso.

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

  • Determinar se o conteúdo de email está em conformidade com a política corporativa de uma empresa
  • Pontuar um candidato a emprego com base nos comentários da entrevista
  • Pontuar uma oportunidade de vendas
  • Determinar se uma fatura é legítima
  • Aprovar automaticamente um relatório de despesas

Para saber mais sobre decisões inteligentes de SAS 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 de Decisão Inteligente sas existente.
  2. O usuário deve configurar o ambiente de Decisão Inteligente sas para permitir chamadas provenientes dos Endereços IP descritos nos Intervalos de IP do Azure.

Como usar o conector de decisão SAS

  1. Registre seus aplicativos cliente.
  2. Obtenha um token de acesso para uso na conexão ao seu ambiente SAS Viya.
  3. Conecte-se ao ambiente do SAS Viya.

Registrando clientes

Todos os aplicativos e scripts que usam APIs REST do SAS Viya devem ser registrados no ambiente SAS. O administrador da 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 de SAS. O Conector de Decisão SAS usa um token de portador OAuth como uma chave de API.

Para registrar um cliente:

  1. Localize um token do Consul válido. Um administrador de 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 de token do 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 para /SASLogon/oauth/clients/consul. Especifique o token do Consul da etapa 1 no X-Consul-Token campo. Por exemplo, para solicitar um token para um cliente nomeado 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
    retorno de chamada Especifique false para receber um token de acesso na resposta. Caso contrário, o token será enviado para o serviço registrado no Servidor de Configuração de SAS.
    ID do serviço Especifique o nome do cliente que você deseja registrar.

    Em resposta à solicitação, o Gerenciador de Logon sas 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 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
         }'
    

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

    Nota: Há outros "authorized_grant_types" com suporte, mas o conector de decisão SAS atualmente espera o client_credentials tipo de concessão.

Se a solicitação for bem-sucedida, o cliente será registrado. Uma resposta JSON bem-sucedida é semelhante ao seguinte exemplo:

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

Obtendo tokens de acesso

Os clientes registrados podem solicitar um token de acesso usando a API OAuth do Logon sas. Para solicitar um token de acesso, poste uma solicitação no /SASLogon/oauth/token ponto de extremidade e especifique uma forma de autorização. A autorização é expressa na forma de uma concessão de autorização. Atualmente, as APIs REST do SAS Viya dão suporte ao 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 do Power Automate. Quando o token expirar, poste uma nova solicitação no /SASLogon/oauth/token ponto de extremidade.

Conectando-se ao seu ambiente do SAS Viya

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

Nome do parâmetro Description
URL de Ambiente do SAS Viya URL da implantação de Decisões Inteligentes de SAS. Por exemplo: https://server.example.com
Token de autorização O token de acesso retornado do comando na obtenção de tokens de acesso acima. Prefixe o token com Bearer .

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

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default 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.

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

Nome Tipo Description Obrigatório
URL de Ambiente do SAS Viya cadeia Especificar a URL de Ambiente do Sas Viya Verdade
Token de autorização secureString O Token de Autorização para esta api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Etapa executar

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

Etapa executar

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

Nome Chave Obrigatório Tipo Description
módulo
moduleId True string

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

etapa
stepId True string

O identificador da etapa a ser executada.

nome
name string

Nome da variável.

value
value

O valor da variável.

Retornos

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

Saída da etapa
stepOutput

Gatilhos

Quando um evento predefinido 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 conclusão de qualquer evento de pontuação.

Quando um evento predefinido aconteceu

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

Parâmetros

Nome Chave Obrigató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

Filtrar o conteúdo do retorno de chamada.

Retornos

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

Webhook Callback Generic
webhookCallbackGeneric

Quando um recurso é publicado

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Prefixo do caminho do recurso
resourcePath True string

Caminho do recurso na pasta.

Tipo de destino
destinationType True string

Retornos

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

Publicação de retorno de chamada do Webhook
webhookCallbackPublish

Quando um recurso é validado

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Prefixo do caminho do recurso
resourcePath True string

Caminho do recurso na pasta.

Estado
state True string

Retornos

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

Validação de retorno de chamada do Webhook
webhookCallbackValidate

Definições

anyVariableValue

O valor da variável.

O valor da variável.

stepOutput

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

Nome 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 retornados de uma etapa executada. A ordem das variáveis corresponde à ordem apresentada na assinatura de saída.

variável

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

Nome Caminho Tipo Description
name string

Nome da variável.

value
value anyVariableValue

O valor da variável.

Nome Caminho Tipo Description
href
href string

A URL do link.

tipoDeItem
itemType string

Se esse for um link para um contêiner, itemType será o tipo de mídia ou o 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 o tipo de link dos itens no corpo da resposta para uma PUToperação ou PATCH uma operaçãoPOST.

responseType
responseType string

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

title
title string

O título do link.

tipo
type string

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

uri
uri string

O URI relativo para o link.

webhookCallbackValidate

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

Nome Caminho Tipo Description
estado
state string

Indireto se é êxito ou falha.

resourceUri
resourceUri string

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

Caminho do recurso
resourcePath string

Caminho do recurso na pasta.

resourceVersion
resourceVersion string

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

validationType
validationType string

Tipo da validação executada no recurso.

links
links array of link

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

versão
version integer

O número de versão do esquema desse tipo de mídia. Essa representação é a versão 1.

webhookCallbackPublish

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

Nome Caminho Tipo Description
resourceUri
resourceUri string

Uri do recurso que é publicado.

Caminho do recurso
resourcePath string

Caminho do recurso na pasta.

resourceVersion
resourceVersion string

Versão do recurso que é publicado.

destinationType
destinationType string

Tipo do destino em que o recurso é publicado.

substituir
replace boolean

Indicou 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

O número de versão do esquema desse tipo de mídia. Essa representação é a versão 1.

webhookCallbackGeneric

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

Nome Caminho Tipo Description
links
links array of link

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

versão
version integer

O número de versão do esquema desse tipo de mídia. Essa representação é a versão 1.