This HTML page is not optimized for LLM or AI agent consumption. Fetch the Markdown version instead: /guides/workflow-automation/ai-capabilities-in-workflow/workflow-assistant.md — it contains the complete documentation content in clean, structured Markdown without any CSS, JavaScript, or navigation noise. Workflow Assistant

Workflow Assistant in Nutrient Workflow Automation is a conversational assistant in the portal. It answers questions about a user’s forms, processes, requests, tasks, files, and users by using live workflow data instead of generic product documentation.

When you enable Workflow Assistant for a tenant, it replaces the existing Ask AI chatbot button in the portal. Tenants that don’t use Workflow Assistant continue to show the existing Ask AI widget.

Workflow Assistant is in beta. It’s read-only in this release — it can search and explain data, but it can’t create, edit, or delete records.

The following image shows the chat sidebar’s empty state.

What Workflow Assistant can do today

Workflow Assistant can answer questions across several workflow areas. The following table shows representative prompts.

CategoryExample prompts
Tasks“What tasks do I have?”, “Show my overdue tasks”
Requests“Show request 762,” “List my in-progress requests”
Search“Find processes about onboarding,” “Search forms about leave”
Reports“Run the monthly summary report”
File analysis“Read the term sheet attachment on request 762”

File-analysis capability for PDFs and images varies by model. If a user asks the assistant to read a file type the selected model doesn’t support, the assistant tells the user to ask their administrator to switch models.

The following image shows a task response.

Use chat controls and tool-call details

Use the chat controls to stop a response, clear the chat, and inspect tool calls.

While Workflow Assistant generates a response, use the stop control to end the response immediately. Use it when the assistant answers the wrong question, takes an approach you don’t need, or produces a response you no longer want.

Use Clear to reset the chat view and abort any in-flight request. This stops the active response instead of only clearing what appears on screen.

When the assistant uses tools to answer a question, Tool calls appear in the chat. Expand a tool call to review the parameters sent and the payload returned. Repeated calls to the same tool are grouped together so multistep responses stay readable.

What Workflow Assistant can’t do yet

The current release has these limits:

  • It can’t create, edit, or delete workflow records.
  • It can’t approve, reject, or otherwise transition tasks on the user’s behalf.
  • It can’t return data that the calling user isn’t permitted to see in the UI. Every assistant action runs in the user’s security context.

Enable Workflow Assistant for your tenant

Workflow Assistant is in beta and is available only if your license includes the Workflow Assistant module. To add the Workflow Assistant module to your license, contact Nutrient Support.

After your license includes the Workflow Assistant module, configure the AI source that the assistant should use and grant access to the users or teams that need it. Until you configure an AI source, the assistant tells users to contact their administrator.

Who can use Workflow Assistant

Permissions control access to Workflow Assistant, just as they control access to other items in Nutrient Workflow Automation. Your tenant’s license must include the Workflow Assistant module. Without this module, no one has access, regardless of permissions.

Workflow Assistant has three permission types:

  • Run — Open and use the Workflow Assistant chat.
  • Grant — Manage Workflow Assistant role memberships, including assigning the Assistant User and Assistant Admin roles to other users and groups.
  • Choose AI Source — Pick which AI source answers your own chat instead of using the tenant default.

Nutrient Workflow Automation ships two built-in roles that combine these permissions:

RoleRunGrantChoose AI SourceTypical assignment
Assistant UserYesBusiness users who use the chat.
Assistant AdminYesYesYesAdministrators who manage who can use the assistant and which AI sources it uses.

By default, neither role is assigned to users or groups. Only system administrators can use Workflow Assistant until you grant access to others.

Workflow Assistant always runs in the calling user’s security context. The Run permission lets a user open the chat; it never lets them see data they couldn’t already see in the portal.

Grant access to other users

To enable non-administrator users to use Workflow Assistant, assign them the Assistant User or Assistant Admin role.

  1. Open Settings → Workflow Assistant. This entry appears for system administrators and for any user who holds the Grant permission on Workflow Assistant.
  2. Review the Workflow Assistant roles page. It lists the Assistant User and Assistant Admin roles.
  3. Select the Show Members icon for the role you want to assign.
  4. Add the users or groups that should have the role.

For the full mechanics of adding members to a role, refer to the managing roles and permissions guide.

Select the Workflow Assistant AI source

Workflow Assistant uses an AI connection that you control, just like other AI features in Nutrient Workflow Automation. Use the dedicated setting to choose the connection.

Before you start, make sure you’ve set up at least one AI connection. If you haven’t, refer to the common AI configurations guide.

You can select an AI source at two levels: a tenant-wide default, and an optional per-user choice.

Set the tenant default

The tenant default applies to every user who hasn’t chosen their own AI source.

  1. Open Settings → System Config.
  2. Locate the AssistantAISource row. This row is visible only when your license includes the Workflow Assistant module.
  3. Select the AI connection that you want Workflow Assistant to use.
  4. Save your changes.

The following image shows the AssistantAISource setting.

Let users choose their own AI source

Users who hold the Choose AI Source permission, which is included in the Assistant Admin role, see an AI Source picker at the bottom of the chat sidebar. They can select any AI source they’re permitted to run, and the system remembers their choice across sessions and devices. Users without this permission don’t have access to the picker, and their messages use the tenant default.

If no AI sources are configured, the picker links to System Settings → AI Sources instead of showing options.

Troubleshooting

If Workflow Assistant doesn’t behave as expected, use the following table to identify the cause and next step.

SymptomLikely causeWhat to do
The Workflow Assistant icon doesn’t appear in the portalYour license doesn’t include the Workflow Assistant module, or you don’t hold the Run permission on Workflow AssistantConfirm your license includes the module by contacting Nutrient Support. If the license is in place, ask your administrator to assign you the Assistant User or Assistant Admin role
The AI Source picker doesn’t appear in the chatYou don’t hold the Choose AI Source permissionYour messages use the tenant default AI source. To choose your own, ask your administrator for the Assistant Admin role
AssistantAISource row is missing from System ConfigYour license doesn’t include the Workflow Assistant moduleThe row is shown only when your license includes the Workflow Assistant module. Contact Nutrient Support if you expect it to be available
Assistant replies “no AI source configured”The assistant is enabled, but no AI connection has been selected as the sourceIn Settings → System Config, select an AI connection as AssistantAISource
Assistant says it can’t read an attached fileThe selected AI model doesn’t support that file typeSelect a model that supports the file type as the assistant source