Поделиться через


Когнитивные действия Майкрософт

Службы Azure Cognitive Services позволяют вам ускорить принятие решений с помощью искусственного интеллекта, не требуя опыта работы с машинным обучением.

Внимание

Azure прекращает поддержку текстовой аналитики Azure Cognitive Services Text Analytics v2.x 29 февраля 2024 г. Эта библиотека используется действиями текстовой аналитики Microsoft Cognitive. После 29 февраля 2024 г. эти действия больше не будут поддерживаться в классических потоках и не будут работать.

Классические потоки предоставляют широкий спектр когнитивных действий Майкрософт, которые позволяют вам интегрировать эту функциональность в свои классические потоки. Анализ текста, компьютерное зрение и проверка орфографии — все это задачи, которые могут выполнять когнитивные действия Майкрософт.

Для всех когнитивных действий Майкрософт требуется ключ подписки, подтверждающий вашу подписку на службу или группу служб. Ключи доступны на портале Azure для каждого созданного вами ресурса.

Снимок экрана действия Проверка орфографии.

Проверить орфографию

Вызывает службу Microsoft Cognitive Services "Проверка орфографии Bing".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Text Нет Списоктекстовых значений Текст или список текстов для отправки
Mode Да Текстовое значение Укажите режим проверки орфографии
Mkt Да Текстовое значение Для режима редактуры поддерживаются только следующие языки: en-us, es-es, pt-br. Для режима проверки орфографии поддерживаются все коды языков
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.

Проанализировать изображение

Вызывает службу Microsoft Cognitive Services "Анализ изображений".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Server location Н/Д Западная часть США, Западная часть США 2, Восточная часть США, Восточная часть США 2, Центрально-западная часть США, Центрально-южная часть США, Западная Европа, Северная Европа, Юго-Восточная Азия, Восточная Азия, Восточная Австралия, Южная Бразилия, Центральная Канада, Центральная Индия, Южная часть Соединенного Королевства, Восточная Япония Западная часть США Расположение сервера, которое будет использоваться для этого вызова API
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Provide image Н/Д Из файла, Из GCS Из файла Укажите, будет ли задано изображение с помощью полного пути или URL-адреса
Image file Нет Файл Полный путь (папка и имя файла) к файлу изображения для передачи
Image URL Нет Текстовое значение URL-адрес изображения
Visual features Да Текстовое значение Текстовое значение, указывающее, какие типы визуальных элементов нужно возвращать. Несколько значений следует разделять запятыми. Например: категории, теги, описание
Details Да Текстовое значение Текстовое значение, указывающее, какие сведения о конкретном домене нужно вернуть. Несколько значений следует разделять запятыми
Language Да Текстовое значение Текстовое значение, указывающее, какой язык нужно вернуть. Служба вернет результаты распознавания на указанном языке
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.

Описать изображение

Вызывает службу Microsoft Cognitive Services "Описать изображение".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Server location Н/Д Западная часть США, Западная часть США 2, Восточная часть США, Восточная часть США 2, Центрально-западная часть США, Центрально-южная часть США, Западная Европа, Северная Европа, Юго-Восточная Азия, Восточная Азия, Восточная Австралия, Южная Бразилия, Центральная Канада, Центральная Индия, Южная часть Соединенного Королевства, Восточная Япония Западная часть США Расположение сервера, которое будет использоваться для этого вызова API
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Provide image Н/Д Из файла, Из GCS Из файла Укажите, будет ли задано изображение с помощью полного пути или URL-адреса
Image file Нет Файл Полный путь (папка и имя файла) к файлу изображения для передачи
Image URL Нет Текстовое значение URL-адрес изображения
Max candidates Да Текстовое значение Максимальное число возвращаемых описаний-кандидатов. Значение по умолчанию равно 1
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.

OCR

