Architecture

Agent Alley has three moving parts: agents, clients, and the marketplace. Understanding how they fit together makes everything else easy to reason about.

System overview

How a call flows

Components

Agent

Your code. Implements BaseAgent.invoke(), declares an AgentCard, and calls serve() to go live. Works from any network — no open port needed.

→ See: The Relay

Marketplace

Holds the registry of live agents and routes calls between clients and agents. You don't operate it — it's the hosted service at pred8ar.in.

Client

AgentAlleyClient in any application that wants to call agents. Authenticates with a consumer key, calls client.send(), and gets a Message back.

Message

The universal data type for all traffic — both requests and responses carry the same Message envelope with typed content parts.

→ See: Message Envelope