C TWO (プレビュー)

このコネクタは、次の製品とリージョンで使用できます。

Service	クラス	リージョン
コピロット スタジオ	Premium	次を除くすべてのPower Automateリージョン:      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
ロジック アプリ	Standard	次を除くすべての Logic Apps リージョン :      - Azure Government リージョン      - 中国リージョンAzure      - 米国国防総省 (DoD)
Power Apps	Premium	次を除くすべてのPower Appsリージョン:      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)
Power Automate（パワーオートメート）	Premium	次を除くすべてのPower Automateリージョン:      - 米国政府 (GCC)      - 米国政府 (GCC High)      - 21Vianet が運営する China Cloud      - 米国国防総省 (DoD)

お問い合わせ
名前	C TWO のサポート
URL	https://ctwo.com/
Email	customersuccess@ctwo.com

コネクタ メタデータ
パブリッシャー	C TWO
Web サイト	https://ctwo.com/
プライバシー ポリシー	https://ctwo.com/privacy-policy/
カテゴリ	ビジネス インテリジェンス。人工知能

C TWO

C TWO は、自動化ワークフローを調整し、人間とロボットの相互作用を管理し、ユニバーサル キューを介して作業項目を処理する Agentic Management Platform です。 このコネクタを使用すると、Power Automate、Power Apps、Azure Logic Apps、Copilot Studioをトリガーし、C TWO セッションによってトリガーしたり、セッション ライフサイクルを管理したり、ユニバーサル キュー項目を作成および処理したり、デジタル ワーカーとの人間とループ内のやり取りを有効にしたりできます。

C TWO は、単一のオーケストレーション、ガバナンス、および監視レイヤーとしてオートメーション資産の上に配置されます。作業を作成または実行するものは何であれ、C TWO は SLA 追跡、再試行と自己復旧、ライブ セッション テレメトリ、完全な監査証跡を追加します。

前提条件

接続を作成する前に、次のものが必要です。

