AeontelAeontel Docs

Quickstart

Create and run your first AI agent in 5 minutes.

Create an agent, call it from TypeScript, and watch the run land in the event log.

1. Install the SDK

Shell
pnpm add @aeontel/sdk

2. Get an API key

Sign in at platform.aeontel.com, open Settings → API keys, and mint a secret key (sec_...). Keep it out of frontend bundles.

Make note of your workspace ID — it appears as wsp_... in the URL.

3. Create an agent

TypeScript
import Aeontel from "@aeontel/sdk";

const client = new Aeontel(process.env.AEONTEL_API_KEY!);
const WORKSPACE_ID = "wsp_..."; // your workspace

const agent = await client.agents.create({
  workspaceId: WORKSPACE_ID,
  name: "Support triage",
  model: "anthropic/claude-sonnet-4-5",
  instructions: "You route incoming emails to the right queue.",
});

console.log("Created agent:", agent.id);

4. Run it

TypeScript
const run = await client.runs.create({
  workspaceId: WORKSPACE_ID,
  subjectType: "agent",
  subjectId: agent.id,
  input: {
    messages: [{ role: "user", content: "Refund request from VIP customer" }],
  },
});

// Poll until complete
let current = run;
while (current.status === "running" || current.status === "queued") {
  await new Promise((r) => setTimeout(r, 500));
  current = await client.runs.retrieve({ id: run.id });
}
console.log("Run finished:", current.status, current.output);

5. Watch the event log

Every step emitted an event — agent.created, run.created, run.completed. Tail them live:

TypeScript
const stream = client.events.stream({ workspaceId: WORKSPACE_ID });
stream.on("run.*", (event) => console.log(event.type, event.subjectId));

What's next?