Вызывает службу Microsoft Cognitive Services "Распознавание текста".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Server location Н/Д Западная часть США, Западная часть США 2, Восточная часть США, Восточная часть США 2, Центрально-западная часть США, Центрально-южная часть США, Западная Европа, Северная Европа, Юго-Восточная Азия, Восточная Азия, Восточная Австралия, Южная Бразилия, Центральная Канада, Центральная Индия, Южная часть Соединенного Королевства, Восточная Япония Западная часть США Расположение сервера, которое будет использоваться для этого вызова API
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Provide image Н/Д Из файла, Из GCS Из файла Укажите, будет ли задано изображение с помощью полного пути или URL-адреса
Image file Нет Файл Полный путь (папка и имя файла) к файлу изображения для передачи
Image URL Нет Текстовое значение URL-адрес изображения
Language Да Текстовое значение Код языка BCP-47 текста для обнаружения на изображении
Detect orientation Да Текстовое значение Укажите, следует ли определять ориентацию текста на изображении.
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.

Пометить изображение тегами

Вызывает службу Microsoft Cognitive Services "Пометить изображение тегами".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Server location Н/Д Западная часть США, Западная часть США 2, Восточная часть США, Восточная часть США 2, Центрально-западная часть США, Центрально-южная часть США, Западная Европа, Северная Европа, Юго-Восточная Азия, Восточная Азия, Восточная Австралия, Южная Бразилия, Центральная Канада, Центральная Индия, Южная часть Соединенного Королевства, Восточная Япония Западная часть США Расположение сервера, которое будет использоваться для этого вызова API
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Provide image Н/Д Из файла, Из GCS Из файла Укажите, будет ли задано изображение с помощью полного пути или URL-адреса
Image file Нет Файл Полный путь (папка и имя файла) к файлу изображения для передачи
Image URL Нет Текстовое значение URL-адрес изображения
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.

Определение языка

Вызывает службу Microsoft Cognitive Services "Анализ текста - Определение языка".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Server location Н/Д Западная часть США, Западная часть США 2, Восточная часть США, Восточная часть США 2, Центрально-западная часть США, Центрально-южная часть США, Западная Европа, Северная Европа, Юго-Восточная Азия, Восточная Азия, Восточная Австралия, Южная Бразилия, Центральная Канада, Центральная Индия, Южная часть Соединенного Королевства, Восточная Япония Западная часть США Расположение сервера, которое будет использоваться для этого вызова API
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Text Нет Текстовое значение Текст для анализа
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.

Ключевые фразы

Вызывает службу Microsoft Cognitive Services "Анализ текста - Ключевые фразы".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Server location Н/Д Западная часть США, Западная часть США 2, Восточная часть США, Восточная часть США 2, Центрально-западная часть США, Центрально-южная часть США, Западная Европа, Северная Европа, Юго-Восточная Азия, Восточная Азия, Восточная Австралия, Южная Бразилия, Центральная Канада, Центральная Индия, Южная часть Соединенного Королевства, Восточная Япония Западная часть США Расположение сервера, которое будет использоваться для этого вызова API
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Text Нет Списоктекстовых значений Текст или список текстов для анализа
Language Да Текстовое значение Язык текстов
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.

Тональность

Вызывает службу Microsoft Cognitive Services "Анализ текста - Тональность".

Входные параметры

Аргумент Необязательно Принимает Значение по умолчанию Description
Server location Н/Д Западная часть США, Западная часть США 2, Восточная часть США, Восточная часть США 2, Центрально-западная часть США, Центрально-южная часть США, Западная Европа, Северная Европа, Юго-Восточная Азия, Восточная Азия, Восточная Австралия, Южная Бразилия, Центральная Канада, Центральная Индия, Южная часть Соединенного Королевства, Восточная Япония Западная часть США Расположение сервера, которое будет использоваться для этого вызова API
Subscription key Нет Текстовое значение Ключ подписки, который будет использоваться для этого вызова API
Текст Нет Списоктекстовых значений Текст
Язык Да Текстовое значение Двухбуквенный код ISO 639-1 языка текстов
Timeout Да Числовое значение 30 Время (в секундах), в течение которого агент должен ждать установки подключения к серверу, прежде чем попытка будет признана неудачной.

Создаваемые переменные

Аргумент Type Description
JSONResponse Пользовательский объект Результаты ответа API
StatusCode Числовое значение Возвращенный код состояния

Исключения

Исключение Описание
Время ожидания запроса истекло. Указывает, что истекло время ожидания при выполнении запроса.
Не удалось вызвать службы Cognitive Services Указывает на проблему при попытке вызвать службы Cognitive Services.