TLDR;
Do you already know what you are doing and only want to look over a Jupyter Notebook example? We provide one here.
Tasks in the Agent stage are processed in the order of their task priority.

Adding Task Agents to your Workflow
To add Task Agents to your Workflow you must add an Agent stage component to your Workflow.- Connect the Agent stage in the required place in your Workflow.
- Click + next to Add pathway and give the pathway a meaningful name. Repeat this step for each additional pathway you want to add. Pathways allow you to connect the Agent stage to other workflow components.
Coming Soon! We’re currently evaluating webhooks for the Agent stage.
Please let us know if this would help your use-case by reaching out to support@encord.com.
Configuring Task Agents
Use the Encord SDK to configure your Task Agent. The Task Agent executes the configured SDK script for all tasks that are routed through the Task Agent stage in your Workflow.General Example
General Example
The General Example script shows how to configure a Task Agent with the name Ensure that you:
Agent 1
and with a pathway called continue to Review
.Agent nodes can be used in conjunction with bundles to efficiently handle bulk actions
- Replace
<private_key_path>
with the path to your private key. - Replace
<project_hash>
with the hash of your Project. - Insert your custom logic where the comment instructs you to do so.
General Example
Pre-Classification of Images Using GPT 4o
Pre-Classification of Images Using GPT 4o
See our end-to-end guide for Pre-Classification using GPT 4o for more detailed information.

Agent nodes can be used in conjunction with bundles to efficiently handle bulk actions
- Replace
<private_key_path>
with the hash of your private key. - Replace
<project_hash>
with the hash of your Project. - Replace
Agent 1
with the name of your Agent stage.
Pre-Labeling Videos Using a Mock Model
Pre-Labeling Videos Using a Mock Model
This guide makes the following assumptions:
- You have a model that takes video frames as an input and provides bounding box coordinates and confidence scores as an output.
- You have installed the
encord-agents
library using the following command:
Annotate 1
). Below is an example of a Workflow where the Pre-Labeling agent can be effectively utilized.
To authenticate, you must set either of following environment variables in the environment that you plan to run your agents.
- ENCORD_SSH_KEY: Containing the raw private key file content
- ENCORD_SSH_KEY_FILE: Containing the absolute path to the private key file
- Replace
<project_hash>
with the hash of your Project. - Replace the mock model with your own model, and adapt the rest of the script according to your needs.
- If you choose to give your python file a different name, ensure you replace all references to
prelabel_video.py
with your new file name.
prelabel_video.py
Triggering the Task Agent
Webhooks are coming soon, allowing you to trigger Task Agents manually.