Решение 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.
Предпосылки
- Пользователь должен иметь существующую лицензию на интеллектуальное решение SAS.
- Пользователь должен настроить среду интеллектуального принятия решений SAS, чтобы разрешить вызовы, поступающие из IP-адресов, описанных в диапазонах IP-адресов Azure.
Использование соединителя принятия решений SAS
- Зарегистрируйте клиентские приложения.
- Получите маркер доступа для использования при подключении к среде SAS Viya.
- Подключитесь к среде SAS Viya.
Регистрация клиентов
Все приложения и скрипты, использующие REST API SAS Viya, должны быть зарегистрированы в среде SAS. Администратор SAS должен использовать службу OAuth в ДИСПЕТЧЕРе входа SAS для запроса маркера доступа и регистрации клиента. SAS Logon Manager выдает маркеры доступа OAuth в ответ на запросы, содержащие допустимый маркер из сервера конфигурации SAS. Соединитель принятия решений SAS использует маркер носителя OAuth в качестве ключа API.
Чтобы зарегистрировать клиент, выполните приведенные действия.
Найдите допустимый токен Consul. Администратор SAS может найти маркер в файле
/opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/defaultclient.token в модулеsas-consul-server-0pod. Чтобы получить строку токена Consul в системе Linux, выполните следующую команду:kubectl exec sas-consul-server-0 -- \ cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.tokenЗапрос маркера 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 .
Зарегистрируйте клиентское приложение, разместив запрос
/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 в ответе содержит выходные данные выполнения.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
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 |
Значение переменной. |
link
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
href
|
href | string |
URL-адрес ссылки. |
|
Тип элемента
|
itemType | string |
Если это ссылка на контейнер, |
|
method
|
method | string |
Метод HTTP для ссылки. |
|
rel
|
rel | string |
Связь ссылки с ресурсом. |
|
responseItemType
|
responseItemType | string |
Тип носителя или тип ссылки элементов в тексте отклика для |
|
responseType (тип ответа)
|
responseType | string |
Тип носителя или тип ссылки текста отклика для |
|
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. |