Adobe CX Enterprise Coworkerモジュール

Adobe Workfront FusionのAdobe CX Enterprise Coworker コネクタを使用して、自然言語のプロンプトをCoworkerに送信し、その応答をシナリオで使用します。 チームメンバーは、リクエストを解釈し、アカウントのツールを使用して作業を遂行します。

コネクタには、次の2つのモジュールがあります。

  • プロンプトを実行​すると、新しいリクエストが開始され、デフォルトでは結果が待たれます。
  • 実行ステータスを取得​は、以前に開始したリクエストを確認します。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ

任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ

Workfront Ultimate

Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。

Adobe Workfront ライセンス

標準

Work またはそれ以上

製品 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。

この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。

前提条件

ADOBE CX ENTERPRISE COWORKERへのアクセス権を持つAdobe アカウントが必要です。

Adobe CX Enterprise CoworkerとWorkfront Fusionの連携

Coworkerおよびリクエストに必要なサービスにアクセスできるAdobe アカウントでログインします。

接続を作成するには:

  1. Adobe Fusion MCP モジュールで、接続 フィールドの横にある​ 追加 ​をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    接続名 この接続の名前を入力します。
    環境 実稼動環境と非実稼動環境のどちらに接続するかを選択します。
    タイプ サービスアカウントと個人アカウントのどちらに接続するかを選択します。
    クライアント ID この接続のオプションの上書きを入力またはマッピングします。 それ以外の場合は、このアカウントタイプのplatform-managed clientIdを使用します。 専用Coworker アカウントの表示されたFusion コールバック URLを登録します。
    クライアント秘密鍵 この接続のオプションの上書きを入力またはマッピングします。 それ以外の場合は、このアカウントタイプのプラットフォームで管理されるclientSecretを使用します。 設定されたIMS環境に対して発行された資格情報を使用します。
  3. 「続行」をクリックします。

ログインできない場合や、必要なサービスを使用できない場合は、管理者にお問い合わせください。

Adobe CX Enterprise Coworker モジュールとそのフィールド

WARNING
プロンプトにパスワードやその他の資格情報を絶対に含めないでください。

実行ステータスを取得

このアクションモジュールは、プロンプトの実行​によって開始されたタスクの現在の状態を確認します。

このモジュールは、タスクを1回チェックします。 新しいタスクを開始したり、タスクが完了するまでチェックを続けたりすることはありません。 結果がまだ保留中の場合は、後でもう一度確認してください。

NOTE
タスク IDを数値に変換したり、丸めたり、再フォーマットしたりしないでください。 同僚がタスク IDなしで即座に元のプロンプトに回答した場合、ステータスを確認する必要はありません。
Include raw result (Optional, advanced)
このオプションはデフォルトでオフになっています。 出力に完全なCoworker応答を含めます。 応答には機密情報が含まれている可能性があります。
Connection
元の プロンプトを実行 実行で使用したのと同じ接続を選択します。
Task ID
が返したタスク IDをマッピングします。プロンプトを実行します。 返されたテキストとまったく同じようにしてください。

プロンプトの実行

このアクションモジュールは、アカウントで利用可能なツールを使用してテキストの要約や情報の収集などの指示を共同作業者に送信します。

実行ごとにプロンプトを1回送信し、新しい会話を開始します。 AI モデルを選択したり、別のAI プロバイダーのキーを指定したりする必要はありません。

Connection
Coworker接続を選択します。 手順については、この記事の「Adobe CX Enterprise CoworkerをWorkfront Fusionに接続する」を参照してください。
ユーザープロンプト ​
命令を入力してください。 複数の行を使用して、以前のモジュールの情報をマッピングできます。
Wait for completion (Optional, advanced)

このオプションはデフォルトでオンになっています。 モジュールでタスクが完了するのを待つ場合や、注意が必要な場合は、このオプションを有効にします。 最初の結果をすぐに返すには、オフにします。

詳しくは、この記事の「完了を待つ」を参照してください。

Include raw result (Optional, advanced)
このオプションはデフォルトでオフになっています。 このオプションを有効にすると、モジュールがCoworkerの全応答を出力に含めることができます。 応答には機密情報が含まれている可能性があります。
NOTE
特定の目的のために完全な応答が必要な場合を除き、生の結果を含める​をオフにすることをお勧めします。 生の結果には機密情報が含まれている可能性があり、すべてのアクションの完全な記録が保証されるわけではありません。 生の結果を保存、共有、または別のサービスに渡す前に、その結果に含まれるものを確認します。

