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
2 changes: 2 additions & 0 deletions build/agents/give-your-agent-tasks/task-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,10 +39,10 @@

The Task list has a filter builder for narrowing down to exactly the Tasks you need. You can filter by:

- **Status** — Task state like Running, Completed, Paused, or Timed out

Check warning on line 42 in build/agents/give-your-agent-tasks/task-overview.mdx

View workflow job for this annotation

GitHub Actions / Documentation Lint Checks

5 settings listed as bullet points — consider using a table instead so they're easier to scan. [technical: 5 consecutive bullet items matching **Key**: value or **Key** — value pattern]
- **Agent** — Tasks from a specific Agent
- **Tool usage** — which Tools the Task used
- **Errors** — failure type: **Agent has errored** (the Agent itself stopped on an error) or **Has active tool failures** (a Tool failed mid-run, even if the Agent kept going)

Check warning on line 45 in build/agents/give-your-agent-tasks/task-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (relevanceai) - vale-spellcheck

build/agents/give-your-agent-tasks/task-overview.mdx#L45

Did you really mean 'errored'?
- **Metadata, date, and more** — custom fields, time range, who triggered the Task, and other conditions

Combine the two error filters to catch every kind of failure, including Tool failures that never surfaced as an obvious error.
Expand All @@ -50,3 +50,5 @@
## Viewing Tasks across all your Agents

The views above each focus on a single Agent or Workforce. To monitor and troubleshoot every Task across all your Agents and Workforces from one place, head to the [Tasks page](/build/agents/give-your-agent-tasks/tasks-page). It's where you triage escalations, errors, and approvals, and act in bulk when a whole group needs the same fix. Selecting any Task there opens the same conversation (its messages and Tool runs) in a side panel.

The Tasks page includes three grouping modes — **All** (flat list), **By agent**, and **By workforce** — so you can organize the cross-workspace view by the structure that makes most sense for what you're looking for.
18 changes: 16 additions & 2 deletions build/agents/give-your-agent-tasks/tasks-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,29 @@
Each Task is a single run of work (a conversation or workflow) carried out by an Agent or Workforce. For what a Task is and how to read one, see [Tasks](/build/agents/give-your-agent-tasks/task-overview).
</Note>

## Tabs
## Status tabs

The page is split into tabs:
The page is split into status tabs:

- **Approvals** — Tasks waiting on your approval before they can continue.
- **Escalated** — Tasks the Agent paused on to ask you a question.
- **Errors** — Tasks that hit a Tool failure or runtime error.
- **All tasks** — every conversation across your Agents and Workforces.

## Grouping views

Within any status tab, you can switch how Tasks are grouped using the grouping tabs above the Task list:

- **All** — a flat list of every Task across all Agents and Workforces, ordered by recency.
- **By agent** — Tasks grouped by the Agent that ran them, so you can compare load and status per Agent at a glance.
- **By workforce** — Tasks grouped by Workforce. Each Workforce row is expandable to show its member Agents as sub-rows, giving you a hierarchical view from Workforce down to individual Agent.

The **By workforce** grouping complements the per-Workforce Task view available inside each Workforce builder — use it when you want a single cross-workspace view organized by team structure rather than per-Agent.

<Note>
The **By workforce** grouping is currently available to early-access users. If you don't see it, it hasn't been enabled for your account yet.
</Note>

## Bulk actions

When you open a Task, the page checks for other Tasks from the same Agent in the same state and surfaces a bottom sheet so you can act on the whole group at once.
Expand All @@ -30,7 +44,7 @@
Available bulk actions:

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

Check warning on line 47 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#L47

Did you really mean 'errored'?

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

Expand Down
3 changes: 3 additions & 0 deletions build/workforces/workforce-features/workforce-task-view.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,8 @@ The Task View allows you to monitor multiple concurrent tasks across your workfo
3. Expand individual tasks to see detailed information
4. Toggle between different workforces if you have multiple configured

To monitor tasks across all your Workforces in one place, use the global [Tasks page](/build/agents/give-your-agent-tasks/tasks-page). Its **By workforce** grouping view organizes tasks by Workforce, with expandable rows showing each member Agent — useful for getting a workspace-wide picture without switching between individual Workforce Task views.

### Handling Escalations

When agents escalate issues requiring human attention:
Expand Down Expand Up @@ -131,3 +133,4 @@ If you encounter issues with tasks in the Task View:
- [Approvals and Escalations](https://relevanceai.com/docs/build/agents/customise-agent/escalate): Set up detailed approval workflows and escalation paths for your agents
- [Workforce Builder](https://relevanceai.com/docs/build/agents/customise-agent/subagents): Design and configure your multi-agent workforce with visual tools
- [Visual Data Masking](/build/agents/build-your-agent/agent-settings/visual-data-masking): Protect sensitive information in conversation histories
- [Tasks page](/build/agents/give-your-agent-tasks/tasks-page): Monitor and act on tasks across all Agents and Workforces from a single view, including the **By workforce** grouping tab
Loading