diff --git a/build/agents/give-your-agent-tasks/task-overview.mdx b/build/agents/give-your-agent-tasks/task-overview.mdx index 807de614..51aad10a 100644 --- a/build/agents/give-your-agent-tasks/task-overview.mdx +++ b/build/agents/give-your-agent-tasks/task-overview.mdx @@ -50,3 +50,5 @@ Combine the two error filters to catch every kind of failure, including Tool fai ## 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. diff --git a/build/agents/give-your-agent-tasks/tasks-page.mdx b/build/agents/give-your-agent-tasks/tasks-page.mdx index 00ba2822..ce998130 100644 --- a/build/agents/give-your-agent-tasks/tasks-page.mdx +++ b/build/agents/give-your-agent-tasks/tasks-page.mdx @@ -14,15 +14,29 @@ Tasks from both Agents and Workforces appear here, and the same triage and bulk 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). -## 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. + + +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. + + ## 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. diff --git a/build/workforces/workforce-features/workforce-task-view.mdx b/build/workforces/workforce-features/workforce-task-view.mdx index 94550726..edb77d47 100644 --- a/build/workforces/workforce-features/workforce-task-view.mdx +++ b/build/workforces/workforce-features/workforce-task-view.mdx @@ -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: @@ -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