> For the complete documentation index, see [llms.txt](https://kb.theloops.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.theloops.io/agentstudio/resource-library/explainers/the-metaprompter-customizing-with-plain-language.md).

# The MetaPrompter: Customizing with Plain Language

MetaPrompter is the conversational interface inside Agent Studio for building and changing Digital Workers and Skills. Instead of configuring a Digital Worker or Skill through forms and settings screens, you describe what you want in plain language. MetaPrompter turns that description into a reviewable plan covering new tools, updated instructions, and new outputs, and you approve the plan.

This guide walks through what MetaPrompter can do. Topics include creating a Digital Worker or Skill, with or without a HAR file (a recording of a real system interaction), configuring state-based outputs, adding human-in-the-loop approval, and updating a Digital Worker that is already live, including its instructions, its tools, or both.

#### Best Practices

* **Start with the outcome you want.** A short, specific sentence works better than a vague one, for example “Create a Digital Worker that converts a business opportunity into a customer order” rather than “automate my sales process.”
* **Attach a HAR file when one is available.** It produces a more accurate tool than a written description of the same API, but it is optional, a clear description on its own is often enough.
* **Use follow-up messages to refine the request.** MetaPrompter retains the current plan as you add detail.
* **Test a tool before approving the plan.** The Test button on a tool step lets you confirm it behaves as expected before it becomes part of the Digital Worker or Skill.
* **Read the full plan before approving it.** Every request, whether a new build or a small change, becomes a Plan of Execution first, and nothing is applied until it is reviewed and approved.
* **Build a Skill when the need is one reusable capability**, and a Digital Worker when the need is an end-to-end process.
* **Mark an output Needs User Approval wherever a user should have the final say**, such as a high-value transaction or an exception case, and leave it unchecked wherever the process should proceed without review.

## **Creating a Digital Worker or Skill**

Digital Workers and Skills are both created the same way, from the same “Describe what it should do” starting point. A Digital Worker handles an end-to-end job, and a Skill is one reusable capability that can be called on its own or bundled into a Digital Worker.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FOpDSA15fp9tYjHtIBIsZ%2Fimage.png?alt=media&amp;token=b9c39d02-9f4c-4c47-9d33-e78a8c92d80a" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Creating a Digital Worker from the Digital Workers list: describe what the Digital Worker should do, then name it in the Add New Digital Worker dialog. Creating a Skill follows the same pattern.</em></p>

Either way, the new Digital Worker or Skill opens directly into its Compose tab, where MetaPrompter is the primary way to build it out. The empty state outlines the process: describe what you want to change, MetaPrompter turns that into a Plan of Execution, and you review and approve the plan.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2F9yIK3suK4B9297voaClt%2Fimage.png?alt=media&amp;token=bf39904d-2161-49ef-972a-c89dadb8b531" alt=""><figcaption></figcaption></figure>

<p align="center"><em>The MetaPrompter starting screen: guidance on how to get the best results, plus example prompts to start from.</em></p>

### **Creating with a HAR File**

Attach a HAR file, a recording of an existing system interaction, using the paperclip icon when the work involves calling a system through its web interface. The captured calls are indexed directly, so the API does not need to be described or coded by hand. When a HAR file is sent alongside a description, the request is worked through visibly: current configuration is read, the HAR file's workflow and API calls are indexed, and the tools the request requires are created.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2F8JBzv1mfMo5nchPCgZpT%2Fimage.png?alt=media&amp;token=e1331e5c-4e6d-49ca-936d-568824e8cfee" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Building from a HAR file: current instructions are read, the attached HAR file's API calls are indexed, and the tools needed for the workflow are created.</em></p>

When MetaPrompter cannot reliably determine a detail on its own, it pauses and asks, usually with a recommended option highlighted, before continuing:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2F5V7PsrGkolTqkDOHCjYL%2Fimage.png?alt=media&amp;token=9cdabad8-bff0-40aa-9138-f5974e80d9f8" alt=""><figcaption></figcaption></figure>

<p align="center"><em>A clarifying question during a HAR-based build: which business input a generated tool should require, with a recommended option highlighted.</em></p>

Next, MetaPrompter presents a Plan of Execution, a numbered list of the proposed changes, each labeled by type, with a Test button on any tool step and a “more” link for full detail. The changes are applied when Approve & Execute is selected.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2Fp5S4j2gRw2CH3yEbr8aV%2Fimage.png?alt=media&amp;token=cd8cacfe-352d-485b-860c-2a5a70a88c12" alt=""><figcaption></figcaption></figure>

<p align="center"><em>A Plan of Execution built from a HAR file: three tools, a system tool, two instruction updates, and two new states, all reviewable and testable before approval.</em></p>

After approval, each change is confirmed as it is executed, and a summary of what the Digital Worker can now do is provided.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FTabtZaPrr1IM4n9KpTPX%2Fimage.png?alt=media&amp;token=00a7a0f1-4fdb-4d62-a977-8da2fcd8d084" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Confirmation after approval: the plan is marked Approved, changes are executed, and MetaPrompter summarizes the tools, outputs, and instructions now in place.</em></p>

### Creating a Digital Worker Without a HAR File: By Prompt Alone

A HAR file is never required. Describing what a Digital Worker should do in a single sentence is enough for MetaPrompter to find the right tools and set up the full workflow, as shown here by creating OrderAnalyzer, a Digital Worker that identifies risky purchase orders (POs), with no file attached at all.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FX3b7aiit99gD4fMLJT2O%2Fimage.png?alt=media&amp;token=c3486104-c3ae-4599-80f5-8435cf396a0f" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Starting from a description only: naming the new Digital Worker, OrderAnalyzer, from the Digital Workers list. No HAR file is involved at any point in this build.</em></p>

After the goal is entered (“Your goal is to get Released POs and identify risky POs”), MetaPrompter works through the request on its own, searching for and creating the tool to fetch released purchase orders and indexing the fields it needs. When a business detail cannot be reliably determined, it pauses and asks, with a recommended option highlighted:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FheIBoZh4yslh5wgmSCVk%2Fimage.png?alt=media&amp;token=b5941baa-ae74-4489-9bac-a9af82038e96" alt=""><figcaption></figcaption></figure>

<p align="center"><em>A clarifying question during a prompt-only build: which amount the new tool should treat as a PO's Total Amount, with “Gross including charges (Recommended)” highlighted as the suggested answer.</em></p>

After every open question is answered, the same kind of Plan of Execution seen in a HAR-based build is presented: an Add Tool step, an Add System Tool step for the risk-analysis logic, and an Update Instructions step tying the workflow together, all ready to test, review, and approve.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2Fj0f05XUcLyhtj5JXrT72%2Fimage.png?alt=media&amp;token=fbbc6c09-3c29-4cbd-a512-d4f330f6dae0" alt=""><figcaption></figcaption></figure>

<p align="center"><em>The completed Plan of Execution for OrderAnalyzer, built entirely from a plain-language description: a new tool, a system tool, and updated instructions, each testable before Approve &#x26; Execute.</em></p>

### Creating a Skill Without a HAR File

Skills are created the same way, from the same “describe what it should do” starting point, for example “Find out the open purchase orders, flag the Risky POs and analyze and recommend the next steps for them,” with no file attached.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FyMbhkm1aybpQp0yUE5ey%2Fimage.png?alt=media&amp;token=32c4c2c4-a3d9-497d-91d2-d98213c80f39" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Creating a Skill: the same “describe what it should do” starting point as a Digital Worker, with example prompts and a list of existing Skills already in the workspace.</em></p>

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2F1NQpuYlcat1BzPbSIbo0%2Fimage.png?alt=media&amp;token=ccda4ce8-bf49-4861-9907-d81b24b5207d" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Building from a prompt alone, with no HAR file attached: the current configuration is read and the tool the request requires is searched for.</em></p>

The same clarifying-question and Plan of Execution pattern applies, regardless of whether a HAR file was attached:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2Fln0BShtCDYGhqzPmpthY%2Fimage.png?alt=media&amp;token=79fef99f-7b36-45df-869e-3fb20836acca" alt=""><figcaption></figcaption></figure>

<p align="center"><em>A clarifying question while building from a prompt alone, here about which date field a filter should use, with a recommended option highlighted.</em></p>

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FS0c9tQ8BNmq3q7DWT7bF%2Fimage.png?alt=media&amp;token=6eea989b-561d-4c79-ba6d-4bb0954d4585" alt=""><figcaption></figcaption></figure>

<p align="center"><em>A Plan of Execution built without a HAR file: two system tools and an instructions update, alongside the retrieval tool, ready for Approve &#x26; Execute or Decline.</em></p>

Then MetaPrompter confirms what was added and how the result behaves, and it can proactively suggest sensible next refinements, such as a human-in-the-loop approval step or a structured output.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FgQM5u5cdFutcPu1bJIEV%2Fimage.png?alt=media&amp;token=b03a5cdd-32ed-41f1-b50b-83547b548e4a" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Confirmation after approval: what was added, how the Skill works now, and a prompt for further refinements, such as approvals, notifications, or a structured output.</em></p>

The finished Skill is a standalone object. It is visible in its Graph view alongside the systems and tools it connects to, and it is available to reuse in any Digital Worker that needs it.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FHkKjQrPX0DQDwUwnxazV%2Fimage.png?alt=media&amp;token=490cfc0f-3780-44d3-a179-a99efb8c84e8" alt=""><figcaption></figcaption></figure>

<p align="center"><em>The finished Skill in Graph view, shown alongside the IFS connections and the tool MetaPrompter built for it.</em></p>

## State-Based Outputs

A state-based output is a defined, structured shape of data that a Digital Worker or Skill produces at a given point in its process, such as a workflow error or a completed analysis ready for review. States can be added directly from the conversation: describe the situation that needs its own output, and an Add State step is proposed alongside whatever instruction changes are needed to use it.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FQd4Ez3EGF3mBfsVFYL8E%2Fimage.png?alt=media&amp;token=9c5d6ea4-bf06-40ae-a92f-4ac3da81dd21" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Adding a new state from a plain-language request (“show the error in a formatted user-friendly message”): an Add State step plus the instruction updates needed to route to it, all in a single Plan of Execution.</em></p>

Every state that is added is also visible and editable afterward in the Digital Worker's own Intent Based Output Format settings, including its name, its description, and whether it needs user approval before the workflow continues past it:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FiVjYg9IQO3yve9BdEalL%2Fimage.png?alt=media&amp;token=f415b6b2-df0b-4f0b-b707-06be256ee8b2" alt=""><figcaption></figcaption></figure>

<p align="center"><em>The Intent Based Output Format list for OrderAnalyzer: the Error and Risky POs Review states MetaPrompter built, each with its description and Needs User Approval setting.</em></p>

## Human-in-the-Loop Approval

Beyond the Needs User Approval setting on a single output, MetaPrompter can configure a full human-in-the-loop notification for a Digital Worker directly from the conversation. Describe when a reviewer should be looped in, for example “when you identify the Risky POs, show the analysis in a structured actionable format for the user, via Teams.” MetaPrompter then proposes a dedicated human-in-the-loop configuration step, with its own settings card for how reviewers should be notified:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FIoQNlt3FLRwnVZhCCPP9%2Fimage.png?alt=media&amp;token=51804f7f-b710-4fe4-8907-bb2f3951d527" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Configuring a human-in-the-loop notification from the conversation: choosing Teams as the notification channel, then the specific Teams channel the reviewer should be notified on.</em></p>

The human-in-the-loop configuration step appears in the Plan of Execution as its own step type, shown alongside any instruction changes needed to use it, so it is clear at a glance that a human-in-the-loop checkpoint is being added:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2Fj9zNmFp04nE4cKQ98dzT%2Fimage.png?alt=media&amp;token=0717f2e0-0bc6-4095-bf51-6fd016f0d339" alt=""><figcaption></figcaption></figure>

<p align="center"><em>A Plan of Execution with a dedicated human-in-the-loop configuration step, alongside an Update Instructions step connecting the new Teams notification to the workflow.</em></p>

When a run reaches that point in the process, it pauses and surfaces a structured, actionable summary for the reviewer and waits for a decision before the workflow concludes:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2Frk8yA97Xo9ycK2Hqr0P4%2Fimage.png?alt=media&amp;token=d2069be6-ac8e-4630-bdf4-412499b549de" alt=""><figcaption></figcaption></figure>

<p align="center"><em>The resulting human-in-the-loop checkpoint in practice: OrderAnalyzer pauses with a structured risky purchase order analysis marked Action Required, including a summary and table ready for a reviewer's decision on each flagged purchase order.</em></p>

## Updating an Existing Digital Worker: Instructions, Tools, and More

The same conversation-to-plan-to-approval flow used to build a Digital Worker from scratch is how you evolve one that is already live. For example, a request such as “update the Digital Worker to support an additional supplier” produces a plan using the same step types seen throughout this guide, so the kind of change each step makes is clear:

* **Add Tool:** gives the Digital Worker a new capability it can call, built from a description or a HAR file.
* **Add System Tool:** adds an internal tool, such as an instruction handler, that supports the Digital Worker's own logic rather than an external system.
* **Update Instructions:** changes what the Digital Worker does, step by step. Expanding “more” on this step shows the instruction text before it is approved, so the change can be verified before it is applied.
* **Add State:** introduces a new state-based output, as covered in the previous section.

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2Fdo4iXhbJRVOpp4riDULM%2Fimage.png?alt=media&amp;token=bf904e40-b9f5-45f2-b9dd-bf6ac9510776" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Expanding a plan step's “more” detail on an Update Instructions change: the drafted workflow instructions, including how a tool's output is mapped and used.</em></p>

A HAR file can be attached to this same conversation to add a tool to a Digital Worker that is already live, as it can when creating one from scratch. Here, a HAR recording of adding a note to a purchase order, AddNotesToOrder.har, is attached to OrderAnalyzer alongside a plain-language instruction for when the new tool should be used:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FXR2liRB854jTZ6wBuTtI%2Fimage.png?alt=media&amp;token=c974b3b0-f75b-4c6d-911b-802fe1fa8d3b" alt=""><figcaption></figcaption></figure>

<p align="center"><em>Adding a tool to an existing, already-live Digital Worker by attaching a HAR file: AddNotesToOrder.har, together with an instruction for when the resulting tool should write reviewer decisions back to a purchase order.</em></p>

As with any other change, the result is a reviewable Plan of Execution: the new tool alongside the instruction updates needed to call it at the right point in the workflow:

<figure><img src="https://3180153102-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRIbp8Kp04VLXld01gmAs%2Fuploads%2FBsIEiXdhLOaEM3aJILbB%2Fimage.png?alt=media&amp;token=b8587576-69ea-48b6-8c99-af84e9644506" alt=""><figcaption></figcaption></figure>

<p align="center"><em>The Plan of Execution for a HAR-based tool added to a live Digital Worker: an Add Tool step built from the attached HAR file, plus two Update Instructions steps connecting it to the existing workflow.</em></p>

Because every change, on a new Digital Worker or one already in production, goes through the same Plan of Execution and Approve & Execute step, each change can be reviewed first. Each proposed change can be tested, expanded for detail, and approved or declined individually.
