> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For full documentation content, see https://docs.moveworks.com/llms-full.txt.

# Agent Studio Overview

<CardGroup cols={3}>
  <Card title="Quickstart" href="/agent-studio/quickstart-guide" icon="fa-rocket">
    Build your first plugin in minutes
  </Card>

  <Card title="Core Concepts" href="/agent-studio/core-concepts/assistants-agents-plugins" icon="fa-book">
    Detailed information about how Moveworks AI agents work in our platform
  </Card>

  <Card title="Cookbooks" href="/agent-studio/cookbooks" icon="fa-graduation-cap">
    Collection of best practices & recommendations for common types of use cases
  </Card>
</CardGroup>

# New to Agent Studio? Start Here

<Steps>
  <Step title="Build your first plugin">
    Follow [Quickstart #1: Basic Task Agent](/agent-studio/quickstart-guide/quickstart-basic-task-agent) to build a working plugin in minutes.
  </Step>

  <Step title="Understand the architecture">
    Read [Assistants, Agents, & Plugins](/agent-studio/core-concepts/assistants-agents-plugins) to understand how the pieces fit together.
  </Step>

  <Step title="Learn the Golden Rule">
    Read [The Golden Rule](/agent-studio/guides/best-practices/the-golden-rule) before building anything complex — it's the most important design pattern.
  </Step>

  <Step title="Build with the reference below">
    Use the Building Blocks Reference and Guides sections on this page to find specific docs as you build.
  </Step>

  <Step title="Test before you ship">
    Review [Testing & Error Handling](/agent-studio/guides/getting-started/testing-and-error-handling) before publishing your plugin.
  </Step>
</Steps>

# Agentic Frameworks

Agent Studio lets you connect AI assistants to your business systems & content. There are three **Agentic Frameworks** that you can build on.

<CardGroup cols={3}>
  <Card title="Content Gateway" href="/ai-assistant/enterprise-search/content-gateway" icon="fa-database" target="_blank">
    Index your content for semantic search experiences.
  </Card>

  <Card title="Conversational AI Agents" href="/agent-studio/core-concepts/conversational-plugins" icon="fa-comments">
    Execute real-time actions to create, modify, read, & remove data from business systems.
  </Card>

  <Card title="Ambient AI Agents" href="/agent-studio/core-concepts/ambient-agents" icon="fa-infinity">
    Set up Ambient AI agents that run in the background
  </Card>
</CardGroup>

These agentic frameworks are interoperable on the Moveworks platform, so you can build experiences that span multiple patterns.

# Guides & Best Practices

<CardGroup cols={3}>
  <Card title="The Golden Rule" href="/agent-studio/guides/best-practices/the-golden-rule" icon="fa-star">
    The single most important pattern for building reliable plugins
  </Card>

  <Card title="Decision Frameworks" href="/agent-studio/guides/getting-started/decision-frameworks" icon="fa-compass">
    When to use compound actions vs conversation processes, slot types, and more
  </Card>

  <Card title="Slot Best Practices" href="/agent-studio/guides/best-practices/slot-best-practices" icon="fa-puzzle-piece">
    Anti-patterns and best practices for slot design
  </Card>

  <Card title="Conversation Process Best Practices" href="/agent-studio/guides/best-practices/conversation-process-best-practices" icon="fa-comments">
    Anti-patterns and best practices for conversation processes
  </Card>

  <Card title="LLM Action Best Practices" href="/agent-studio/guides/best-practices/llm-action-best-practices" icon="fa-brain">
    When NOT to use LLM actions and the decision matrix
  </Card>
</CardGroup>

# Building Blocks Reference

Quick links to every Agent Studio building block.

## Common tasks

Starting from an outcome and not sure which primitive to use? Start here.

| I want to…                                | Use                                                                                                                       |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Call an API                               | [HTTP Action](/agent-studio/actions/http-actions)                                                                         |
| Orchestrate multiple actions              | [Compound Action](/agent-studio/actions/compound-actions)                                                                 |
| Call an LLM inline                        | [generate\_text\_action / generate\_structured\_value\_action](/agent-studio/actions/llm-actions)                         |
| Send a message to a user                  | [`notify`](/agent-studio/actions/compound-actions/notify) expression                                                      |
| Branch on a condition                     | [`switch`](/agent-studio/actions/compound-actions/switch) expression                                                      |
| Handle an API failure                     | [`try_catch` / `raise`](/agent-studio/actions/compound-actions/try-catch-and-raise-error)                                 |
| Loop over a list                          | [`for`](/agent-studio/actions/compound-actions/for) expression                                                            |
| Run actions concurrently                  | [`parallel`](/agent-studio/actions/compound-actions/parallel) expression                                                  |
| End a compound action and return data     | [`return`](/agent-studio/actions/compound-actions/return) expression                                                      |
| Look up a user by email                   | [`get_user_by_email`](/agent-studio/actions/built-in-actions#get_user_by_email)                                           |
| Look up many users at once                | [`batch_get_users_by_email`](/agent-studio/actions/built-in-actions#batch_get_users_by_email)                             |
| Request human approval                    | [`create_generic_approval_request`](/agent-studio/actions/built-in-actions#create_generic_approval_request)               |
| Send batch chat notifications             | [`batch_send_plaintext_chat_notification`](/agent-studio/actions/built-in-actions#batch_send_plaintext_chat_notification) |
| Collect user input                        | [Slots](/agent-studio/conversation-process/slots)                                                                         |
| Validate a slot value                     | [Validation policy](/agent-studio/guides/best-practices/slot-best-practices#missing-validation-policy) with DSL           |
| Branch a conversation on an action result | [Decision Policy](/agent-studio/conversation-process/control-flow#pattern-action--decision-policy--branch)                |
| Display a knowledge article or form       | [Content Activity](/agent-studio/conversation-process/activities/content-activities)                                      |
| Handle large API responses (>7K tokens)   | [Response Sizes / SDA](/agent-studio/conversation-process/activities/response-sizes)                                      |

## Actions

<CardGroup cols={3}>
  <Card title="HTTP Actions" href="/agent-studio/actions/http-actions" icon="fa-globe">
    REST API calls to external systems
  </Card>

  <Card title="Compound Actions" href="/agent-studio/actions/compound-actions" icon="fa-diagram-project">
    Orchestrate multi-step workflows
  </Card>

  <Card title="LLM Actions" href="/agent-studio/actions/llm-actions" icon="fa-brain">
    generate\_text and generate\_structured\_value
  </Card>
</CardGroup>

## Compound Action Expressions

<CardGroup cols={3}>
  <Card title="action" href="/agent-studio/actions/compound-actions/action" icon="fa-play">
    Invoke an HTTP, script, or compound action
  </Card>

  <Card title="for" href="/agent-studio/actions/compound-actions/for" icon="fa-repeat">
    Loop over arrays sequentially
  </Card>

  <Card title="switch" href="/agent-studio/actions/compound-actions/switch" icon="fa-code-branch">
    Conditional branching
  </Card>

  <Card title="parallel" href="/agent-studio/actions/compound-actions/parallel" icon="fa-arrows-split-up-and-left">
    Run expressions concurrently
  </Card>

  <Card title="return" href="/agent-studio/actions/compound-actions/return" icon="fa-right-from-bracket">
    End execution and return data
  </Card>

  <Card title="try / catch / raise" href="/agent-studio/actions/compound-actions/try-catch-and-raise-error" icon="fa-shield-halved">
    Error handling
  </Card>

  <Card title="notify" href="/agent-studio/actions/compound-actions/notify" icon="fa-bell">
    Send messages with action buttons
  </Card>
</CardGroup>

## Conversation Process

<CardGroup cols={3}>
  <Card title="Slots" href="/agent-studio/conversation-process/slots" icon="fa-puzzle-piece">
    Collect input values from users
  </Card>

  <Card title="Resolver Strategies" href="/agent-studio/conversation-process/resolver-strategies" icon="fa-bullseye">
    Convert natural language to data types
  </Card>

  <Card title="Activities" href="/agent-studio/conversation-process/activities" icon="fa-list-check">
    Action and content blocks
  </Card>

  <Card title="Control Flow" href="/agent-studio/conversation-process/control-flow" icon="fa-route">
    Decision policies, exit, and continue
  </Card>
</CardGroup>

## Data & Configuration

<CardGroup cols={3}>
  <Card title="Data Bank" href="/agent-studio/core-concepts/data-bank" icon="fa-database">
    Reference patterns: data.*, meta\_info.*, response, value
  </Card>

  <Card title="DSL Reference" href="/agent-studio/configuration-languages/dsl" icon="fa-code">
    Validation rules, conditions, string functions
  </Card>

  <Card title="Data Mappers" href="/agent-studio/configuration-languages/mapper" icon="fa-right-left">
    MAP(), MERGE(), FILTER(), RENDER(), LOOKUP()
  </Card>

  <Card title="Data Types" href="/agent-studio/core-concepts/data-types" icon="fa-shapes">
    Built-in and custom data types
  </Card>
</CardGroup>

## Triggers

<CardGroup cols={2}>
  <Card title="Natural Language Triggers" href="/agent-studio/core-concepts/conversational-plugins/natural-language-triggers" icon="fa-comments">
    Conversational plugin activation
  </Card>

  <Card title="System Triggers" href="/agent-studio/system-triggers" icon="fa-bolt">
    Webhooks and scheduled triggers
  </Card>
</CardGroup>

# Samples

You can view hundreds of AI agents on our [AI Agent Marketplace](https://aka.mw/marketplace) and import example templates to better understand how they are built.

![](https://files.readme.io/8c69e09ceaf6dea2c55ef9838b172d79b3466c525d9cd9bc0e3ac8176ad97104-CleanShot_2025-06-30_at_17.49.09.gif)

# Ready to get started?

Dive into our [Quickstart Guides](/agent-studio/quickstart-guide) to start building your first plugins