Решение SAS (предварительная версия)

Решение SAS объединяет ИИ и бизнес-правила для автоматизации операционных решений в масштабе. Используйте этот соединитель для запуска моделей принятия решений, развернутых на платформе SAS Viya.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка SAS
URL https://support.sas.com
Адрес электронной почты support@sas.com
Метаданные соединителя
Publisher Институт SAS, Inc.
Website https://www.sas.com
Политика конфиденциальности https://www.sas.com/en_us/legal/privacy.html
Категории Искусственный интеллект; Данные

Интеллектуальное решение SAS для SAS Viya объединяет управление бизнес-правилами, обработку решений, обнаружение событий в режиме реального времени, управление решениями и мощную расширенную аналитику SAS для автоматизации решений и управления ими на предприятии. Интеллектуальное решение SAS помогает ускорить эксплуатацию аналитических моделей, включая модели SAS и те, которые разработаны с помощью платформ с открытым исходным кодом. Она поддерживает процесс принятия решений в кредитных службах, предотвращении мошенничества, производстве, персонализированных маркетингах и многих других вариантах использования.

Соединитель принятия решений SAS позволяет пользователям подключаться к среде SAS Viya и запускать выбранные модули принятия решений и аналитические модели. Ниже приведены примеры вариантов использования соединителя принятия решений SAS:

  • Определение соответствия содержимого электронной почты корпоративной политике компании
  • Оценка кандидата на работу на основе отзывов о собеседовании
  • Оценка возможности продаж
  • Определение допустимости счета
  • Автоматическое утверждение отчета о расходах

Чтобы узнать больше о интеллектуальном решении SAS и запросить бесплатную пробную версию, посетите сайт https://www.sas.com/en_us/software/intelligent-decisioning.html.

Предпосылки

  1. Пользователь должен иметь существующую лицензию на интеллектуальное решение SAS.
  2. Пользователь должен настроить среду интеллектуального принятия решений SAS, чтобы разрешить вызовы, поступающие из IP-адресов, описанных в диапазонах IP-адресов Azure.

Использование соединителя принятия решений SAS

  1. Зарегистрируйте клиентские приложения.
  2. Получите маркер доступа для использования при подключении к среде SAS Viya.
  3. Подключитесь к среде SAS Viya.

Регистрация клиентов

Все приложения и скрипты, использующие REST API SAS Viya, должны быть зарегистрированы в среде SAS. Администратор SAS должен использовать службу OAuth в ДИСПЕТЧЕРе входа SAS для запроса маркера доступа и регистрации клиента. SAS Logon Manager выдает маркеры доступа OAuth в ответ на запросы, содержащие допустимый маркер из сервера конфигурации SAS. Соединитель принятия решений SAS использует маркер носителя OAuth в качестве ключа API.

Чтобы зарегистрировать клиент, выполните приведенные действия.

  1. Найдите допустимый токен Consul. Администратор SAS может найти маркер в файле /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/defaultclient.token в модуле sas-consul-server-0 pod. Чтобы получить строку токена Consul в системе Linux, выполните следующую команду:

    kubectl exec sas-consul-server-0 -- \
        cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token
    
  2. Запрос маркера OAuth путем отправки запроса /SASLogon/oauth/clients/consulв . Укажите токен Consul из шага 1 в X-Consul-Token поле. Например, чтобы запросить токен для клиента с именем app, отправьте следующую команду:

    curl -X POST "https://server.example.com/SASLogon/oauth/clients/consul?callback=false&serviceId=app" \
          -H "X-Consul-Token: <consul-token-from-step-1>"
    
    Параметр запроса Description
    обратный вызов Укажите false , чтобы получить маркер доступа в ответе. В противном случае маркер отправляется службе, зарегистрированной на сервере конфигурации SAS.
    serviceId Укажите имя клиента, который требуется зарегистрировать.

    В ответ на запрос диспетчер входа SAS возвращает ответ JSON, содержащий маркер доступа в поле access_token .

  3. Зарегистрируйте клиентское приложение, разместив запрос /SASLogon/oauth/clients. Укажите маркер доступа, возвращенный на шаге 2 в качестве значения заголовка Authorization :

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

    Кончик: По умолчанию маркер действителен в течение 12 часов (или 43200 секунд). Чтобы задать более короткую или длинную длительность, задайте access_token_validity поле по мере необходимости, используя целочисленное значение для времени в секундах.

    Заметка: Поддерживаются другие "authorized_grant_types", но соединитель принятия решений SAS в настоящее время ожидает тип гранта client_credentials .

