| name | create-subagent |
| description | Create or update custom Datus subagents by editing the loaded agent.yml. Use when a workflow needs persistent agentic_nodes scoped to already-built tables, metrics, or reference SQL. |
| requires_mutable_config | true |
Create Subagent
Create or update custom subagents in the active Datus configuration. Change only agent.agentic_nodes; do not create Knowledge Base content or copy prompt templates.
This skill is available only when the runtime marks the loaded configuration as mutable. If it cannot be discovered or loaded, do not attempt the same write by another path.
Input contract
Collect one or more node specifications before editing:
name
node_class
agent_description
tools
scoped_context.datasource
scoped_context.tables
scoped_context.metrics
scoped_context.sqls
- Require a lowercase identifier that starts with a letter and contains only letters, digits, and underscores.
- Allow
node_class values supported by the runtime. Use gen_sql for a query agent and gen_report for an attribution/report agent.
- Store
tools and each populated Knowledge Base scope as comma-separated strings, matching the SubAgentConfig contract.
- Require at least one of
tables, metrics, or sqls. Keep datasource equal to the active datasource that owns those artifacts.
- Put fully qualified physical table references in
tables.
- Put canonical dotted subject references in and . For one exact item, join its stored and item as . A bare subject path intentionally selects its whole subtree and must not be used when the caller requested exact items.
