The ID of the agent to run
OptionalAutoWhether to auto-populate payload from last run
OptionalConfigurationConfiguration ID to use
OptionalConversationOptional conversation detail ID (triggers artifact/notification creation)
OptionalConversationOptional conversation ID (for resuming a conversation)
OptionalCreateWhether to create artifacts from the agent's payload
OptionalCreateWhether to create a user notification on completion
OptionalDataOptional data context passed to the agent
OptionalLastOptional ID of the last agent run for continuity
User message(s) to send to the agent
OptionalOnOptional callback for progress updates
OptionalPayloadOptional payload passed to the agent
OptionalPlanWhether Plan Mode is requested for this run (requires the agent's SupportsPlanMode capability)
OptionalRequestedSkill IDs the user requested via /skill-name mentions. Server intersects these with the
agent's accepted skills AND the user's Run permission before any are activated.
OptionalSourceSource artifact ID for versioning
OptionalSourceSource artifact version ID for versioning
Parameters for running an agent via the SDK. This is a simplified interface wrapping the GraphQL mutation parameters. The SDK handles serialization and session ID injection internally.