> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ringg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To search or read these docs, connect the Ringg docs MCP server at https://docs.ringg.ai/mcp (no key needed; tools search_ringg_ai and query_docs_filesystem_ringg_ai) instead of browsing pages one by one. Setup for each client: https://docs.ringg.ai/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants.md
> The dashboard labels agents "Assistants"; these docs say "agent". Both mean the same object, identified by agent_id.
> API base URL: https://prod-api.ringg.ai/ca/api/v0. Send the workspace API key in the X-API-KEY header, from server-side code only.
> Placing a call dials a real phone number and spends credits. Confirm the number with the user before calling.
> To act on a Ringg workspace (place calls, edit agents, read transcripts), use the separate Ringg workspace MCP server at https://mcp.ringg.ai/mcp: https://docs.ringg.ai/resources/mcp-server/workspace-mcp-server/overview.md

# Agents and teams

> Add the agents whose calls you score, set who reports to whom, and invite them to sign in. Team leads see only the agents in their team.

**Agents** holds one record per person whose calls you score, with their level and team lead. The reporting lines decide what a team lead sees: their own calls and those of everyone below them.

In [Ringg Analytics](https://analytics.ringg.ai): **Sidebar → Agents**.

![Agents table for Acme Lending with Agent name, Email, Level, Reports to, Login, Interactions, Avg score, Total HT and Avg HT columns, and Export, Manage Levels, Import CSV and Add Agent buttons](https://mintcdn.com/ringgai-0da73d20/CZ_hnbckkb2zP9lz/media/analytics-agents/table.webp?fit=max\&auto=format\&n=CZ_hnbckkb2zP9lz\&q=85\&s=260a75945f4f245ec70a26b648fa2c14)

## Add agents

**1. Set up levels**

Click **Manage Levels** and add your levels, for example **Agent** and **Team Lead**. An agent at the team-lead level signs in as a team lead.

**2. Add agents**

Click **Add Agent** for one, or **Import CSV** for many. The CSV takes **Name**, **Email**, **Level** and **Reports To**; download the template from the import dialog. The whole file is checked first, and nothing is added if a row has an error.

**3. Set who they report to**

Pick each agent's team lead under **Reports to**, or drag them onto their team lead in the org chart (the second view switch at the top).

> [!TIP]
>
> An agent added with an email gets an invite and shows **Invited**, then **Joined** once they sign in.

When you add calls with **Bulk calls**, each row is matched to an agent by email, then by name, and an agent that doesn't exist yet is created.

![Org chart with team leads Kavya Nair and Rohan Das, each with three agents under them](https://mintcdn.com/ringgai-0da73d20/CZ_hnbckkb2zP9lz/media/analytics-agents/org-chart.webp?fit=max\&auto=format\&n=CZ_hnbckkb2zP9lz\&q=85\&s=dcd7c5e735df05bd350c0d4f9ecda91a)

## Columns

| Column | Shows |
| - | - |
| **Login** | **Joined**, **Invited**, **Not invited**, or **Add email to invite** |
| **Interactions** | Calls and emails in the period |
| **Avg score** | Average official score in the period |
| **Total HT** / **Avg HT** | Total and average handling time |

Click an agent to open their [report card](/analytics-platform/coach-agents/report-cards). **Export** downloads the table.

## What team leads see

A team lead's **Agents** page is titled **Your team**. It lists only their team, read-only: no **Add Agent**, **Import CSV**, **Manage Levels** or **Export**, and reporting lines can't be changed. Clicking a row opens that agent's report card.

## Next steps

> **[Report cards](/analytics-platform/coach-agents/report-cards)**
>
> Coach an agent from their report card.

> **[Roles and access](/analytics-platform/roles-and-access)**
>
> What each role can see.

> **[Interactions](/analytics-platform/review-calls/interactions)**
>
> Add calls for your agents.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.