For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DeveloperAcademyCommunityStatus
ReferenceGuides
ReferenceGuides
  • Agent Studio
    • Overview
    • Quickstart Guides
    • Core Concepts
      • Assistants, Agents, & Plugins
      • Agentic Automation Engine
      • Conversational Plugins
        • Natural Language Triggers
        • Designing Conversation Processes
        • Steering Conversational Plugins
      • Ambient Agents
      • Data Types
      • Citations
      • Data Bank
      • Structured Data Analysis
    • Conversation Process
    • Actions
    • Connectors
    • System Triggers
    • Agent Architect
    • Cookbooks
    • Development and Testing
    • AI Agent Marketplace
    • Developer Tools
  • Agentic AI
    • LLM Fundamentals
    • The Agentic Reasoning Engine
    • Memory Constructs
    • Conversational Context
    • Guardrails
    • Grounding and Hallucinations
    • Continuous Learning
    • LLMs & SLMs
    • Steerability Tools
    • Multilingual Support
  • Core Platform
    • User Identity
    • Moveworks Agent (On-Prem)
    • Approvals Engine
    • Entity Catalog
    • Moveworks Data Objects
    • Security Information and Event Management (SIEM) Logs Overview
DeveloperAcademyCommunityStatus
On this page
  • Context is King
  • Conversational Plugin Architecture
  • Triggers
  • Conversation Processes
  • Example Use Cases
Agent StudioCore Concepts

Conversational Plugins

||View as Markdown|
Was this page helpful?
Edit this page
Previous

Natural Language Triggers

Next
Built with

Conversational plugins are tools that enable the Agentic Reasoning Engine to search for information, analyze data, and take action across enterprise systems.

Context is King

When you’re building conversational plugins, you should thoughtfully design the context for your agentic system.

Imagine you had a conversational plugin to help find calendar availability for two attendees:

  1. Tool 1: Obfuscated Context
    1{
    2 "users": {
    3 "bob@example.com": [
    4 {
    5 "title": "BUSY",
    6 "start": "2026-12-18T03:05:00Z",
    7 "end": "2026-12-18T03:35:00Z",
    8 "meta": "e_9f2a"
    9 },
    10 {
    11 "title": "BUSY",
    12 "start": "2026-12-18T16:00:00Z",
    13 "end": "2026-12-18T17:00:00Z",
    14 "meta": "e_1c77"
    15 }
    16 ],
    17 "janet@example.com": [
    18 {
    19 "title": "BUSY",
    20 "start": "2026-12-18T03:20:00Z",
    21 "end": "2026-12-18T04:00:00Z",
    22 "meta": "e_aa10"
    23 }
    24 ]
    25 }
    26}
    This tool forces your Assistant to…
    1. compute windows
    2. intersect across people
    3. count conflicts
    4. infer what’s conflicting (it can’t, really)
  2. Tool 2: Clear Context
    1{
    2 "time_range": {
    3 "start": "2026-12-18T00:00:00Z",
    4 "end": "2026-12-19T00:00:00Z"
    5 },
    6 "meeting_duration_minutes": 30,
    7 "windows": [
    8 {
    9 "start": "2026-12-18T03:00:00Z",
    10 "end": "2026-12-18T03:30:00Z",
    11 "conflict_count": 2,
    12 "conflicts": [
    13 {
    14 "email": "bob@example.com",
    15 "conflict": {
    16 "type": "calendar_event",
    17 "title": "Q4 Marketing All Hands Dry-Run",
    18 "start": "2026-12-18T03:05:00Z",
    19 "end": "2026-12-18T03:35:00Z"
    20 }
    21 },
    22 ...
    23 ]
    24 },
    25 ...
    26 ]
    27}
    This tool is much more “agent-friendly”
    1. The context is clear & easy to understand
    2. The work of calculating periods is already done for the AI agent

Creating tools that are well-designed for LLMs is your job as an agent engineer. When you make these design decisions, you impact…

  1. Functionality: What operations are possible?
  2. ML Performance: How accurately does the Reasoning Engine use your plugin?
  3. User Clarity: How easy is it for users to understand what happened?
  4. Latency: How fast does the plugin execute?
  5. Maintainability: How easy is it to modify or extend?

We discuss best practices for designing tools for agents here.

Conversational Plugin Architecture

Conversational plugins consist of two core components:

Triggers

Natural Language Triggers define how the plugin starts. They help the Reasoning Engine select your tool when users express certain intents.

Example: A plugin named “Check PTO Balance” with description “View remaining PTO days for employees” triggers on utterances like:

  • “How much PTO do I have left?”
  • “Check my vacation balance”
  • “Do I have enough time off for next month?”

Conversation Processes

Conversation Processes define the execution flow. This is great for designing standard operating procedures you want your users to follow.

They’re made up of a few pieces:


  1. Slots: Information collected from the user (dates, names, filters)
  2. Activities: Operations that the plugin executes
    1. Content Activities - display information to users (e.g. show a legal disclaimer with PTO balances)
    2. Action Activities - perform work (fetch, transform, or update data)
  3. Decision Policies - fork the interaction based on business rules (e.g. contractors get one experience, FTEs get another; event owners gets a different experience from event attendees, etc.)

Example Use Cases

Conversational plugins enable users to interact with enterprise systems through natural language.

Here are some real-world examples:

  • PTO Balance Checker: Employees ask “Do I have enough PTO for a week in November?” and instantly get their balance, remaining days, and availability confirmation.
  • Salesforce Account Management: Account executives update account owners, territories, or status through natural language like “Change the owner of Acme Corp to Sarah Johnson.”
  • Meeting Scheduler: Users find meeting times across attendees’ calendars and create meetings through “Schedule a team sync next week with John and Sarah.”
  • IT Access Request: Employees request access like “Give me access to the Marketing Slack channel”—the plugin checks permissions, gets approvals if needed, and grants access automatically.
  • Jira Ticket Creation: Users create tickets conversationally: “Create a ticket for the login bug in production”—the plugin collects priority, component, and description through natural dialogue.