create_sc_agent_task
Create a scheduled task for an agent to run against a repository. Configure classifier or SIS agent tasks with type-specific parameters and a cron schedule.
Instructions
Create a task for an agent.
A task runs against a specific repo on a schedule.
Configuration depends on agent type (check with
get_sc_agent first).
CLASSIFIER agent configuration:
classification_type: must be 5
sample_strategy: "ROWS" or "PERCENT"
collection_name: classifier collection name Do NOT include SIS fields (service_name, audit_file_path, etc.) for classifier agents.
SIS (audit) agent configuration varies by DB:
Oracle: optional 'initial_audit_timestamp', 'service_name'
MSSQL: 'audit_file_path' (required, absolute path)
PostgreSQL: 'audit_file_path', 'audit_file_type' (log/csv/json), optional 'log_line_prefix'
MySQL: either 'table_name' or 'audit_file_path' Do NOT include classifier fields for SIS agents.
Schedule: 'type' ("CRON"), 'value' (cron expression), optional 'max_duration' (ISO 8601), optional 'timezone' (e.g. "America/New_York").
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | Agent UUID. | |
| name | Yes | Task name. | |
| repo_name | Yes | Target repository name. | |
| configuration | Yes | Agent-type-specific config dict or JSON string. See above for required fields. | |
| schedule | Yes | Schedule dict or JSON string. | |
| description | No | Optional task description. | |
| service_user | No | Service user for auth. Required for Oracle, MSSQL, MySQL (table_name mode). Forbidden for PostgreSQL and MySQL (audit_file_path mode). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||