- Give every subagent one clear responsibility and a non-overlapping routing description.
- Put stable facts in Knowledge; use tools or data connectors for live customer data.
- Grant the minimum knowledge, fields, tools, and channels each specialist needs.
- Make failure, escalation, and missing-data behavior explicit in procedures.
- Test with fictional personas and start a new session between unrelated scenarios.
- Validate before release and publish only the intended saved changes.
- Confirm behavior in Production after Set Live.
- Never store credentials in prompts, YAML, screenshots, or client code.
Sandbox and Production
Sandbox is editable and uses test sessions andcpk_test_… keys. Production is read-only and powers customer channels. Save updates the Sandbox draft; Set Live creates an immutable Production release.