Class AgentTaskDefinition

Describes a saved unit of agent work that can run manually or on a schedule.

public class AgentTaskDefinition

Properties

AgentId: Gets or sets the agent identifier that executes the task.
CreatedAt: Gets or sets when the task definition was created.
CreatedByAgentId: Gets or sets the agent that created this task through a tool call, or null when user-created.
ExternalTrigger: Gets or sets the optional externally callable webhook trigger settings.
Id: Gets or sets the stable task identifier.
Instruction: Gets or sets the instruction submitted when the task executes.
IsEnabled: Gets or sets whether the scheduler may run this task.
MaxTokenBudget: Gets or sets an optional token budget for the task run.
ModelOverrideId: Gets or sets an optional model override used for this task run.
Name: Gets or sets the user-facing task name.
NotificationChannel: Gets or sets the channel identifier used for task notifications or handoffs.
NotificationMode: Gets or sets when completion notifications are sent.
RunScope: Gets or sets optional task-local runtime settings for the selected agent.
Schedule: Gets or sets the schedule that determines automatic task execution.
SessionMode: Gets or sets whether task runs use an isolated or persistent session.
ToolApprovalRunMode: Gets or sets how approval-required tools are handled during unattended execution.
UserId: Gets or sets the user that owns the task.

GetContentFingerprint(): Serializes the definition for optimistic concurrency and stale-admission checks.
HasSameContentAs(AgentTaskDefinition): Returns whether another snapshot has the same serializable task definition.