CloudOverview

Agorio Cloud

Agorio Cloud (cloud.agorio.dev) is the hosted observability and control plane for your agents. It’s the paid product surface in Agorio’s open-core model — the SDK and plugins are MIT, while Cloud is the managed offering.

The agorioCloud helper

Ship traces from any agent with one helper. agorioCloud({ apiKey }) returns an object you spread into AgentOptions:

import { ShoppingAgent } from '@agorio/sdk';
import { agorioCloud } from '@agorio/sdk/cloud';
 
const agent = new ShoppingAgent({
  llm,
  ...agorioCloud({ apiKey: process.env.AGORIO_CLOUD_KEY }),
});

The helper wires up tracer, onLog, onStep, onComplete, beginRun, and shutdown. It batches events, ships them to cloud.agorio.dev/api/ingest, and swallows network errors with a warning so observability never breaks your agent.

The trace explorer

In the Cloud app you get:

  • Traces (/traces) — a list of recent runs for your account.
  • Trace drilldown (/traces/[runId]) — a usage grid, the span table, and the log table for a single run, auto-refreshing while the run is in progress.
  • Sub-agent trees — runs that use sub-agents or AgentChain render as a tree, because child spans carry parent_span_id and sub_agent_name.

Cloud also hosts API-key management (/api-keys), an audit-log viewer (/audit-log), an EU AI Act compliance export (/compliance), and a team admin UI (/team).

In this section

  • Self-Hosting — run Cloud on your own infrastructure.
  • RBAC — roles and permissions.
  • SSO — enterprise single sign-on.
  • Billing — the Pro tier and usage.
ProcurementSelf-Hosting