Jobs
After uploading file to Istari Digital, you can use Jobs to extract, manipulate, and transform those files.
Overview
A job represents an execution of a function on a model.
Inputs
A job has one or more inputs. Inputs can be models (files in the Istari Digital Platform) or parameters (bare values). The number and types of inputs depends on the function.
Outputs
A job can produce any number of outputs. Outputs can be artifacts or models. The number and types of outputs depends on the function.
Artifact outputs are uploaded under the model they are extracted from. See the How To guide for step-by-step instructions for viewing the artifacts extracted from a model.
Model outputs will appear in the list of models available to you under the Files option in the left-hand sidebar.
Job execution
Jobs are executed by agents. The Istari Digital Agent is a component of the Istari Digital Platform that interfaces with DE Tools to manipulate model files. The Istari Digital Platform assigns jobs to Agents and manages the lifecycle of each job. See below for details on the job lifecycle.
Your Istari Digital Platform installation may include any number of Istari Digital Agents, each of which may be configured to support a particular set of functions. Ask your administrators for details.
The Istari Digital Agent runs entirely in your company's infrastructure. All job input and output data stays entirely within your company's infrastructure during the job execution process.
Creating jobs
You can create jobs on any model you have access to. Job creation is managed via the the Artifacts tab of a model file.
See the How To guide for step-by-step instructions for creating a job.
Agent assignment
As noted in the How To guide, you may optionally assign a job to an agent during the job creation process.
If you choose Select Agent for Me the Istari Digital Platform will dynamically assign the job to the next available agent that is able to execute it. It is recommended that you pick this option unless you have a specific reason to assign a job to an agent.
If you assign a job to an agent the Istari Digital Platform will ensure that no other agent executes the job.
The job will not be executed and will stay in Pending status if the agent you assigned is not able to execute the job.
Job lifecycle
Each job moves through a sequence of statuses after it has been created.
-
Pending
The job has been created but has not yet been claimed by an agent for execution. -
Claimed
The assigned agent is ready to work on the job and has marked it to executed next. -
Validating
The assigned agent is downloading and verifying the job's inputs. -
Running
The assigned agent is executing the job's function on the inputs. -
Uploading
The assigned agent is uploading the outputs from the job produced by the function. -
Completed
The job has completed successfully.
Alternative statuses
A job's lifecycle may end in one of these statuses instead of Completed in certain circumstances.
-
Failed
An error occurred during execution of the job and it could not be completed. Check the job's inputs and try again. -
Canceled
A user canceled the job before it was Claimed by an agent. The job will not be executed.