AgentPulse Docs

Quick Start

Register an agent, send your first run, and set an alert in under ten minutes.

1. Create your organisation

Sign up at agentpulse.sentinelflux.in. Your account starts a new organisation automatically; everything you create — products, agents, alerts — is scoped to it.

2. Add a product

A product is the thing your agents serve — an app, a feature, a customer-facing workflow. From the dashboard, create one. Cost and metrics roll up per product.

3. Register an agent

Create an agent under the product. On creation you receive a Bearer secret — copy it now, it is shown only once. Store it like any other secret (an environment variable is fine).

The agent secret is displayed only at creation time. If you lose it, rotate the secret from the agent settings.

4. Send your first run

After an agent run completes, report it with a single request:

curl -X POST https://agentpulse.sentinelflux.in/v1/runs \
  -H "Authorization: Bearer $AGENTPULSE_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "success",
    "duration_ms": 4210,
    "tokens": 18450,
    "cost_usd": 0.072,
    "steps": [
      { "type": "llm",  "name": "plan",       "duration_ms": 1200, "tokens": 5200 },
      { "type": "tool", "name": "search_db",  "duration_ms": 2300 }
    ]
  }'

See the Ingestion API for the full field list.

5. Watch the dashboard

The run appears immediately. Run volume, success rate, average latency, and active-agent count update in real time; switch the period selector between 24h, 7d, and 30d.

6. Add an alert rule

Create a rule — for example error_rate gt 5 over a 15-minute window — and attach a Slack, webhook, or email channel. The next time the threshold is breached, you will hear about it. See Alert Rules.

Tip: report runs on failure too — a run that errored is exactly the one your alerts and traces exist to catch.