完了を待機

完了を待つ​がオンになっている場合、モジュールは5秒間待ってからタスクを確認します。 タスクがまだ保留中の場合、モジュールは再度チェックするまでさらに5秒待ちます。 各チェックは、応答を受け取るのにも時間がかかります。 ステータスを確認しても、プロンプトは再度送信されません。

待ち時間は、タスクが完了、失敗、キャンセルまたは却下された場合、または入力または承認が必要な場合に停止します。 Coworkerが即座に回答を提供した場合、モジュールはそれ以上のチェックなしで返します。

完了を待つ​がオフの場合、モジュールはタスクが完了するのを待たずに最初の結果を返します。 状態、完了済み、を調査するには、次に何をすべきかを決定するために注意​が必要です。 最初の結果が届いたときにすでにタスクを完了できます。

待機中はFusionのモジュールタイムアウトの対象となります。 モジュールがタイムアウトまたは停止した場合、共同作業者は引き続き作業を行います。 その場合、出力やタスク IDを受け取らない可能性があります。

長い作業の場合は、待ち時間をオフにして最初の​ タスク ID ​を保存し、後でタスクを確認できるようにします。 タイムアウト後にプロンプトを再度自動的に実行しないでください。 最初のリクエストは既に進行中の場合があり、それを繰り返すと変更が重複する可能性があります。

モジュール出力

どちらのモジュールも、エラーなしで終了すると、次の情報を返します。

Task ID
タスクを識別します。 同僚がタスクを作成せずに即座に回答を提供する場合、これは空です。 この値を Get Execution Status で使用します。
コンテキスト ID

会話を識別します。 会話を続けるためのインプットではありません。

詳しくは、この記事の「以前の回答を使用」を参照してください。

State
現在のタスクの状態。 この記事の タスクの状態を参照してください。
Completed
Trueを指定すると、タスクが完了するか、共同作業者がすぐに回答します。
は注意が必要です

同僚が入力または承認を必要とする場合はTrueです。

詳しくは、この記事の「注意が必要なリクエスト」を参照してください。

Final assistant text
タスクが完了した時点での最終回答。 タスクが保留中または注意が必要な場合は、このフィールドは空です。 回答が完成した場合は、回答テキストがない場合もあります。
テキスト アーティファクト (中間テキストを含める場合があります) ​
作業中にテキストが返されます。 各アイテムには、アーティファクト ID、名前、テキストを含めることができます。 これらの項目は必ずしも最終的な答えではない。
Raw結果(オプトイン) ​
完全な回答です。 これは、Include raw resultがオンの場合にのみ含まれます。

すべてのテキストアーティファクトを組み合わせるのではなく、回答に​ 最終アシスタントテキスト ​を使用します。 成果物には、進捗状況の説明やその他の中間テキストを含めることができます。

注意が必要なリクエスト

作業を続けるには、より多くの情報や承認が必要になる場合があります。 この場合、要注意​はtrueで、完了​はfalseです。 完了済みの作業として処理するのではなく、結果を個人にルーティングします。

これらのモジュールは、フォローアップの質問に答えたり、ユーザーに代わってアクションを承認したりすることはできません。 実行ステータスを取得​は、タスクの状態が変更されたかどうかを確認できますが、入力または承認の要求は解決されません。

以前の回答を使用

プロンプトを実行​するたびに、新しい会話が開始されます。 以前の回答を参照するには、新しいプロンプトに関連する質問と回答をテキストとして含めます。 これにより、同僚のコンテキストが得られますが、以前の会話は再開されません。

コンテキスト ID​は、結果に関連付けられている会話を識別します。 会話を続けるために、これらのモジュールにデータを供給することはできません。

IMPORTANT
Completed​は、要求されたビジネス アクションが成功したことを保証するものではありません。 たとえば、同僚が、必要なツールが利用できないことを説明して終了する場合があります。 回答を確認し、必要な結果を確認してから次の操作を行います。

タスクの状態

submitted, working
タスクは保留されています。 Completedはfalseです。 プロンプトの実行は、待機中の待機中も待機中です。 それ以外の場合は、タスク IDを保存して後で確認してください。
completed
Completedはtrueです。 Final assistant textを確認し、期待される結果を確認してください。
input-required, auth-required
タスクには注意が必要です。 Completedはfalseで、Requires attentionはtrueです。 キャンセル待ち。 人間によるレビューの結果のルーティング:
failed, canceled, rejected
モジュールは、通常の結果ではなくエラーを報告します。

