SDK guides

Monitor employees

Once employees are live, a dashboard helps your team understand what they are doing and where attention is needed. The information used in this guide is read-only, so the dashboard can report health, activity, available actions, usage, and pending reviews without changing an employee or acting on its behalf.

Step 1

Start with organization health

Check the overall employee health for the organization, then list the live employees to see each one's current state.

List deployments (TypeScript)

import {
  serenAgentHealth,
  serenAgentListDeployments,
} from "@serendb/sdk";

await serenAgentHealth();
const { data, error } = await serenAgentListDeployments();
if (error) throw error;

console.log(data.data);

Step 2

Look into one employee

For a given employee, read its recent activity, health, and available actions. Together these show what the employee has been doing, what it can do next, and whether someone needs to step in.

Per-deployment reads (TypeScript)

import {
  serenAgentGetDeploymentActivity,
  serenAgentGetDeploymentHealth,
  serenAgentListDeploymentTools,
} from "@serendb/sdk";

const path = { path: { id } };
await serenAgentGetDeploymentHealth(path);
await serenAgentGetDeploymentActivity(path);
await serenAgentListDeploymentTools(path);

Step 3

Review spend and audit

The Seren CLI summarizes employee usage and recent account activity, which is the fastest way to check cost and history from a terminal or automated job. Use JSON output to feed it into your own reporting.

Spend and audit from the CLI

seren -o json agent cloud overview

Turn it into a dashboard

The Employees page shows how these read-only requests combine into a single dashboard. The exact operations are searchable in the API reference when you are ready to build it.

Build a dashboard Open the API reference