C TWO (предварительная версия)

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

Service	Class	Regions
Copilot Studio	Premium	Все регионы Power Automate за исключением следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Standard	Все регионы Logic Apps , кроме следующих:      - Azure для государственных организаций регионы      - Azure регионы Китая      - Министерство обороны США (DoD)
Power Apps	Premium	Все регионы Power Apps кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Premium	Все регионы Power Automate за исключением следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Contact
Имя	Поддержка C TWO
URL	https://ctwo.com/
Эл. почта	customersuccess@ctwo.com

Метаданные соединителя
Publisher	C TWO
Веб-сайт	https://ctwo.com/
Политика конфиденциальности	https://ctwo.com/privacy-policy/
Categories	Бизнес-аналитика; Искусственный интеллект

C TWO

C TWO — это платформа управления агентами, которая управляет рабочими процессами автоматизации, управляет взаимодействием с роботом и обрабатывает рабочие элементы с помощью универсальных очередей. Этот соединитель позволяет Power Automate, Power Apps, Azure Logic Apps и Copilot Studio триггер и запускаться сеансами C TWO, управлять жизненным циклом сеансов, создавать и обрабатывать элементы универсальной очереди, а также включать взаимодействие с цифровыми рабочими элементами в цикле.

C TWO находится над вашим хранилищем автоматизации в качестве единого уровня оркестрации, управления и мониторинга: независимо от того, что создает или выполняет работу, C TWO добавляет отслеживание соглашения об уровне обслуживания, повторные попытки и самовосстановление, телеметрию динамических сеансов и полный аудит.

Необходимые условия

Перед созданием подключения вам потребуется:

1. Активный клиент C TWO — C TWO Cloud (размещен) или локальный сервер C TWO, доступный по протоколу HTTPS.
2. Маркер учетной записи службы или личный маркер доступа, выданный администратором C TWO (см. сведения о получении учетных данных).
3. Если служба C TWO размещена в локальной среде, сервер должен быть доступен из Power Platform по протоколу HTTPS (брандмауэр, позволяющий Power Automate диапазонов исходящих IP-адресов Microsoft — Azure тегами AzureConnectors.<region> службы и PowerPlatformPlex для географической точки Power Platform).
4. Среда Power Platform с разрешениями настраиваемого соединителя и уровень лицензий, поддерживающий пользовательские соединители (Power Automate Premium или эквивалент).

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

При создании подключения вы предоставляете три значения из собственной среды C TWO:

1. Узел C TWO — только имя узла сервера C TWO (без схемы, без косой черты), например connect24.ctwo.cloudлокальный узел с необязательным портом, например ctwo.contoso.com:8443.
2. Базовый URL-адрес C2 — базовый путь API C TWO, включая раздел, начиная с косой черты и без косой черты, например /DEFAULT/CTWO.Server/api.
3. Ключ API — ваш маркер, введенный как Bearer <your-token>. Рекомендуется использовать маркер учетной записи службы ; Также работает личный маркер доступа .