保留中の結果、つまり注意が必要な結果は、モジュールがエラーなしで返されても、正常に完了しません。

例

更新の要約

  1. プロンプトを実行​を追加し、接続を選択します。

  2. 「ユーザープロンプト」フィールドに次の項目を入力します。

    code language-text
    Summarize the following project update in three bullet points.
    Use only the supplied text; do not call tools or change any records.
    
    The planning workshop is complete. Two dependencies need confirmation.
    The team will review the delivery estimate on Friday.
    
  3. 完了待ち​を残し、生の結果を含める​をオフにします。

  4. 要注意​がtrueの場合は、人間によるレビューのために結果をルーティングします。 Completed​がtrueの場合、最終アシスタントのテキスト​を次のステップにマッピングします。

AIで生成された文言はさまざまです。 正確性が重要な場合は結果の確認:

後で長いタスクを確認する

  1. プロンプトを実行​し、接続を選択し、指示を入力します。

  2. 完了を待つ​をオフにします。

  3. 最初の結果を確認します。

    • タスクが完了したら、結果を処理します。
    • タスクに注意が必要な場合は、結果をレビュー用にルーティングします。
    • タスクが保留中の場合は、タスク ID​をテキストとして保存し、使用した接続をメモします。
  4. 後で、その接続とタスク IDで​ 実行ステータスを取得 ​を使用します。

  5. タスクがまだ保留中の場合は、シナリオの制限内で別のチェックを手配します。 完了時に結果を1回処理し、注意やエラーを個別に処理します。

進行状況を確認するためだけに、元のプロンプトを再度実行しないでください。

使用上の考慮事項

  • チームメンバーは、ツールを使用して、レコードの変更など、アカウントで許可されたアクションを実行できます。 信頼できるプロンプトと、適切なアクセス権を持つアカウントを使用する。
  • これらのモジュールは、個々のツールを制限する方法を提供しません。 「何も変更しない」などの指示は、意図を表しますが、強制された読み取り専用モードではありません。
  • 利用できるツールとスキルはアカウントによって異なります。 コネクターは、スキルセレクターを提供しないか、ジャーニーの作成やプロジェクトの更新など、特定のアクションを保証しません。 承認が必要なリクエストが無人で完了すると仮定しないでください。
  • コネクターは同僚のリクエストを開始してチェックします。 プロジェクトの変更を監視したり、別のアプリケーションへの回答を自動的に保存したりすることはありません。 必要に応じて、適切なトリガー、ストレージ、フォローオンモジュールをシナリオに追加します。
  • AIが生成した回答は不完全または不正確な場合があります。 重要な結果を事前に検証し、変更や意思決定に役立てることができます。
  • コネクタは、失敗したリクエストを自動的に再試行しません。 シナリオのエラー処理で、結果が不確実なプロンプトが繰り返されないようにします。

トラブルシューティング

必須フィールドがありません
接続を選択し、必要なプロンプトまたはタスク IDを入力します。
ログインに失敗するか、アクセスが拒否されました
もう一度ログインし、Adobe アカウントがCoworkerと必要なサービスにアクセスできることを確認します。 必要に応じて、管理者に連絡してください。
タスクが見つかりません
タスク IDが変更されていないこと、および元の接続を使用していることを確認してください。 新しいタスクはすぐに表示されない場合があります。 もう一度プロンプトを送信する代わりに、後でステータスを確認します。
ステータスチェックが失敗する
エラーに使用可能なタスク IDが含まれている場合は、Get Execution Statusを使用して、そのタスクを調査します。 プロンプトを自動的に再起動しないでください。
プロンプトを実行すると、応答がタイムアウトまたは失われる
IDを受け取っていない場合でも、タスクが開始されている可能性があります。 重複する作業を避けるために、リクエストを繰り返す前に調査します。
待機中にFusionがタイムアウトする
同僚はまだ働いているかもしれません。 IDがある場合は、タスクを確認します。 今後の長いタスクの場合は、待ち時間をオフにして、最初に最初のIDを保存します。
同僚または必要なサービスが利用できません
表示されたエラーを、資格情報や機密性の高い結果コンテンツを使用せずに、管理者と共有します。
recommendation-more-help
workfront-fusion-help-workfront-fusion