Skip to main content
An agent is a connected piece of software, never a person. What an agent is depends on the workspace you’re in.

​
Agents in a buyer organization

In a buyer workspace, Agents sits next to Advertisers. A buyer agent is software your organization connects to Semicola: your own planning agent, an agency tool, a reporting job. Keep these ideas separate:
  • The agent is the named software and its purpose.
  • Its principal is the durable identity Semicola uses for routing and audit.
  • A credential (an API key or an M2M client) lets the software prove that identity without a person’s login.
  • A grant is explicit permission on one advertiser, READ or READ_WRITE. Credentials and principals never imply a grant: a new agent has no advertiser access until an admin grants it.
Spend, payment and Terms authority are never inferred from a grant. Buyer agents call the v3 MCP endpoint only. See Buyer-agent credentials for the console, credentials and grants.

​
Agents that power a storefront

In a seller workspace, Agents (in the left navigation) lists the agents behind your storefront. GET /api/v2/storefront/agents returns the same list. Ad servers and modular feeds aren’t agents; they stay under the hosted agent’s inventory sources.

​
The hosted sales agent

Selecting it opens its sections: Its status reads Configuring until setup is done, then Live. Health follows the storefront’s liveness: healthy, degraded (needs attention), unhealthy (critical) or unknown.

​
Connected sales agents

A connected agent shows its protocol, endpoint and a status of Connected, Pending or Disabled. Its role and sections aren’t known to Semicola, so it shows Overview only, which opens the source’s diagnostics. Credentials, connection tests and failures belong to the inventory source, not the agent; see Inventory sources. API calls, under Agents, opens the activity log’s recorded API and MCP calls to your storefront (list_storefront_activity with view calls; see Audit logs).

​
Not available yet

  • Create Agent, operators, and registering an observed implementation as a production revision.
  • Sales-agent certification and a Partner listing.
  • Signal, creative and outcome-measurement agents, and agents from a wider marketplace.
  • Agent-level and per-account OAuth flows for connected agents.
  • Semicola-hosted buyer agents: buyer agents are always your own software.