Если запрос выполнен успешно, клиент зарегистрирован. Успешный ответ JSON выглядит примерно так:

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

Получение маркеров доступа

Зарегистрированные клиенты могут запрашивать маркер доступа с помощью API OAuth входа SAS. Чтобы запросить маркер доступа, отправьте запрос в /SASLogon/oauth/token конечную точку и укажите форму авторизации. Авторизация выражается в виде предоставления авторизации. В настоящее время ИНТЕРФЕЙСы REST API SAS Viya поддерживают тип гранта client_credentials .

Например, при указании идентификатора клиента myclient с секретом mysecret, можно запросить токен следующим образом:

    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"

Ответ JSON содержит поле с именем access_token , содержащее значение маркера, используемого соединителем принятия решений SAS для создания подключений Power Automate. По истечении срока действия маркера отправьте новый запрос в конечную точку /SASLogon/oauth/token .

Подключение к среде SAS Viya

Чтобы подключиться к среде SAS Viya, вам потребуется следующая информация:

Имя параметра Description
URL-адрес среды SAS Viya URL-адрес развертывания интеллектуального принятия решений SAS. Например: https://server.example.com
Маркер авторизации Маркер доступа, возвращенный командой, приведенной выше при получении маркеров доступа . Префикс маркера с Bearer помощью .

Подключение можно совместно использовать между пользователями.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Доступный для общего пользования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя Тип Description Обязательно
URL-адрес среды SAS Viya струна Указание URL-адреса среды SAS Viya True
Маркер авторизации securestring Маркер авторизации для этого API True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Шаг выполнения

Выполняет шаг с указанными входными значениями. Переменная outputs в ответе содержит выходные данные выполнения.

Шаг выполнения

Выполняет шаг с указанными входными значениями. Переменная outputs в ответе содержит выходные данные выполнения.

Параметры

Имя Ключ Обязательно Тип Описание
module
moduleId True string

Идентификатор модуля, содержащего шаг выполнения.

шаг
stepId True string

Идентификатор выполняемого шага.

имя
name string

Имя переменной.

value
value

Значение переменной.

Возвращаемое значение

Этот тип описывает выходные значения, возвращаемые при выполнении шага.

Выходные данные шага
stepOutput

Триггеры

Когда произошло предварительно определенное событие

Создает новый веб-перехватчик для предварительно определенного события типа контента обратного вызова.

При проверке ресурса

Создает новый веб-перехватчик для завершения любого события оценки.

При публикации ресурса

Создает новый веб-перехватчик для события публикации.

Когда произошло предварительно определенное событие

Создает новый веб-перехватчик для предварительно определенного события типа контента обратного вызова.

Параметры

Имя Ключ Обязательно Тип Описание
Тип контента обратного вызова
callbackContentType True string

Тип содержимого обратного вызова.

Фильтр содержимого обратного вызова
callbackContentFilter string

Фильтрация содержимого обратного вызова.

Возвращаемое значение

Содержимое универсального обратного вызова.

Универсальный вызов веб-перехватчика
webhookCallbackGeneric

При проверке ресурса

Создает новый веб-перехватчик для завершения любого события оценки.

Параметры

Имя Ключ Обязательно Тип Описание
Префикс пути к ресурсу
resourcePath True string

Путь к ресурсу в папке.

