What are Content Activities?

Content Activities are a type of process block that displays information to users rather than executing actions in external systems. They allow you to surface relevant content—such as knowledge articles, forms, or formatted text—at key moments in a conversation workflow.

When to Use Content Activities

Content Activities are ideal when you want to:

• Present helpful information instead of executing an action (e.g., when a user doesn't have permissions to perform an operation)
• Surface a form for ordering or requesting something without direct API integration
• Provide contextual guidance mid-workflow before proceeding to the next step
• Display dynamic results from previous activities in a user-friendly format

Content Types

Content Activities support three types of content:

Text (Markdown)

Display formatted text using Markdown syntax. Useful for providing instructions, confirmations, or dynamic messages that reference data from the conversation.

Your request for **{{item_name}}** has been submitted.

Order ID: {{order_id}}
Expected delivery: {{delivery_date}}

Knowledge Articles

Surface relevant knowledge articles from your organization's knowledge base. Knowledge articles are ingested from connected systems and can be presented when:

• A user asks a question that has an existing answer in your KB
• The user lacks permissions to execute an action, but a self-service article exists
• You want to provide additional context or instructions

Knowledge articles come from the articles your AI Assistant has ingested from your connected knowledge management systems. Moveworks automatically indexes these articles, making them available for Content Activities to surface contextually.

Forms

Present forms for users to complete requests, place orders, or submit information. Forms provide a guided experience for common service requests.

Forms come from the catalog items and request types your AI Assistant has ingested from your connected service management systems. When a form is surfaced, users can either fill it out in chat (if the form meets fillability requirements) or click through to the web form in the source system.

Use Cases

Presenting Knowledge Instead of Executing Actions

When a user lacks the permissions to perform an action, you can use a Content Activity to surface a relevant knowledge article with self-service instructions.

Example Flow:

1. User requests: "Reset my MFA"
2. Plugin checks if automated reset is available for this user
3. If not → Content Activity displays a knowledge article with manual reset steps

flowchart TD
    A[Start] --> B[Check MFA Reset Eligibility]
    B --> C{user.has_automated_mfa_reset}
    C -->|Yes| D[Execute MFA Reset<br/>Action Activity]
    C -->|No| E[Content Activity:<br/>How to Reset MFA Manually]
    D --> F[End]
    E --> F

Surfacing Forms for Requests

When a user wants to order something or submit a request, you can surface the appropriate form directly in the conversation.

Example Flow:

1. User requests: "I need a new laptop"
2. Plugin identifies this as a hardware request
3. Content Activity displays the "Hardware Request" form
4. User completes and submits the form

This approach is useful when:

• You don't have direct API access to create the request
• The form includes fields that require user input
• You want to leverage existing approval workflows in your ITSM

Access Controls

Knowledge articles and forms respect the access controls configured in your enterprise search permissions. This ensures users only see content they're authorized to access.

If a user doesn't have access to the knowledge article or form you're trying to surface, the Content Activity will not display that content. Design your workflows with fallback paths for users without access.

For detailed configuration, see Enterprise Search Permissions.

Dynamically Referencing Data

Use Mustache syntax ({{key}}) to reference data from the data bank (e.g., slots or outputs from previous actions) in a Content Activity. No data. prefix is needed.

Example: Referencing Slot Values

Your ticket {{ticket_number}} has been processed.

Example: Accessing Array Elements

For the JSON structure:

{  
  "ticket_list": ["ticket1", "ticket2", "ticket3"]  
}

Use dot notation:

First ticket: {{ticket_list.0}}

📘

DSL syntax is not supported within Mustache syntax. Keep dynamic references simple.

Best Practices

1. Use knowledge for self-service - When users can't execute an action, provide helpful articles instead of dead ends
2. Surface forms contextually - Present forms when you've identified the user's intent, not as a generic fallback
3. Design permission-aware flows - Include conditional logic to handle cases where users lack access to content
4. Keep text concise - Content Activities should provide value quickly; link to full articles for details
5. Test across user roles - Verify that permissions work correctly for different user groups