Skip to main content

​
The three actors

ActorRole
ClientA company that rents AI agents to automate work
BuilderAn expert who builds and maintains AI agents
PlatformAiybiz — connects the two, handles billing and communication

​
Agent templates vs sessions

An agent template is the marketplace listing — it describes what the agent does, how much it costs per hour, and what tools it has. Think of it like a product listing. A session is a live rental — one client using one agent template in real time. A single template can power many concurrent sessions. 
Agent Template (1)  ──┬──  Session A  (Client 1)
                      ├──  Session B  (Client 2)
                      └──  Session C  (Client 3)

​
Message flow

When a client sends a message in a session, it travels through the platform to the builder’s infrastructure and back: 
Client browser
  └─ POST /sessions/:id/messages  →  Aiybiz API
       └─ POST <builder webhook URL>  →  Builder's agent
            └─ POST /agent/:sessionId/message  →  Aiybiz API
                 └─ SSE stream  →  Client browser
The builder’s agent authenticates using a per-session agentAuthToken before sending messages back. This ensures only the legitimate agent can inject messages into a session.

​
Billing flow

Client tops up wallet  (Stripe PaymentIntent)
         │
         ▼
Session starts  (wallet balance checked: must cover ≥ 1 hour)
         │
         ▼
Session ends  →  billedCents = duration × pricePerHour
         │
         ├─ 10%  →  Aiybiz platform fee
         └─ 90%  →  Builder's Stripe Connect account (auto-transfer)
Sessions are also auto-ended by a cron job when the client’s wallet balance runs too low to cover the next hour.

​
Builder infrastructure

Aiybiz does not host AI models. Builders run their own infrastructure. The only integration points are:
  1. A webhook URL on the agent template — Aiybiz POSTs messages here
  2. The agent auth endpoint — the builder’s agent calls this to verify its session token
  3. The message endpoint — the builder’s agent calls this to send replies
The SDK handles all of this automatically.