Государство
state True string

Возвращаемое значение

Содержимое проверки обратного вызова. Это представляет тип носителя application/vnd.sas.webhook.callback.validate (версия 1).

Проверка обратного вызова веб-перехватчика
webhookCallbackValidate

При публикации ресурса

Создает новый веб-перехватчик для события публикации.

Параметры

Имя Ключ Обязательно Тип Описание
Префикс пути к ресурсу
resourcePath True string

Путь к ресурсу в папке.

Тип назначения
destinationType True string

Возвращаемое значение

Содержимое публикации обратного вызова. Это представляет тип носителя application/vnd.sas.webhook.callback.publish (версия 1).

Публикация обратного вызова веб-перехватчика
webhookCallbackPublish

Определения

anyVariableValue

Значение переменной.

Значение переменной.

stepOutput

Этот тип описывает выходные значения, возвращаемые при выполнении шага.

Имя Путь Тип Описание
moduleId
moduleId string

Идентификатор модуля, содержащего выполненный шаг.

stepId
stepId string

Имя шага, создающего эти выходные данные.

выходные данные
outputs array of variable

Выходные значения, возвращаемые из выполняемого шага. Порядок переменных совпадает с порядком, представленным в выходной сигнатуре.

variable

Пара name/value, представляющая входную или выходную переменную.

Имя Путь Тип Описание
name string

Имя переменной.

value
value anyVariableValue

Значение переменной.

Имя Путь Тип Описание
href
href string

URL-адрес ссылки.

Тип элемента
itemType string

Если это ссылка на контейнер, itemType тип носителя или тип ссылки для элементов в контейнере.

method
method string

Метод HTTP для ссылки.

rel
rel string

Связь ссылки с ресурсом.

responseItemType
responseItemType string

Тип носителя или тип ссылки элементов в тексте отклика для PUTPOSTоперации или PATCH операции.

responseType (тип ответа)
responseType string

Тип носителя или тип ссылки текста отклика для PUTPOSTоперации или PATCH операции.

title
title string

Заголовок ссылки.

type
type string

Тип носителя или тип ссылки для ссылки.

УРИ
uri string

Относительный URI для ссылки.

webhookCallbackValidate

Содержимое проверки обратного вызова. Это представляет тип носителя application/vnd.sas.webhook.callback.validate (версия 1).

Имя Путь Тип Описание
государство
state string

Указывает, является ли это успешной или неудачной.

resourceUri
resourceUri string

Uri ресурса, на котором выполняется проверка.

Путь к ресурсу
resourcePath string

Путь к ресурсу в папке.

resourceVersion
resourceVersion string

Версия ресурса, на котором выполняется проверка.

validationType
validationType string

Тип проверки, выполняемой на ресурсе.

links
links array of link

Ноль или больше ссылок на связанные ресурсы или операции.

version
version integer

Номер версии схемы этого типа носителя. Это представление является версией 1.

webhookCallbackPublish

Содержимое публикации обратного вызова. Это представляет тип носителя application/vnd.sas.webhook.callback.publish (версия 1).

Имя Путь Тип Описание
resourceUri
resourceUri string

Uri ресурса, опубликованного.

Путь к ресурсу
resourcePath string

Путь к ресурсу в папке.

resourceVersion
resourceVersion string

Версия ресурса, опубликованного.

Тип назначения
destinationType string

Тип назначения, в котором публикуется ресурс.

replace
replace boolean

Указывает, публикуется ли ресурс в первый раз или заменен.

links
links array of link

Ноль или больше ссылок на связанные ресурсы или операции.

version
version integer

Номер версии схемы этого типа носителя. Это представление является версией 1.

webhookCallbackGeneric

Содержимое универсального обратного вызова.

Имя Путь Тип Описание
links
links array of link

Ноль или больше ссылок на связанные ресурсы или операции.

version
version integer

Номер версии схемы этого типа носителя. Это представление является версией 1.