Skip to main content
Tool: create_single_prompt_agent. Requires Editor, Admin, or Owner in the applicable workspace and a connected OAuth session. Supply a nonempty name and system prompt, plus an optional greeting. Creates a draft-lifecycle agent with a stored version 1 published snapshot; these two states are different. Post-call QA starts enabled and can be adjusted in the console. Inspect created and error_code in the result. Creation does not place calls or activate external traffic. Test and publish from the console when ready. Repeating successful creation creates another agent.

Arguments

Example arguments

Replace sample resource IDs with IDs returned in your selected workspace.

Result and errors

The schema below describes MCP structuredContent, including the result wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See troubleshooting. Effect: Changes state. Retry: Do not blindly repeat successful calls. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.