create_ai_agent
Create ServiceNow AI agent definitions with specified capabilities and optional auto-generated execute ACLs to control who can invoke the agent.
Instructions
Create an AI agent definition with optional auto-generated ACLs (requires NOW_ASSIST_ENABLED + WRITE_ENABLED)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"description": "<description>",
"capabilities": "<capabilities>"
},
"name": "create_ai_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Agent name | |
| role | No | Agent role/purpose, e.g. "Service desk triage specialist" (default: the description) | |
| description | Yes | Agent description | |
| capabilities | Yes | Tools to attach: AI Agent tool (sn_aia_tool) names or sys_ids. Unknown entries are reported, not created | |
| instructions | No | Agent instructions for its first version (default: the description) | |
| auto_generate_acls | No | Create the execute ACL (type gen_ai_agent) that controls who can invoke the agent (default true) |