Уведомление о готовности через очередь оркестратора

Описание

При создании запроса в Умном OCR, Задачах NLP, Агентской системе или Пакетной обработке можно указать необязательный параметр orchQueue: идентификатор очереди оркестратора. Если он указан, AI Server по готовности запроса кладёт в эту очередь элемент, который робот может забрать и обработать, вместо того чтобы опрашивать AI Server на готовность результата.

Если параметр не указан, поведение не меняется: клиент проверяет готовность методами /ready (см. статьи раздела Пошаговое руководство по API) либо получает результат через WebSocket.

Для запросов, отправляемых из Primo RPA Studio, параметр задаётся в элементе создания запроса (например, «Создать запрос OCR»): в свойствах, в разделе «Обработка», полем «Очередь оркестратора».

Поле «Очередь оркестратора» в свойствах элемента «Создать запрос OCR»

Настройка на стороне AI Server

Прежде чем использовать эту возможность, на бэкенде должна быть заполнена секция конфигурации для взаимодействия с Оркестратором: адрес Оркестратора и учётные данные сервисного аккаунта. Без неё AI Server не сможет обращаться к Оркестратору и класть уведомления в очередь.

В конфиге сервиса Inference (appsettings.json) заполняется секция:


"Orchestrator": {
  "Login": "aiserver",
  "Password": "Qwe123!@#",
  "Address": "https://10.0.0.122:44392"
}

Login, Password: учётные данные сервисного аккаунта, под которым AI Server авторизуется в Оркестраторе.
Address: адрес Оркестратора.

⚠️

Пароль в конфиге должен храниться в зашифрованном виде (утилита шифрования конфигов), а не в открытом тексте, как в примере выше.

Что нужно подготовить

Создать в Оркестраторе очередь обмена данными для приёма уведомлений.
В элементе создания запроса в Studio указать в поле «Очередь оркестратора» идентификатор этой очереди.
Добавить в workflow чтение из этой очереди: по готовности запроса туда придёт элемент.

Ограничение

⚠️

Если Оркестратор в момент готовности результата недоступен, уведомление теряется безвозвратно: повторных попыток положить элемент в очередь нет. Для критичных процессов не полагайтесь только на уведомление через очередь, дублируйте проверку обычным опросом (/ready).