# How to Run Your Assignment ### Introduction Once you've built your assignment, it's time to see it in action. Running an assignment in Duvo is designed to be fully transparent—you can observe exactly what the assignment is doing at every step, understand its reasoning, and interact with it in real-time if needed. ### Tracking Active Jobs in the Sidebar When one or more Jobs are running, the sidebar shows a **Running** indicator listing each assignment that has active Jobs, along with a count of how many are in progress. Clicking an assignment name in this list takes you directly to its Jobs tab so you can monitor progress. Each assignment card in the main view also shows a badge with its active Job count, so you can see at a glance which assignments are currently working without navigating away. *** ### Starting a Job When you're ready to run your assignment, click the **"Run Assignment"** button. Your assignment will immediately begin working through its SOP. ![Run Assignment](https://2799416172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV0i3nXTFWDeWtbyZ9xMo%2Fuploads%2Fgit-blob-38d5f9f8a98c64abc4a296673c3664470a9d9e53%2Fhow-to-run-agent-1.png?alt=media) ### Understanding the Session Log The session log appears on the right side of your screen and provides complete visibility into your assignment's activities. This is where you'll monitor progress, see detailed steps, and interact with your assignment during the job. #### The To-Do List The first thing your assignment does is review its SOP and generate a to-do list. This list breaks down the entire workflow into discrete steps, giving you a clear overview of what the assignment plans to accomplish. You can use the to-do list to track how far along the assignment is in the process and what tasks remain. ![To-Do List](https://2799416172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV0i3nXTFWDeWtbyZ9xMo%2Fuploads%2Fgit-blob-3d1a7c35217473ff9062e5c64a32c6aa5248185c%2Fhow-to-run-agent-2.png?alt=media) #### Real-Time Activity Log Every step of the process is captured in the session log, providing complete transparency into what your assignment is doing: **Assignment reasoning**: See the assignment's thought process and decision-making as it works through each step **Tool calls**: Monitor which tools and systems the assignment is accessing, such as reading from your CRM, sending emails, or navigating browser-based systems **Human-in-the-loop (HITL) requests**: When the assignment reaches an approval point, it will pause and request your review. You'll see exactly what action it wants to take and can approve, modify, or reject before it proceeds This detailed logging ensures you always understand what's happening and can identify exactly where adjustments might be needed. ![Activity Log](https://2799416172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV0i3nXTFWDeWtbyZ9xMo%2Fuploads%2Fgit-blob-4c3777b8b015439aa5564296568ebc83684bef1a%2Fhow-to-run-agent-3.png?alt=media) ### Interacting During a Job At the bottom of the session log, you'll find the **job-time prompt**. This is your direct line of communication with the assignment during the current job. ![Job-Time Prompt](https://2799416172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV0i3nXTFWDeWtbyZ9xMo%2Fuploads%2Fgit-blob-67e52fd0b5d5b4d2e07807a9d903329f2d9bfebf%2Fhow-to-run-agent-4.png?alt=media) #### What is the Job-Time Prompt? The job-time prompt allows you to interact with your assignment while it's actively working. You can provide additional context, answer questions, give guidance, or offer corrections without stopping the entire process. > **Important**: Any context you provide through the job-time prompt applies only to this specific job. It doesn't carry over to future jobs or modify the assignment's permanent SOP. Think of it as giving real-time guidance to a team member for a particular task. #### When to Use the Job-Time Prompt Use the job-time prompt when you need to: * Respond to a human-in-the-loop (HITL) request * Provide additional information the assignment needs to continue * Clarify something the assignment is uncertain about * Offer guidance on handling an unexpected situation ### Viewing and Downloading Job Files When an assignment creates or modifies files during a job — such as reports, exports, or processed documents — those files appear in the **Files** panel in the job view. #### What the Files Panel Shows The Files panel lists all files in the assignment's workspace for that job. Each file shows its name, size, and when it was last modified. The list updates automatically while the job is running and refreshes whenever a tool writes to the workspace. #### Downloading Files * **Download a single file**: Click the download icon next to any file to save it directly. * **Download all files**: Use the **Download All** button to get every file in the workspace as a single ZIP archive. The ZIP is named after the assignment and job number for easy identification. #### When Files Appear Files only appear if the assignment has written something to its workspace. If no tools have interacted with the filesystem yet, the panel shows an empty state. *** ### Uploading file to the current job You can upload a file that the assignment takes as input for the job. This is useful in situations where the assignment can process documents as input, extracting the data. [Arcade Demo](https://duvo-workspace.share.arcade.software/share/kPcr9guz34LiwKIxBAqG)