1. アクティブな C TWO テナント ( C TWO Cloud (ホステッド) またはオンプレミスの C TWO サーバーが HTTPS 経由で到達可能です。
2. C TWO 管理者によって発行された サービス アカウント トークン または 個人用アクセス トークン ( 資格情報の取得を参照)。
3. C TWO がオンプレミスでホストされている場合、サーバーは POWER Platform から HTTPS 経由で到達可能である必要があります (ファイアウォールにより、MicrosoftのPower Automate送信 IP 範囲 (Power Platform Geo のサービス タグのAzureConnectors.<region>とPowerPlatformPlexAzure)。
4. カスタム コネクタのアクセス許可を持つ Power Platform 環境と、カスタム コネクタ (Power Automate Premium または同等のコネクタ) をサポートするライセンス層。

接続を作成する

接続を作成するときは、独自の C TWO 環境から 3 つの値を指定します。

1. C TWO ホスト — C TWO サーバーホスト名のみ (スキームなし、末尾のスラッシュなし)、たとえば、 connect24.ctwo.cloud、 ctwo.contoso.com:8443などのオプションのポートを持つオンプレミス ホスト。
2. C TWO ベース URL — 除算を含む C TWO API のベース パス。スラッシュで始まり、末尾にスラッシュを付けず、例: /DEFAULT/CTWO.Server/api。
3. API キー — Bearer <your-token>として入力されたトークン。 サービス アカウント トークンをお勧めします。個人用アクセス トークンも機能します。

Host と Base URL は、コネクタを独自の C TWO サーバー (https://{Host}{Base URL}/…) にルーティングするため、各顧客は独自の環境 (C TWO クラウドまたはオンプレミス) に接続します。

資格情報の取得

認証では、 Authorization ヘッダーでベアラー トークンとして送信された API キーが使用されます。

サービス アカウント トークン (運用環境に推奨)

1. C TWO インスタンスにサインインします。
2. [アプリと接続] → Microsoft Power Automate → [サービス アカウントの作成] に移動します。
3. 生成されたトークンをすぐにコピーします。1 回だけ表示されます。

個人用アクセス トークン (開発/テスト)

1. C TWO でユーザー プロファイルを開きます。
2. [API トークン] タブに移動し、新しいトークンを生成します。
3. すぐにコピーします。これは 1 回だけ表示され、ユーザー アカウントが無効になっている場合は無効になります。

両方のトークンの種類をシークレットとして扱います。これらは Power Platform 接続資格情報にのみ格納され、フロー変数やクライアント側コードには格納されません。

サポートされている操作

• トリガー — C TWO がセッションをディスパッチするときに、強制タイムアウトの有無にかかわらずフローを開始します。
• セッション管理 — 完了/失敗を報告し、型指定されたセッション ログを書き込み、セッション タイムアウトを調整して、グレースフルストップ要求を確認します。
• ユニバーサル キュー — キュー 項目の作成、一覧表示、ロック、ロック解除、再試行、延期。アイテム データを更新し、項目レベルのログを追加する。タグの追加/削除。添付ファイルを取得する。カスタム項目の状態を作成する。キューを一覧表示します。
• Human-in-the-loop — 構造化されたヒューマン アシスタンス フォームを作成、割り当て、割り当て解除、および完全化し、それらを取得/クエリします。

内部ヘルパー操作では、動的ドロップダウン (タスクとユーザー ピッカー) が設定され、直接呼び出されません。

既知の問題と制限事項

• 正しいホストとベース URL が必要です。 どちらも接続時に入力され、コネクタを C TWO サーバーにルーティングします。 値が正しくないか、到達できないと、接続または要求エラーが発生します。
• API キーの形式。 API キー フィールドはリテラル文字列 Bearer <token> を受け取ります。 Bearer プレフィックスを省略すると、 401 Unauthorizedになります。
• JSON 項目データの提供。 項目データ フィールド (Create Queue Item、 Set Queue Item Data) は JSON オブジェクトです。 フローでは、文字列ではなくオブジェクトとして送信されるように、 json('…') 式でリテラル JSON を指定します。
• ポーリング トリガーの待機時間。 プッシュではなくトリガーポーリングを行うため、C TWO でディスパッチされるセッションと開始するフローの間に小さな遅延 (トリガーの繰り返しによって制限されます) があります。
• フォーム フィールドの種類。 フォーム操作によって返される一部の識別子フィールドは、フォームの状態に応じて、整数、文字列、または null である場合があります。

一般的なエラーと解決方法

エラー	考えられる原因	対処法
401 Unauthorized	API キーに Bearer プレフィックスがない、期限切れ、または取り消された	資格情報を Bearer <token>として再入力し、取り消された場合は新しいサービス アカウント トークンを生成します
400 Bad request キュー項目の作成時	必須フィールドがない (reference、 queueItemState、 itemKey)	3 つの必須フィールドをすべて設定する
トリガーが起動しない	間違ったタスクが選択されているか、C TWO タスクがPower Automateに公開されていない	タスクが [タスク ID] ドロップダウンに表示され、C TWO で公開フローとして構成されていることを確認します
エスケープされた文字列として格納されている項目データ	オブジェクトの代わりにテキストとして指定された JSON	json('…')式 (フロー) または Raw Body (コネクタ テスト) を使用して、オブジェクトとして送信します

FAQ

このコネクタは、Power Automateだけでなく、Power Apps、Azure Logic Apps、Copilot Studioから使用できますか? Yes. トリガーはPower Automate固有ですが、接続が作成されると、これらのプラットフォームからすべてのアクションを呼び出すことができます。

このコネクタはライセンスを管理しますか? No. C TWO は実行を調整し、管理します。お客様は、独自のMicrosoft ライセンスに対して責任を負います。

助けはどこで得られますか? customersuccess@ctwo.comで C TWO カスタマー サクセスにお問い合わせください。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト	接続を作成するためのパラメーター。	すべてのリージョン	共有できません

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前	タイプ	Description	必須
C TWO ホスト	文字列	C TWO サーバーホスト名のみ â€" スキームなし、末尾のスラッシュなし。 たとえば、connect24.ctwo.cloud や、ctwo.contoso.com:8443 などのオプションのポートを持つオンプレミス のホストなどです。	True
C TWO ベース URL	文字列	除算を含む C TWO API のベース パス。 スラッシュで始まり、末尾のスラッシュは使用しません。 たとえば、/DEFAULT/CTWO です。サーバー/api。	True
API キー	securestring	次のように入力された C TWO API トークン: Bearer <your-token>。 サービス アカウント トークンをお勧めします。個人用アクセス トークンも機能します。	True

アクション

ID でフォームを取得する	一意の識別子を使用して、特定のロボット相互作用フォームを取得します。 このアクションを使用して、デジタル ワーカーによって作成された人間のループ内フォームの詳細、フィールド、および現在の状態を取得します。
キュー 項目の作成	指定したユニバーサル キューに新しい作業項目を作成します。 データ ペイロード、タグ、オプションの添付ファイルなど、デジタル ワーカーによる処理用の項目を追加するには、このアクションを使用します。
キュー 項目の添付ファイルを取得する	キュー項目から特定の添付ファイルを base64 でエンコードされたデータとして取得します。 作成または処理中に作業項目に添付されたファイルをダウンロードするには、このアクションを使用します。
キュー 項目の状態を作成する	特定のキュー内に新しいカスタム状態を作成します。 カスタム状態を使用すると、既定の状態 (保留中、完了、参照済み) を超えてワークフロー ステージを定義し、ビジネス プロセスに合わせてキューを調整できます。
キュー 項目の状態を設定する	キュー項目の状態を変更します (たとえば、保留中から完了、カスタム状態など)。 このアクションを使用して、ワークフロー パイプラインを通じて項目を進めます。
キュー 項目を取得する	状態、タグ、日付、キュー名など、指定されたフィルター条件に基づいてキュー項目を取得します。 このアクションを使用して、ユニバーサル キュー全体の作業項目を検索および監視します。
キュー 項目データの設定	キュー項目のデータ内容を更新します。 中間結果を格納するなど、処理中に作業項目のペイロードを変更するには、このアクションを使用します。
キューを取得する	フィルター条件に基づいてユニバーサル キューを取得します。 このアクションを使用して、使用可能なキューの一覧表示、構成の確認、またはキューの詳細の検索を行います。 この操作では、他のアクションの動的ドロップダウンも有効になります。
キュー項目からタグを削除する	キュー項目から 1 つ以上のタグを削除します。 処理中に作業項目の分類を更新するには、このアクションを使用します。
キュー項目にタグを追加する	分類とフィルター処理のために、キュー項目に 1 つ以上のタグを追加します。 タグは、複数のキューで作業項目を整理および検索するのに役立ちます。
キュー項目にログを追加する	監査証跡と追跡可能性のために、ログ メッセージをキュー項目に追加します。 特定の作業項目に対する処理ステップ、警告、またはエラーを記録するには、このアクションを使用します。
キュー項目のロック	キュー項目をロックして、他のワーカーが同時に処理できないようにします。 排他アクセスを確保するために作業項目を処理する前に、このアクションを使用します。
キュー項目のロック解除	以前にロックされたキュー項目のロックを解除し、使用可能な状態に戻します。 このアクションは、処理が中断され、他の worker に対してアイテムを解放する必要がある場合に使用します。
キュー項目の延期	指定した日付/時刻まで処理されないように、キュー項目を延期します。 このアクションは、アイテムを今すぐ処理できないが、後で再試行する必要がある場合に使用します。
セッション タイムアウトの設定	アクティブな C TWO セッションのタイムアウト値を更新します。 このアクションを使用して、元のタイムアウトに調整が必要な場合に、実行中のセッションで許可される実行時間を延長または短縮します。
セッションにログを追加する	C TWO セッションにログ エントリを書き込みます。 このアクションを使用して、フローの実行中に進行状況の追跡、意思決定の記録、診断情報のログ記録を行います。 監査とトラブルシューティングのために、C TWO プラットフォームにログが表示されます。
セッションを停止する必要がある	C TWO が特定のセッションに対してグレースフル (ソフト) 停止を要求したかどうかを確認します。 ループ内でこのアクションを使用して、セッションを早期に終了する必要があるかどうかを定期的に確認し、フローが停止する前にリソースをクリーンアップできるようにします。
フォームの作成	デジタルワーカーが人の支援を求める新しいロボットインタラクションフォームを作成します。 このフォームは、C TWO プラットフォームの割り当てられたユーザーに提示され、例外や複雑な決定を処理するために人間の専門知識が必要な人間のインザループ シナリオを可能にします。
フォームの割り当て	ロボット操作フォームを特定のユーザーに割り当てて、人間のループ内要求の確認と完了を担当させます。
フォームの割り当てを解除する	ロボット操作フォームから現在のユーザー割り当てを削除し、他のユーザーが要求できるようにします。
フォームを取得する	オプションのフィルター処理を使用して、ロボットの相互作用フォームの一覧を取得します。 このアクションを使用して、保留中の human-in-the-loop 要求のクエリ、状態の確認、または特定のユーザーに割り当てられたフォームの検索を行います。
フロー実行状態を失敗に設定する	C TWO セッションを失敗としてマークし、フローの実行中にエラーが発生したことを通知します。 エラー処理スコープでこのアクションを使用して、エラーを C TWO に報告し、問題の詳細を報告します。
フロー実行状態を完了に設定する	C TWO セッションを完了としてマークし、フローが正常に作業を完了したことを通知します。 このアクションをフローの最後に配置して、自動化がエラーなしで完了したことを C TWO に報告します。
再試行キュー項目	特定のキュー項目を再試行し、データを元の値に戻し、新しい試行を作成します。
完全なフォーム	ロボット操作フォームを完了としてマークし、人間のユーザーが要求された入力を提供し、デジタル ワーカーが処理を再開できることを通知します。

ID でフォームを取得する

キュー 項目の作成

キュー 項目の添付ファイルを取得する

キュー 項目の状態を作成する

キュー 項目の状態を設定する

キュー 項目を取得する

キュー 項目データの設定

キューを取得する

キュー項目からタグを削除する

キュー項目にタグを追加する

キュー項目にログを追加する

キュー項目のロック

キュー項目のロック解除

キュー項目の延期

セッション タイムアウトの設定

セッションにログを追加する

セッションを停止する必要がある

フォームの作成

フォームの割り当て

フォームの割り当てを解除する

フォームを取得する

フロー実行状態を失敗に設定する

フロー実行状態を完了に設定する

再試行キュー項目

完全なフォーム

トリガー

タイムアウトでセッション要求からのフローを開始する	新しい C TWO セッションをポーリングし、タイムアウト制約を使用してフローをトリガーします。 このトリガーは、特定の時間枠内に自動化を完了する必要がある場合に使用します。 セッションがタイムアウトを超えた場合、C TWO はタイムアウト ポリシーに従ってセッションを処理します。
タイムアウトなしでセッション要求からフローを開始する	新しい C TWO セッションをポーリングし、選択したタスクのセッションが作成されたときにフローをトリガーします。 自動化にタイムアウト制約が必要ない場合は、このトリガーを使用します。 フローは、C TWO から渡された入力値を含むセッションの詳細を受け取ります。

タイムアウトでセッション要求からのフローを開始する

タイムアウトなしでセッション要求からフローを開始する

定義

文字列

オブジェクト