# Customizing Digital Workers: Instructions, Skills, Tools, and Triggers

Digital worker templates from the Marketplace are a strong starting point, but most organizations need to customize them to match their specific processes, terminology, and systems. Agentic Studio provides several layers of customization, from simple instruction changes to adding new capabilities and integrations.&#x20;

Templates are typically around 60% applicable out of the box. The customization layer is where you close the remaining gap.&#x20;

### **Changing Instructions**&#x20;

Instructions are the core policy of a digital worker. They define what the worker does, how it reasons, what format it returns, and how it handles edge cases. Because instructions live in the prompt, even small wording changes can reliably shift the worker's downstream behavior without requiring any changes to skills or tools.&#x20;

For example, if a digital worker currently produces a free-form summary, you can update its instructions to require a structured JSON output with specific required fields, null-handling rules, and targeted follow-up questions for missing data. The same inbound event will now produce a machine-readable result instead of a narrative response.&#x20;

{% hint style="info" %}
&#x20;*<mark style="color:$primary;">Start with instruction changes before adding new skills or tools. Often, adjusting how the worker reasons or formats its output is all that is needed.</mark>*&#x20;
{% endhint %}

### **Adding Skills**&#x20;

Skills are modular capabilities that a digital worker invokes when it detects the right intent. Rather than embedding every behavior in the instructions, you can keep instructions lean and extend the worker's capabilities through targeted skills.&#x20;

When defining a skill, the most important configuration is the invocation parameters, specifically the prompts or intent patterns that should activate the skill. Well-defined invocation criteria ensure the skill is called reliably when needed, and not called when it should not be.&#x20;

#### Example skills and their typical triggers:&#x20;

* Get Work Order Details: triggers on requests such as "what is the status of WO-12345?"&#x20;
* Search Knowledge Base: triggers on questions such as "how do I reset the controller?"&#x20;
* Create Dispatch Recommendation: triggers on requests such as "who should we send?"&#x20;

If the worker cannot find the required information to call a skill, it should ask targeted follow-up questions rather than proceeding with incomplete data. &#x20;

### **Adding Tools**&#x20;

Tools give a digital worker real execution power, meaning the ability to take actions beyond reasoning and text generation. In Agentic Studio, tools can come from three sources:&#x20;

* Connector tools: API operations imported from a connected system such as IFS, ServiceNow, or a third-party application.&#x20;
* Out-of-the-box tools: pre-built capabilities provided by IFS Loops.&#x20;
* Custom tools: tools you build to match specific organizational processes.&#x20;

Depending on the connector, tools may be exposed as traditional APIs or as MCP-based capabilities, allowing the digital worker to reliably discover and invoke the right function at the right time.&#x20;

### **Adding Triggers**&#x20;

Triggers start a digital worker automatically in response to an external event from a connected system. The event payload carries key context, including IDs, timestamps, and changed fields, which the worker uses to determine its next step.&#x20;

#### Example triggers:&#x20;

* Service Work Order Created (IFS): sends the work order ID and key fields. The digital worker auto-classifies priority, flags missing information, and recommends next steps.&#x20;
* Incident Status Changed (ServiceNow): on escalation, sends incident context. The digital worker summarizes impact, retrieves relevant knowledge base articles, and drafts the escalation update. &#x20;

### **Configuring Human-in-the-Loop (HITL)**&#x20;

* HITL adds an approval or decision step to a digital worker's configuration so that sensitive, ambiguous, or high-impact actions are reviewed by a person before the execution continues.&#x20;
* HITL can be routed to Microsoft Teams, Slack, or other collaboration channels. Configuration adapts to the chosen channel. In Slack, for example, you select the target workspace and channel where requests should be posted.&#x20;
* HITL can also be made conditional, triggering only when specific rules are met, such as low confidence, missing required fields, an exception condition, or a high-value transaction, while keeping the rest of the process fully automated. This allows different humans or teams to handle different decision points within the same configuration.&#x20;

### **Structured Output**&#x20;

Structured output ensures a digital worker returns results in a predictable schema, for example a named JSON object, so that downstream systems, dashboards, or integrations can reliably parse and use the response.&#x20;

To configure structured output, define an explicit output contract that maps each required field to its source in the conversation or tool results. Specify required versus optional fields, allowed values, and what to do when data is missing (for example, set the field to null and ask a targeted follow-up question). Adding this contract to the digital worker's instructions makes outputs consistent and integration-ready.&#x20;

### **Concurrency**&#x20;

Concurrency controls how many parallel tasks a digital worker can run simultaneously. This matters particularly for high-volume scenarios where instructions like "for each entity, do this" can trigger a fan-out into many parallel executions.&#x20;

Unbounded fan-out can significantly increase token usage and drive spikes in system resource consumption. Setting a concurrency limit caps parallel fan-outs, paces execution, and keeps the process predictable while still benefiting from parallelism where it matters.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.theloops.io/agenticstudio/resource-library/explainers/customizing-digital-workers-instructions-skills-tools-and-triggers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