Вместе узел и базовый URL-адрес направляют соединитель на собственный сервер C TWO (https://{Host}{Base URL}/…), поэтому каждый клиент подключается к собственной среде — C TWO Cloud или локально.

Получение учетных данных

Проверка подлинности использует ключ API, отправленный в качестве маркера носителя в заголовке Authorization .

Маркер учетной записи службы (рекомендуется для рабочей среды)

1. Войдите в экземпляр C TWO.
2. Перейдите в раздел "Приложения и подключения" → Microsoft Power Automate → Создать учетную запись службы.
3. Скопируйте созданный маркер немедленно— он отображается только один раз.

Личный маркер доступа (разработка и тестирование)

1. Откройте профиль пользователя в C TWO.
2. Перейдите на вкладку "Маркеры API" и создайте новый маркер.
3. Копировать его немедленно — он отображается только один раз и недействителен, если учетная запись пользователя отключена.

Обе типы маркеров обрабатываются как секреты— хранят их только в учетных данных подключения Power Platform, никогда не в переменных потока или клиентском коде.

Поддерживаемые операции

• Триггеры — запуск потока, когда C TWO отправляет сеанс с принудительной истечением времени ожидания или без нее.
• Управление сеансами — отчет о завершении или сбое, запись типизированных журналов сеансов, настройка времени ожидания сеанса и проверка правильного запроса на остановку.
• Универсальная очередь — создание, перечисление, блокировка, разблокировка, повторная попытка и отсрочка элементов очереди; обновите данные элемента и добавьте журналы на уровне элементов; добавление и удаление тегов; получение вложений; создание состояний пользовательского элемента; список очередей.
• Человек в цикле — создание, назначение, отмена назначения и завершения структурированных форм помощи для человека и их получение и запрос.

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

Известные проблемы и ограничения

• Требуется правильный URL-адрес узла и базового URL-адреса. Оба параметра вводятся во время подключения и перенаправляют соединитель на сервер C TWO. Неверные или недоступные значения приводят к сбоям подключения или запроса.
• Формат ключа API. Поле "Ключ API" ожидает литеральную строку Bearer <token> , не указывая Bearer префикс 401 Unauthorized.
• Предоставление данных элемента JSON. Поля данных элементов (Create Queue Item, Set Queue Item Data) — это объекты JSON. В потоке укажите литерал JSON с json('…') выражением, чтобы оно было отправлено как объект, а не строка.
• Задержка триггера опроса. Активирует опрос, а не отправку, поэтому между сеансом, отправленным в C TWO, и запуском потока возникает небольшая задержка (связанная с повторением триггера).
• Типы полей формы. Некоторые поля идентификатора, возвращаемые операциями формы, могут быть целым числом, строкой или null в зависимости от состояния формы.

Распространенные ошибки и средства устранения неполадок

Error	Вероятная причина	Средство
401 Unauthorized	Ключ API, отсутствующий Bearer префикс, истек или отменен	Повторно введите учетные данные как Bearer <token>; при отмене нового маркера учетной записи службы
400 Bad request При создании элемента очереди	Отсутствует обязательное поле (reference, queueItemState, itemKey)	Заполнение всех трех обязательных полей
Триггер никогда не запускается	Выбрана неправильная задача или задача C TWO не предоставляется Power Automate	Убедитесь, что задача отображается в раскрывающемся списке идентификатора задачи и настраивается как предоставленный поток в C TWO
Данные элемента, хранящиеся в виде escape-строки	JSON, предоставленный как текст вместо объекта	json('…') Используйте выражение (потоки) или необработанный текст (тест соединителя), чтобы он был отправлен как объект

FAQ

Можно ли использовать этот соединитель из Power Apps, Azure Logic Apps и Copilot Studio, а не только Power Automate? Yes. Триггеры зависят от Power Automate, но каждое действие можно вызывать с любой из этих платформ после создания подключения.

Управляет ли этот соединитель лицензированием? No. C TWO оркеструет и управляет выполнением; клиенты несут ответственность за собственное Microsoft лицензирование.

Где я могу получить помощь? Обратитесь к C TWO Customer Success по адресу customersuccess@ctwo.com.

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

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

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

По умолчанию

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

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательный
Узел C TWO	string	Имя узла сервера C TWO — нет схемы, не косой черты. Например, connect24.ctwo.cloud или локальный узел с необязательным портом, например ctwo.contoso.com:8443.	True
Базовый URL-адрес C TWO	string	Базовый путь API C TWO, включая отдел. Начните с косой черты, без косой черты. Например, /DEFAULT/CTWO. Сервер или API.	True
Ключ API	securestring	Маркер API C TWO, введенный в качестве носителя <маркера>. Рекомендуется использовать маркер учетной записи службы; Также работает личный маркер доступа.	True

Действия

Блокировка элемента очереди	Блокирует элемент очереди, чтобы предотвратить одновременную обработку других рабочих ролей. Используйте это действие перед обработкой рабочего элемента, чтобы обеспечить монопольный доступ.
Добавление журнала в сеанс	Записывает запись журнала в сеанс C TWO. Используйте это действие для отслеживания хода выполнения, записи решений или диагностических сведений журнала во время выполнения потока. Журналы отображаются на платформе C TWO для аудита и устранения неполадок.
Добавление журнала в элемент очереди	Добавляет сообщение журнала в элемент очереди для отслеживания и трассировки. Используйте это действие для записи шагов обработки, предупреждений или ошибок для определенного рабочего элемента.
Добавление тегов в элемент очереди	Добавляет один или несколько тегов в элемент очереди для классификации и фильтрации. Теги помогают упорядочивать и искать рабочие элементы в очередях.
Назначение формы	Назначает форму взаимодействия с роботом конкретному пользователю, что делает их ответственным за проверку и завершение запроса на цикл человека.
Настройка данных элемента очереди	Обновляет содержимое данных элемента очереди. Используйте это действие для изменения полезных данных рабочего элемента во время обработки, например для хранения промежуточных результатов.
Настройка состояния элемента очереди	Изменяет состояние элемента очереди (например, от ожиданий до завершения или в настраиваемое состояние). Используйте это действие для продвижения элементов через конвейер рабочего процесса.
Остановка сеанса	Проверяет, запрашивает ли C TWO грациозную (обратимую) остановку для данного сеанса. Используйте это действие внутри циклов, чтобы периодически проверять, должен ли сеанс завершиться рано, что позволит потоку очистить ресурсы перед остановкой.
Отложить элемент очереди	Откладывает элемент очереди, поэтому он не будет обрабатываться до указанной даты и времени. Используйте это действие, если элемент не может быть обработан сейчас, но его следует повторить позже.
Отмена назначения формы	Удаляет текущее назначение пользователя из формы взаимодействия с роботом, что делает его доступным для других пользователей для утверждения.
Полная форма	Помечает форму взаимодействия робота как завершенную, сигналируя о том, что пользователь предоставил запрошенные входные данные и цифровой работник может возобновить обработку.
Получение вложения элемента очереди	Извлекает определенное вложение файла из элемента очереди в виде данных в кодировке Base64. Используйте это действие для скачивания файлов, присоединенных к рабочим элементам во время создания или обработки.
Получение очередей	Извлекает универсальные очереди на основе критериев фильтрации. Используйте это действие для перечисления доступных очередей, проверки конфигурации или поиска сведений о очереди. Эта операция также обеспечивает динамические раскрывающийся список в других действиях.
Получение форм	Извлекает список форм взаимодействия роботов с необязательным фильтром. Используйте это действие для запроса ожидающих запросов в цикле, проверки их состояния или поиска форм, назначенных определенным пользователям.
Получение формы по идентификатору	Извлекает определенную форму взаимодействия робота по уникальному идентификатору. Используйте это действие для получения сведений, полей и текущего состояния формы "человек в цикле", созданной цифровой рабочей ролью.
Получение элементов очереди	Извлекает элементы очереди на основе указанных критериев фильтра, таких как состояние, теги, даты и имена очередей. Используйте это действие для поиска и мониторинга рабочих элементов в универсальных очередях.
Разблокировка элемента очереди	Разблокирует ранее заблокированный элемент очереди и возвращает его в доступное состояние. Используйте это действие при прерывании обработки, и элемент должен быть выпущен для других рабочих ролей.
Создание состояния элемента очереди	Создает новое настраиваемое состояние в определенной очереди. Пользовательские состояния позволяют определять этапы рабочего процесса за пределами состояний по умолчанию (ожидающие, завершенные, указанные), адаптации очереди к бизнес-процессу.
Создание формы	Создает новую форму взаимодействия робота, которая позволяет цифровому работнику запрашивать помощь человека. Форма представлена назначенным пользователям на платформе C TWO, что позволяет сценариям взаимодействия с человеком в цикле, где требуется опыт человека для обработки исключений или сложных решений.
Создание элемента очереди	Создает новый рабочий элемент в указанной универсальной очереди. Используйте это действие для добавления элементов для обработки цифровыми работниками, включая полезные данные, теги и необязательные вложения файлов.
Удаление тегов из элемента очереди	Удаляет один или несколько тегов из элемента очереди. Используйте это действие для обновления классификации рабочих элементов во время обработки.
Установка времени ожидания сеанса	Обновляет значение времени ожидания для активного сеанса C TWO. Используйте это действие для расширения или уменьшения допустимого времени выполнения для запущенного сеанса, когда исходное время ожидания требует корректировки.
Установка состояния выполнения потока в значение "Завершено"	Помечает сеанс C TWO как завершенный, сигналируя о том, что поток успешно завершил свою работу. Поместите это действие в конце потока, чтобы отправить отчет обратно в C TWO, что автоматизация завершена без ошибок.
Установка состояния выполнения потока на сбой	Помечает сеанс C TWO как неудачный, сигналируя об ошибке во время выполнения потока. Используйте это действие в областях обработки ошибок, чтобы сообщить о сбоях обратно в C TWO с подробными сведениями о том, что произошло неправильно.
Элемент очереди повторных попыток	Повторите определенный элемент очереди, задав данные обратно в исходное значение и создав новую попытку.

Блокировка элемента очереди

Добавление журнала в сеанс

Добавление журнала в элемент очереди

Добавление тегов в элемент очереди

Назначение формы

Настройка данных элемента очереди

Настройка состояния элемента очереди

Остановка сеанса

Отложить элемент очереди

Отмена назначения формы

Полная форма

Получение вложения элемента очереди

Получение очередей

Получение форм

Получение формы по идентификатору

Получение элементов очереди

Разблокировка элемента очереди

Создание состояния элемента очереди

Создание формы

Создание элемента очереди

Удаление тегов из элемента очереди

Установка времени ожидания сеанса

Установка состояния выполнения потока в значение "Завершено"

Установка состояния выполнения потока на сбой

Элемент очереди повторных попыток

Триггеры

Запуск потока из запроса сеанса без времени ожидания	Опросы для новых сеансов C TWO и активируют поток при создании сеанса для выбранной задачи. Используйте этот триггер, если автоматизация не требует ограничения времени ожидания. Поток получает сведения о сеансе, включая входные значения, передаваемые из C TWO.
Запуск потока из запроса сеанса с истечением времени ожидания	Опросы для новых сеансов C TWO и активируют поток с ограничением времени ожидания. Используйте этот триггер, когда автоматизация должна завершиться в течение определенного периода времени. Если сеанс превышает время ожидания, C TWO будет обрабатывать его в соответствии с политикой времени ожидания.

Запуск потока из запроса сеанса без времени ожидания

Запуск потока из запроса сеанса с истечением времени ожидания

Определения

string

object