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 |
| 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
- O usuário deve ter uma licença de Decisão Inteligente sas existente.
- 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
- Registre seus aplicativos cliente.
- Obtenha um token de acesso para uso na conexão ao seu ambiente SAS Viya.
- 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:
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/defaultdosas-consul-server-0pod. 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.tokenSolicite um token OAuth postando uma solicitação para
/SASLogon/oauth/clients/consul. Especifique o token do Consul da etapa 1 noX-Consul-Tokencampo. Por exemplo, para solicitar um token para um cliente nomeadoapp, 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 falsepara 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 .
Registre o aplicativo cliente postando uma solicitação para
/SASLogon/oauth/clients. Especifique o token de acesso retornado na etapa 2 como o valor doAuthorizationcabeç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_validitycampo 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_credentialstipo 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 |
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
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. |
link
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
href
|
href | string |
A URL do link. |
|
tipoDeItem
|
itemType | string |
Se esse for um link para um 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 |
|
responseType
|
responseType | string |
O tipo de mídia ou o tipo de link do corpo da resposta para um |
|
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. |