Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions build/agents/give-your-agent-tasks/tasks-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,10 +30,25 @@
Available bulk actions:

- **Approve** or **Reject** pending approvals.
- **Rerun** errored Tasks from the failing step.

Check warning on line 33 in build/agents/give-your-agent-tasks/tasks-page.mdx

View check run for this annotation

Mintlify / Mintlify Validation (relevanceai) - vale-spellcheck

build/agents/give-your-agent-tasks/tasks-page.mdx#L33

Did you really mean 'errored'?

A confirmation modal shows how many Tasks will be affected before anything is sent.

<Note>
A Task with more than one pending approval isn't bulk-actionable and stays one-at-a-time.
</Note>

## By agent view

The Tasks page lets you switch to a "By Agent" grouped view, which organizes the task list by agent instead of chronologically. Use this view when you want to see which agents are handling the most work or to drill into a specific agent's task history.

Each row in this view represents one agent. Click the expand chevron on an agent row to open a nested task sub-table showing that agent's individual tasks. The sub-table displays up to 25 tasks at a time. If there are more tasks matching the current filters or search, a **Show more** button appears at the bottom of the sub-table to load additional tasks.

Click any task row in the sub-table to open the full task detail drawer, where you can review conversation history, tool usage, outputs, and errors.

The sub-table automatically reflects any filters and search terms applied to the parent view — only tasks matching those criteria appear.

**Sub-table states:**
- **Loading** — A loading indicator appears while the sub-table fetches tasks.
- **Error** — If the fetch fails, an error message is shown in place of the task list.
- **Empty** — If the agent has no tasks matching the current filters, the sub-table shows "No tasks to show".
19 changes: 17 additions & 2 deletions build/workforces/workforce-features/workforce-task-view.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,15 +69,30 @@ The Task View provides a chronological timeline of all activities, giving you vi

## Working with the Task View

### Monitoring Multiple Tasks
### Monitoring multiple tasks

The Task View allows you to monitor multiple concurrent tasks across your workforce:

1. Tasks are organized chronologically with the most recent at the top
2. Use filters to focus on specific task types, agents, or statuses
3. Expand individual tasks to see detailed information
3. Switch to "By Agent" view to group tasks by the agent that ran them and expand each agent row for details
4. Toggle between different workforces if you have multiple configured

#### By agent grouped view

The "By Agent" grouped view organizes the task list by agent rather than chronologically. Each row represents one agent and shows a summary of that agent's task activity.

Click the expand chevron on any agent row to open a nested task sub-table showing that agent's individual tasks. The sub-table displays up to 25 tasks at a time. If there are more tasks matching the current filters, a **Show more** button appears at the bottom of the sub-table to load the next page.

Click any task row in the sub-table to open the full task detail drawer, where you can review conversation history, tool usage, outputs, and errors.

The sub-table automatically reflects any filters and search terms active in the parent view — only tasks matching those criteria appear.

**Sub-table states:**
- **Loading** — A loading indicator appears while tasks are being fetched.
- **Error** — If the fetch fails, an error message is shown in place of the task list.
- **Empty** — If the agent has no tasks matching the current filters, the sub-table shows "No tasks to show".

### Handling Escalations

When agents escalate issues requiring human attention:
Expand Down
Loading