Job (Agent) Management
Overview
A job is a definition that bundles the work steps you want the AI to execute. Once the steps are set up, the job runs automatically — you simply give the instruction from chat.
Open the job management screen from the gear icon in the header → "Jobs & Automation". Use the tabs at the top of the screen to switch between "Jobs", "Job Categories", and "Schedules".
Note: The "Automation" menu is shown to organization administrators. It is also unavailable when the agent chat feature is disabled for the organization (or you are outside the allowed groups).
Job List
- Filter by category on the left ("All", "Favorites", and each category, each with a count)
- Adjust the view with Sort (Name / Recently updated / Recently created) and Filter (Active only / Public only / Worker running only / Created by me) at the top right
Each card shows the following information.
- Icon, job name, and description (an "Inactive" or "Worker Stopped" badge may appear)
- Step count ("N steps"), creator, and last updated
- "Public" badge (shared jobs)
- Favorite star (favorited jobs appear at the top of the job selector when starting a new chat)
System jobs and jobs owned by other users cannot be edited (a lock is shown on the card). Administrators can change the display order of the list with "Reorder jobs".
Creating a Job
- Click "Create New" at the top right of the list
- Choose a creation method:
- "Let AI propose the best plan" (recommended): describe what you want to do, and AI proposes the best steps
- "Configure execution steps manually": select commands manually to build the steps
- Follow the wizard to fill in Overview → Goal (or Workflow) → Input Form → Environment Variables → Visibility
- In AI proposal mode, run "Let AI suggest steps" and review the proposed steps (unchecked steps are skipped)
- When you enter a job name, AI auto-fills initial values such as the category, description, icon, and color
Editing a Job
Open a job from its card in the list, then use the menu on the left to switch between the following sections.
| Section | Description |
|---|---|
| Overview | Job name, description, job tasks, category, icon, and color. The worker that runs the job is display-only (cannot be changed) |
| Workflow | List of steps and runtime behavior |
| Input Form | Definition of the input form shown when the job is invoked from chat |
| Visibility | Activation and sharing with other users |
| Environment Variables | For developers. Job-specific environment variables (usually not needed) |
| History | Timeline of changes |
Configuring Steps (Workflow)
Steps run from top to bottom and can be reordered by drag and drop (add steps with "Add step"). Each step has the following options.
| Option | Meaning |
|---|---|
| Enabled | Run this step when the job executes. When off, the step is skipped |
| Required | A step that always runs. It cannot be disabled by unchecking "Enabled" |
| Allow API execution | Also run this step when the job is invoked via the external posting API |
Under "Advanced Settings" you can configure the following.
- Stop on error: when a step fails partway through, stop without executing the remaining steps
- Auto retry: the number of automatic retries on failure (0–3)
Input Form
Turn on "Enable form" to show a questionnaire-style input form when the job is invoked from chat. You can add questions, define a "Prompt Template" that incorporates the answers, and preview with sample input.
Deleting a Job
You can delete jobs you created from "Delete Job" at the bottom of the "Overview" section.
Visibility (Sharing)
In the "Visibility" section, configure who can use the job.
- "Active": when off, no one can run the job
- "Public": when on, users other than yourself can also use the job (only the creator can change this)
- "Allowed Groups": only members of the checked groups can use the job. If none are selected, everyone has access (can only be set while sharing is on)
Job Categories (for Administrators)
Manage the categories assigned to jobs on the "Job Categories" tab. Each category has a Japanese name, an English name, and a description, and can be reordered by dragging. Selecting a category is required when creating or editing a job.
Job Schedules
On the "Schedules" tab, you can run jobs periodically (cron).
Creating a Schedule
- Click "+ New schedule"
- Select a name, a Worker, and a job
- Set the "Trigger timing":
- "Easy": just pick a frequency (Every minute / Every hour / Every day / Every week / Every month) and the time, day of week, or day
- "Custom (cron)": specify a POSIX cron 5-field expression (e.g.
0 9 * * 1-5= weekdays at 09:00). Presets are also available
- Set the timezone, prompt, max concurrent runs, and max credits per fire as needed, then save
Operating Schedules
- The list shows the cron expression, next fire, last fire, and status (Enabled / Disabled)
- Use "Run now" to trigger manually, and the toggle to switch between enabled / disabled
- Use "Execution history" to check the status of each fire (Pending / Running / Success / Error / Skipped) and the spawned run
Using Jobs in Chat
Invoke the jobs you created from the job (agent) selector in chat. See Chat for details.