Create a sub-agent

task brazil Updated Sep 27, 2026 1 min read create-sub-agent.md

Create a custom sub-agent to hand off a specialized task, such as code review or security analysis, to a reusable agent with focused instructions and limited access. A narrow scope helps produce consistent results, limiting the sub-agent to only the skills and MCP servers it requires.

Before you begin

Role required: sn_app_arc.user

Procedure

Navigate to Settings > Sub-Agents.
Select the add icon.

The New Sub-Agent dialog opens.

Enter the sub-agent details.

Field	Description
Name (slug format)	Unique name in lowercase letters and hyphens only, used to reference the sub-agent in `spawn_subagent`.
Description	A short summary of what the sub-agent does.
Skills (optional)	The skills the sub-agent can use.
MCP Servers (optional)	The MCP servers the sub-agent can use.
System Prompt (Markdown)	Instructions that define the sub-agent's role and guidelines.

Select Create.
Select the refresh icon to reload the list after you add or change a sub-agent.
Select the folder icon to open the folder where sub-agents are stored.

Result

The new sub-agent appears in the Sub-Agents list.

Parent Topic:Extend ServiceNow Arc

Keywords sub-agentscustom sub-agentsystem prompt

53 lines · 2.1 KB Wrap lines

---
title: Create a sub-agent
description: Create a custom sub-agent to hand off a specialized task, such as code review or security analysis, to a reusable agent with focused instructions and limited access. A narrow scope helps produce consistent results, limiting the sub-agent to only the skills and MCP servers it requires.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/application-development/create-sub-agent.html
release: brazil
topic_type: task
last_updated: "2026-09-27"
reading_time_minutes: 1
keywords: [sub-agents, custom sub-agent, system prompt]
breadcrumb: [Extend ServiceNow Arc, Use, ServiceNow Arc, Extend, AI Workflow Factory Prime, Agentic app development, Building applications]
---

# Create a sub-agent

Create a custom sub-agent to hand off a specialized task, such as code review or security analysis, to a reusable agent with focused instructions and limited access. A narrow scope helps produce consistent results, limiting the sub-agent to only the skills and MCP servers it requires.

## Before you begin

Role required: sn\_app\_arc.user

## Procedure

1.  Navigate to **Settings** &gt; **Sub-Agents**.

2.  Select the add icon.

    The **New Sub-Agent** dialog opens.

3.  Enter the sub-agent details.

    |Field|Description|
    |-----|-----------|
    |**Name \(slug format\)**|Unique name in lowercase letters and hyphens only, used to reference the sub-agent in `spawn_subagent`.|
    |**Description**|A short summary of what the sub-agent does.|
    |**Skills \(optional\)**|The skills the sub-agent can use.|
    |**MCP Servers \(optional\)**|The MCP servers the sub-agent can use.|
    |**System Prompt \(Markdown\)**|Instructions that define the sub-agent's role and guidelines.|

4.  Select **Create**.

5.  Select the refresh icon to reload the list after you add or change a sub-agent.

6.  Select the folder icon to open the folder where sub-agents are stored.


## Result

The new sub-agent appears in the **Sub-Agents** list.

**Parent Topic:**[Extend ServiceNow Arc](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/extending-cowork.md)