Adobe CX Enterprise Coworker modules

Use the Adobe CX Enterprise Coworker connector in Adobe Workfront Fusion to send a natural-language prompt to Coworker and use its response in a scenario. Coworker interprets your request and can use tools available to your account to carry out the work.

The connector provides two modules:

  • Run a Prompt starts a new request and, by default, waits for the result.
  • Get Execution Status checks a request that you started earlier.

Access requirements

Expand to view access requirements for the functionality in this article.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront package

Any Adobe Workfront Workflow package and any Adobe Workfront Automation and Integration package

Workfront Ultimate

Workfront Prime and Select packages, with an additional purchase of Workfront Fusion.

Adobe Workfront licenses

Standard

Work or higher

Product If your organization has a Select or Prime Workfront package that does not include Workfront Automation and Integration, your organization must purchase Adobe Workfront Fusion.

For more detail about the information in this table, see Access requirements in documentation.

Prerequisites

YOu must have an Adobe account that has access to Adobe CX Enterprise Coworker.

Connect Adobe CX Enterprise Coworker to Workfront Fusion

Sign in with an Adobe account that has access to Coworker and any services needed for your request.

To create a connection:

  1. In the Adobe Fusion MCP module, click Add next to the Connection field.

  2. Fill in the following fields:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    Connection name Enter a name for this connection.
    Environment Select whether you are connecting to a production or non-production environment.
    Type Select whether you are connecting to a service account or a personal account.
    Client ID Enter or map an optional override for this connection. Otherwise, use this account type's platform-managed clientId. Register the displayed Fusion callback URL for the dedicated Coworker account..
    Client secret Enter or map an optional override for this connection. Otherwise use this account type's platform-managed clientSecret. Use credentials issued for the configured IMS environment.
  3. Click Continue.

If you cannot sign in or use a required service, contact your administrator.

Adobe CX Enterprise Coworker modules and their fields

WARNING
Never include passwords or other credentials in a prompt.

Get Execution Status

This action module checks the current state of a task started by Run a Prompt.

This module checks the task once. It does not start a new task or keep checking until the task completes. If the result is still pending, check again later.

NOTE
Do not convert the Task ID to a number, round it, or reformat it. If Coworker answered the original prompt immediately without a Task ID, you do not need to check the status.
Include raw result (Optional, advanced)
This option is off by default. Include the full Coworker response in the output. The response might contain sensitive information.
Connection
Select the same connection that you used in the original Run a Prompt execution.
Task ID
Map the Task ID returned by Run a Prompt. Keep it as text exactly as returned.

Run a Prompt

This action module sends an instruction to Coworker, such as summarizing text or gathering information using tools available to your account.

Each run sends the prompt once and starts a new conversation. You do not need to select an AI model or provide a separate AI-provider key.

Connection
Select your Coworker connection. For instructions, see Connect Adobe CX Enterprise Coworker to Workfront Fusion in this article.
User prompt
Enter your instruction. You can use multiple lines and map information from earlier modules.
Wait for completion (Optional, advanced)

This option is on by default. Enable this option if you want the module to wait for the task to finish or require attention. Turn it off to return the initial result immediately.

For more information, see Wait for completion in this article.

Include raw result (Optional, advanced)
This option is off by default. Enable this option if you want the module to include the full Coworker response in the output. The response might contain sensitive information.
NOTE
We recommend leaving Include raw result off unless you need the full response for a specific purpose. Raw results might contain sensitive information, and they are not a guaranteed complete record of every action. Review what a raw result contains before you save it, share it, or pass it to another service.

Wait for completion

When Wait for completion is on, the module checks the task after a five-second wait. If the task is still pending, the module waits another five seconds before checking again. Each check also takes time to receive a response. Checking the status does not send the prompt again.

Waiting stops when the task completes, fails, is canceled or rejected, or needs your input or authorization. If Coworker provides an immediate answer, the module returns it without further checks.

When Wait for completion is off, the module returns the first result without waiting for the task to finish. Inspect State, Completed, and Requires attention to decide what to do next. A task can already be completed when the first result arrives.

Waiting is subject to Fusion’s module timeout. If the module times out or stops, Coworker might continue working. In that case, you might not receive an output or a task ID.

For longer work, turn waiting off and save the initial Task ID so you can check the task later. Do not automatically run the prompt again after a timeout. The first request might already be in progress, and repeating it can duplicate changes.

Module output

Both modules return the following information when they finish without an error.

Task ID
Identifies the task. This is empty when Coworker provides an immediate answer without creating a task. Use this value with Get Execution Status.
Context ID

Identifies the conversation. It is not an input for continuing the conversation.

