Service

A Service is a long-running backend capability that Agents can call. Unlike tools (which run inside the Agent process), Services run as independent backends and are accessed via the City network.

Examples

• Knowledge base (semantic search over documents)
• Search engine (web search, internal search)
• Database (structured data storage and query)
• File store (document upload and retrieval)

Registration

Services register with City by:

1. Declaring their API schema
2. Exposing health and capability endpoints
3. Receiving a service ID

Discovery

Agents discover Services through City. When an Agent needs a capability, it asks City for available Services, then routes requests to the appropriate one.

Continue with:

• Model Provider
• Action