Department Management

Departments in Horizon are logical groupings that mirror your organization’s structure. They help organize agents, apps, and workflows by business function, making it easier to manage permissions, track performance, and maintain clear operational boundaries.

Why Use Departments

Organization

Group agents by function — sales, finance, support, marketing — so team members can quickly find the agents relevant to their work.

Access Control

Restrict who can view and manage agents within a department. Only users with the appropriate role can modify department resources.

Performance Tracking

View metrics and KPIs scoped to a department. Understand how each business unit’s agents are performing independently.

Budget Management

Track token consumption and costs per department. Allocate budgets and set spending limits at the department level.

Viewing Departments

Navigate to Workspace > Departments to see all departments in your organization. Each department card shows:

• Department name and description.
• Agent count — the number of agents assigned to the department.
• App count — deployed apps scoped to this department.
• Active tasks — the number of currently running tasks within the department.
• Token usage — tokens consumed in the current billing period.

Creating a Department

1. Click the + New Department button on the Departments page.
2. Enter a name for the department (e.g., “Finance,” “Customer Success,” “Engineering”).
3. Add an optional description to clarify the department’s purpose.
4. Select a department lead — the user who will have primary management responsibility.
5. Optionally set a token budget — a monthly limit on token consumption for the department.
6. Click Create Department.

Note

Department names must be unique within your organization. You can rename a department at any time without affecting agent assignments.

Assigning Agents to Departments

Agents can be assigned to a department during agent creation or reassigned afterward:

• During creation — select the department in the agent creation wizard.
• After creation — open the agent’s detail page, go to Configuration, and change the Department field.
• Bulk reassignment — from the Departments page, click a department, then use the Manage Agents button to add or remove agents in bulk.

Each agent belongs to exactly one department at a time. Reassigning an agent to a new department moves all of its associated data (conversations, metrics) to the new department’s scope.

Department Settings

Click on a department to open its detail page, then select the Settings tab:

• Name and description — update the department’s display name and purpose.
• Department lead — change the primary responsible user.
• Token budget — set or adjust the monthly token spending limit. When the budget is reached, agents in the department are paused until the next billing cycle or the budget is increased.
• Notification preferences — configure which department events trigger alerts (budget thresholds, agent errors, task completions).
• Default connections — specify which integrations agents in this department can use by default.

Department Analytics

The Analytics tab on a department’s detail page provides:

• Task completion rates and volume over time.
• Token usage trends and budget burn rate.
• Agent utilization — the percentage of time each agent is actively processing tasks.
• Error rates and common failure types.
• Top-performing agents and most-used skills.

Tip

Use department analytics alongside the dashboard’s altitude views to get both broad and focused operational insights.

Deleting a Department

To delete a department, you must first reassign or remove all agents and apps within it. Then, open the department settings and click Delete Department. This action cannot be undone — historical data associated with the department will be archived but no longer accessible from the department view.