For more information, see Use previous answers in this article.

State
The current task state. See Task states in this article.
Completed
True when the task completes or Coworker provides an immediate answer.
Requires attention

True when Coworker needs input or authorization.

For more information, see Requests that need attention in this article.

Final assistant text
The final answer when the task is completed. This is empty while the task is pending or requires attention. A completed response can also have no answer text.
Text artifacts (may include intermediate text)
Text returned during the work. Each item can include an Artifact ID, Name, and Text. These items are not necessarily final answers.
Raw result (opt-in)
The full response. This is included only when Include raw result is on.

Use Final assistant text for the answer instead of combining all text artifacts. Artifacts can include progress descriptions or other intermediate text.

Requests that need attention

Coworker might need more information or authorization before it can continue. When this happens, Requires attention is true and Completed is false. Route the result to a person instead of treating it as completed work.

These modules cannot answer a follow-up question or approve an action on your behalf. Get Execution Status can check whether the task’s state has changed, but it does not resolve the request for input or authorization.

Use previous answers

Every Run a Prompt execution starts a new conversation. To refer to an earlier answer, include the relevant question and answer as text in your new prompt. This gives Coworker context, but it does not resume the previous conversation.

Context ID identifies the conversation associated with the result. You cannot supply it to these modules to continue a conversation.

IMPORTANT
Completed does not guarantee that the requested business action succeeded. For example, Coworker might finish by explaining that a required tool was unavailable. Review the answer and verify any required result before you take the next action.

Task states

submitted, working
The task is pending. Completed is false. Run a Prompt continues waiting when waiting is on. Otherwise, save the Task ID and check later.
completed
Completed is true. Review Final assistant text and the expected result.
input-required, auth-required
The task needs attention. Completed is false and Requires attention is true. Waiting stops. Route the result for human review.
failed, canceled, rejected
The module reports an error instead of a normal result.

A pending result, or a result that requires attention, is not a successful completion, even if the module returns without an error.

Examples

Summarize an update

  1. Add Run a Prompt and select your connection.

  2. Enter the following in the User prompt field:

    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. Leave Wait for completion on and Include raw result off.

  4. If Requires attention is true, route the result for human review. If Completed is true, map Final assistant text into your next step.

AI-generated wording can vary. Review results where accuracy matters.

Check a longer task later

  1. Add Run a Prompt, select your connection, and enter your instruction.

  2. Turn Wait for completion off.

  3. Inspect the initial result.

    • If the task is completed, process the result.
    • If the task requires attention, route the result for review.
    • If the task is pending, save the Task ID as text and note which connection you used.
  4. Later, use Get Execution Status with that connection and Task ID.

  5. If the task is still pending, arrange another check within your scenario’s limits. Process the result once on completion, and handle attention or errors separately.

Do not run the original prompt again just to check its progress.

Usage considerations

  • Coworker can use tools and perform actions allowed by your account, including changes to records. Use trusted prompts and an account with appropriate access.
  • These modules do not provide a way to restrict individual tools. Instructions such as “do not change anything” describe your intent, but they are not an enforced read-only mode.
  • Available tools and skills vary by account. The connector does not provide a skill selector or guarantee a particular action, such as creating a journey or updating a project. Do not assume that requests that need approval will complete unattended.
  • The connector starts and checks Coworker requests. It does not monitor project changes or automatically save answers to another application. Add the appropriate trigger, storage, and follow-on modules to your scenario as needed.
  • AI-generated answers can be incomplete or inaccurate. Validate important results before you use them to make changes or decisions.
  • The connector does not automatically retry a failed request. Make sure your scenario’s error handling does not repeat a prompt whose outcome is uncertain.

Troubleshooting

A required field is missing
Select a connection and enter the required prompt or Task ID.
Sign-in fails or access is denied
Sign in again, and check that your Adobe account has access to Coworker and the required services. Contact your administrator if needed.
Task not found
Check that the Task ID is unchanged and that you are using the original connection. A new task might not be visible immediately. Check the status later instead of sending the prompt again.
A status check fails
If the error includes the accepted Task ID, use Get Execution Status to investigate that task. Do not restart the prompt automatically.
Run a Prompt times out or loses its response
The task might have started even if you did not receive its ID. Investigate before you repeat the request, to avoid duplicate work.
Fusion times out while waiting
Coworker might still be working. Check the task if you have its ID. For future long tasks, turn waiting off and save the initial ID first.
Coworker or a required service is unavailable
Share the displayed error with your administrator, without credentials or sensitive result content.
recommendation-more-help
workfront-fusion-help-workfront-fusion